aws-sdk-states 1.49.0 → 1.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d201771bc0e7a23a040c916cd278ac9366af29afebde619c28e32f437c5840a
-  data.tar.gz: d964c23d28490381eb2157fb9ac88a5fad99b74666f4e27a5da6414070df5944
+  metadata.gz: 41a52c7f7ca5d10e0b7d71f42b5b96c8945ba2ed88dcca42807c38ea1d0ac08e
+  data.tar.gz: df6ae396713e880121cf250474c73a0bc81138cd5241ee77662ea0ab10da90b2
 SHA512:
-  metadata.gz: 326d59dfcd58969a8478002ae4cab401cb135af8e7075f11f682eda0ab4de9c9acb7e69d2b7965c183ec36d93e19745a24ee277e4db897e372a177a874ef4416
-  data.tar.gz: 25abca8c2ac2018d50db16c78c2e8d499caaaf8f8d656882e0e17b55d8554995825c125a807734d5868b30efd74d56d1fc34d71582f02dc0b09d85da376459bc
+  metadata.gz: 85b0c6e9bc25c354b1feabdc2f48b9dcc9dcb6a24b1a6402ddb0405b117adcd2b35ecc70492b0397a52f1e03a1c757a8cd05298b72e933e1ae57c3ec350ff707
+  data.tar.gz: 64f5a0472f54313332d6b95cde5a8653a924a46b04815ea58c437e7451f1486b3ce7c89927aff4666a7f8b727b101fe13781f417e0ddd2d955bbd07c7239e970

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.51.0 (2022-12-01)
+------------------
+
+* Feature - This release adds support for the AWS Step Functions Map state in Distributed mode. The changes include a new MapRun resource and several new and modified APIs.
+
+1.50.0 (2022-11-18)
+------------------
+
+* Feature - This release adds support for using Step Functions service integrations to invoke any cross-account AWS resource, even if that service doesn't support resource-based policies or cross-account calls. See https://docs.aws.amazon.com/step-functions/latest/dg/concepts-access-cross-acct-resources.html
+
 1.49.0 (2022-10-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.49.0
+1.51.0

data/lib/aws-sdk-states/client.rb

@@ -379,8 +379,8 @@ module Aws::States
     # @!group API Operations
 
     # Creates an activity. An activity is a task that you write in any
-    # programming language and host on any machine that has access to AWS
-    # Step Functions. Activities must poll Step Functions using the
+    # programming language and host on any machine that has access to Step
+    # Functions. Activities must poll Step Functions using the
     # `GetActivityTask` API action and respond using `SendTask*` API
     # actions. This function lets Step Functions know the existence of your
     # activity and returns an identifier for use in a state machine and when
@@ -403,9 +403,9 @@ module Aws::States
     #
     # @option params [required, String] :name
     #   The name of the activity to create. This name must be unique for your
-    #   AWS account and region for 90 days. For more information, see [ Limits
-    #   Related to State Machine Executions][1] in the *AWS Step Functions
-    #   Developer Guide*.
+    #   Amazon Web Services account and region for 90 days. For more
+    #   information, see [ Limits Related to State Machine Executions][1] in
+    #   the *Step Functions Developer Guide*.
     #
     #   A name must *not* contain:
     #
@@ -430,8 +430,8 @@ module Aws::States
     #   The list of tags to add to a resource.
     #
     #   An array of key-value pairs. For more information, see [Using Cost
-    #   Allocation Tags][1] in the *AWS Billing and Cost Management User
-    #   Guide*, and [Controlling Access Using IAM Tags][2].
+    #   Allocation Tags][1] in the *Amazon Web Services Billing and Cost
+    #   Management User Guide*, and [Controlling Access Using IAM Tags][2].
     #
     #   Tags may only contain Unicode letters, digits, white space, or these
     #   symbols: `_ . : / = + - @`.
@@ -477,7 +477,7 @@ module Aws::States
     # transition next (`Choice` states), stop an execution with an error
     # (`Fail` states), and so on. State machines are specified using a
     # JSON-based, structured language. For more information, see [Amazon
-    # States Language][1] in the AWS Step Functions User Guide.
+    # States Language][1] in the Step Functions User Guide.
     #
     # <note markdown="1"> This operation is eventually consistent. The results are best effort
     # and may not reflect very recent updates and changes.
@@ -539,7 +539,7 @@ module Aws::States
     #   logged.
     #
     #   <note markdown="1"> By default, the `level` is set to `OFF`. For more information see [Log
-    #   Levels][1] in the AWS Step Functions User Guide.
+    #   Levels][1] in the Step Functions User Guide.
     #
     #    </note>
     #
@@ -551,8 +551,8 @@ module Aws::States
     #   Tags to be added when creating a state machine.
     #
     #   An array of key-value pairs. For more information, see [Using Cost
-    #   Allocation Tags][1] in the *AWS Billing and Cost Management User
-    #   Guide*, and [Controlling Access Using IAM Tags][2].
+    #   Allocation Tags][1] in the *Amazon Web Services Billing and Cost
+    #   Management User Guide*, and [Controlling Access Using IAM Tags][2].
     #
     #   Tags may only contain Unicode letters, digits, white space, or these
     #   symbols: `_ . : / = + - @`.
@@ -563,7 +563,7 @@ module Aws::States
     #   [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_iam-tags.html
     #
     # @option params [Types::TracingConfiguration] :tracing_configuration
-    #   Selects whether AWS X-Ray tracing is enabled.
+    #   Selects whether X-Ray tracing is enabled.
     #
     # @return [Types::CreateStateMachineOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -639,7 +639,17 @@ module Aws::States
     # the state machine's status to `DELETING` and begins the deletion
     # process.
     #
-    # <note markdown="1"> For `EXPRESS`state machines, the deletion will happen eventually
+    # If the given state machine Amazon Resource Name (ARN) is a qualified
+    # state machine ARN, it will fail with ValidationException.
+    #
+    # A qualified state machine ARN refers to a *Distributed Map state*
+    # defined within a state machine. For example, the qualified state
+    # machine ARN
+    # `arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel`
+    # refers to a *Distributed Map state* with a label `mapStateLabel` in
+    # the state machine named `stateMachineName`.
+    #
+    # <note markdown="1"> For `EXPRESS` state machines, the deletion will happen eventually
     # (usually less than a minute). Running executions may emit logs after
     # `DeleteStateMachine` API is called.
     #
@@ -702,14 +712,18 @@ module Aws::States
       req.send_request(options)
     end
 
-    # Describes an execution.
+    # Provides all information about a state machine execution, such as the
+    # state machine associated with the execution, the execution input and
+    # output, and relevant execution metadata. Use this API action to return
+    # the Map Run ARN if the execution was dispatched by a Map Run.
     #
     # <note markdown="1"> This operation is eventually consistent. The results are best effort
     # and may not reflect very recent updates and changes.
     #
     #  </note>
     #
-    # This API action is not supported by `EXPRESS` state machines.
+    # This API action is not supported by `EXPRESS` state machine executions
+    # unless they were dispatched by a Map Run.
     #
     # @option params [required, String] :execution_arn
     #   The Amazon Resource Name (ARN) of the execution to describe.
@@ -727,6 +741,9 @@ module Aws::States
     #   * {Types::DescribeExecutionOutput#output #output} => String
     #   * {Types::DescribeExecutionOutput#output_details #output_details} => Types::CloudWatchEventsExecutionDataDetails
     #   * {Types::DescribeExecutionOutput#trace_header #trace_header} => String
+    #   * {Types::DescribeExecutionOutput#map_run_arn #map_run_arn} => String
+    #   * {Types::DescribeExecutionOutput#error #error} => String
+    #   * {Types::DescribeExecutionOutput#cause #cause} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -747,6 +764,9 @@ module Aws::States
     #   resp.output #=> String
     #   resp.output_details.included #=> Boolean
     #   resp.trace_header #=> String
+    #   resp.map_run_arn #=> String
+    #   resp.error #=> String
+    #   resp.cause #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeExecution AWS API Documentation
     #
@@ -757,7 +777,83 @@ module Aws::States
       req.send_request(options)
     end
 
-    # Describes a state machine.
+    # Provides information about a Map Run's configuration, progress, and
+    # results. For more information, see [Examining Map Run][1] in the *Step
+    # Functions Developer Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-examine-map-run.html
+    #
+    # @option params [required, String] :map_run_arn
+    #   The Amazon Resource Name (ARN) that identifies a Map Run.
+    #
+    # @return [Types::DescribeMapRunOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeMapRunOutput#map_run_arn #map_run_arn} => String
+    #   * {Types::DescribeMapRunOutput#execution_arn #execution_arn} => String
+    #   * {Types::DescribeMapRunOutput#status #status} => String
+    #   * {Types::DescribeMapRunOutput#start_date #start_date} => Time
+    #   * {Types::DescribeMapRunOutput#stop_date #stop_date} => Time
+    #   * {Types::DescribeMapRunOutput#max_concurrency #max_concurrency} => Integer
+    #   * {Types::DescribeMapRunOutput#tolerated_failure_percentage #tolerated_failure_percentage} => Float
+    #   * {Types::DescribeMapRunOutput#tolerated_failure_count #tolerated_failure_count} => Integer
+    #   * {Types::DescribeMapRunOutput#item_counts #item_counts} => Types::MapRunItemCounts
+    #   * {Types::DescribeMapRunOutput#execution_counts #execution_counts} => Types::MapRunExecutionCounts
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_map_run({
+    #     map_run_arn: "LongArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.map_run_arn #=> String
+    #   resp.execution_arn #=> String
+    #   resp.status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "ABORTED"
+    #   resp.start_date #=> Time
+    #   resp.stop_date #=> Time
+    #   resp.max_concurrency #=> Integer
+    #   resp.tolerated_failure_percentage #=> Float
+    #   resp.tolerated_failure_count #=> Integer
+    #   resp.item_counts.pending #=> Integer
+    #   resp.item_counts.running #=> Integer
+    #   resp.item_counts.succeeded #=> Integer
+    #   resp.item_counts.failed #=> Integer
+    #   resp.item_counts.timed_out #=> Integer
+    #   resp.item_counts.aborted #=> Integer
+    #   resp.item_counts.total #=> Integer
+    #   resp.item_counts.results_written #=> Integer
+    #   resp.execution_counts.pending #=> Integer
+    #   resp.execution_counts.running #=> Integer
+    #   resp.execution_counts.succeeded #=> Integer
+    #   resp.execution_counts.failed #=> Integer
+    #   resp.execution_counts.timed_out #=> Integer
+    #   resp.execution_counts.aborted #=> Integer
+    #   resp.execution_counts.total #=> Integer
+    #   resp.execution_counts.results_written #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeMapRun AWS API Documentation
+    #
+    # @overload describe_map_run(params = {})
+    # @param [Hash] params ({})
+    def describe_map_run(params = {}, options = {})
+      req = build_request(:describe_map_run, params)
+      req.send_request(options)
+    end
+
+    # Provides information about a state machine's definition, its IAM role
+    # Amazon Resource Name (ARN), and configuration. If the state machine
+    # ARN is a qualified state machine ARN, the response returned includes
+    # the `Map` state's label.
+    #
+    # A qualified state machine ARN refers to a *Distributed Map state*
+    # defined within a state machine. For example, the qualified state
+    # machine ARN
+    # `arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel`
+    # refers to a *Distributed Map state* with a label `mapStateLabel` in
+    # the state machine named `stateMachineName`.
     #
     # <note markdown="1"> This operation is eventually consistent. The results are best effort
     # and may not reflect very recent updates and changes.
@@ -778,6 +874,7 @@ module Aws::States
     #   * {Types::DescribeStateMachineOutput#creation_date #creation_date} => Time
     #   * {Types::DescribeStateMachineOutput#logging_configuration #logging_configuration} => Types::LoggingConfiguration
     #   * {Types::DescribeStateMachineOutput#tracing_configuration #tracing_configuration} => Types::TracingConfiguration
+    #   * {Types::DescribeStateMachineOutput#label #label} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -799,6 +896,7 @@ module Aws::States
     #   resp.logging_configuration.destinations #=> Array
     #   resp.logging_configuration.destinations[0].cloud_watch_logs_log_group.log_group_arn #=> String
     #   resp.tracing_configuration.enabled #=> Boolean
+    #   resp.label #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachine AWS API Documentation
     #
@@ -809,7 +907,11 @@ module Aws::States
       req.send_request(options)
     end
 
-    # Describes the state machine associated with a specific execution.
+    # Provides information about a state machine's definition, its
+    # execution role ARN, and configuration. If an execution was dispatched
+    # by a Map Run, the Map Run is returned in the response. Additionally,
+    # the state machine returned will be the state machine associated with
+    # the Map Run.
     #
     # <note markdown="1"> This operation is eventually consistent. The results are best effort
     # and may not reflect very recent updates and changes.
@@ -831,6 +933,8 @@ module Aws::States
     #   * {Types::DescribeStateMachineForExecutionOutput#update_date #update_date} => Time
     #   * {Types::DescribeStateMachineForExecutionOutput#logging_configuration #logging_configuration} => Types::LoggingConfiguration
     #   * {Types::DescribeStateMachineForExecutionOutput#tracing_configuration #tracing_configuration} => Types::TracingConfiguration
+    #   * {Types::DescribeStateMachineForExecutionOutput#map_run_arn #map_run_arn} => String
+    #   * {Types::DescribeStateMachineForExecutionOutput#label #label} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -850,6 +954,8 @@ module Aws::States
     #   resp.logging_configuration.destinations #=> Array
     #   resp.logging_configuration.destinations[0].cloud_watch_logs_log_group.log_group_arn #=> String
     #   resp.tracing_configuration.enabled #=> Boolean
+    #   resp.map_run_arn #=> String
+    #   resp.label #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineForExecution AWS API Documentation
     #
@@ -869,6 +975,10 @@ module Aws::States
     # task is available within 60 seconds, the poll returns a `taskToken`
     # with a null string.
     #
+    # <note markdown="1"> This API action isn't logged in CloudTrail.
+    #
+    #  </note>
+    #
     # Workers should set their client side socket timeout to at least 65
     # seconds (5 seconds higher than the maximum time the service may hold
     # the poll request).
@@ -977,7 +1087,7 @@ module Aws::States
     #
     #   resp.events #=> Array
     #   resp.events[0].timestamp #=> Time
-    #   resp.events[0].type #=> String, one of "ActivityFailed", "ActivityScheduled", "ActivityScheduleFailed", "ActivityStarted", "ActivitySucceeded", "ActivityTimedOut", "ChoiceStateEntered", "ChoiceStateExited", "ExecutionAborted", "ExecutionFailed", "ExecutionStarted", "ExecutionSucceeded", "ExecutionTimedOut", "FailStateEntered", "LambdaFunctionFailed", "LambdaFunctionScheduled", "LambdaFunctionScheduleFailed", "LambdaFunctionStarted", "LambdaFunctionStartFailed", "LambdaFunctionSucceeded", "LambdaFunctionTimedOut", "MapIterationAborted", "MapIterationFailed", "MapIterationStarted", "MapIterationSucceeded", "MapStateAborted", "MapStateEntered", "MapStateExited", "MapStateFailed", "MapStateStarted", "MapStateSucceeded", "ParallelStateAborted", "ParallelStateEntered", "ParallelStateExited", "ParallelStateFailed", "ParallelStateStarted", "ParallelStateSucceeded", "PassStateEntered", "PassStateExited", "SucceedStateEntered", "SucceedStateExited", "TaskFailed", "TaskScheduled", "TaskStarted", "TaskStartFailed", "TaskStateAborted", "TaskStateEntered", "TaskStateExited", "TaskSubmitFailed", "TaskSubmitted", "TaskSucceeded", "TaskTimedOut", "WaitStateAborted", "WaitStateEntered", "WaitStateExited"
+    #   resp.events[0].type #=> String, one of "ActivityFailed", "ActivityScheduled", "ActivityScheduleFailed", "ActivityStarted", "ActivitySucceeded", "ActivityTimedOut", "ChoiceStateEntered", "ChoiceStateExited", "ExecutionAborted", "ExecutionFailed", "ExecutionStarted", "ExecutionSucceeded", "ExecutionTimedOut", "FailStateEntered", "LambdaFunctionFailed", "LambdaFunctionScheduled", "LambdaFunctionScheduleFailed", "LambdaFunctionStarted", "LambdaFunctionStartFailed", "LambdaFunctionSucceeded", "LambdaFunctionTimedOut", "MapIterationAborted", "MapIterationFailed", "MapIterationStarted", "MapIterationSucceeded", "MapStateAborted", "MapStateEntered", "MapStateExited", "MapStateFailed", "MapStateStarted", "MapStateSucceeded", "ParallelStateAborted", "ParallelStateEntered", "ParallelStateExited", "ParallelStateFailed", "ParallelStateStarted", "ParallelStateSucceeded", "PassStateEntered", "PassStateExited", "SucceedStateEntered", "SucceedStateExited", "TaskFailed", "TaskScheduled", "TaskStarted", "TaskStartFailed", "TaskStateAborted", "TaskStateEntered", "TaskStateExited", "TaskSubmitFailed", "TaskSubmitted", "TaskSucceeded", "TaskTimedOut", "WaitStateAborted", "WaitStateEntered", "WaitStateExited", "MapRunAborted", "MapRunFailed", "MapRunStarted", "MapRunSucceeded"
     #   resp.events[0].id #=> Integer
     #   resp.events[0].previous_event_id #=> Integer
     #   resp.events[0].activity_failed_event_details.error #=> String
@@ -1004,6 +1114,7 @@ module Aws::States
     #   resp.events[0].task_scheduled_event_details.parameters #=> String
     #   resp.events[0].task_scheduled_event_details.timeout_in_seconds #=> Integer
     #   resp.events[0].task_scheduled_event_details.heartbeat_in_seconds #=> Integer
+    #   resp.events[0].task_scheduled_event_details.task_credentials.role_arn #=> String
     #   resp.events[0].task_start_failed_event_details.resource_type #=> String
     #   resp.events[0].task_start_failed_event_details.resource #=> String
     #   resp.events[0].task_start_failed_event_details.error #=> String
@@ -1054,6 +1165,7 @@ module Aws::States
     #   resp.events[0].lambda_function_scheduled_event_details.input #=> String
     #   resp.events[0].lambda_function_scheduled_event_details.input_details.truncated #=> Boolean
     #   resp.events[0].lambda_function_scheduled_event_details.timeout_in_seconds #=> Integer
+    #   resp.events[0].lambda_function_scheduled_event_details.task_credentials.role_arn #=> String
     #   resp.events[0].lambda_function_start_failed_event_details.error #=> String
     #   resp.events[0].lambda_function_start_failed_event_details.cause #=> String
     #   resp.events[0].lambda_function_succeeded_event_details.output #=> String
@@ -1066,6 +1178,9 @@ module Aws::States
     #   resp.events[0].state_exited_event_details.name #=> String
     #   resp.events[0].state_exited_event_details.output #=> String
     #   resp.events[0].state_exited_event_details.output_details.truncated #=> Boolean
+    #   resp.events[0].map_run_started_event_details.map_run_arn #=> String
+    #   resp.events[0].map_run_failed_event_details.error #=> String
+    #   resp.events[0].map_run_failed_event_details.cause #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/GetExecutionHistory AWS API Documentation
@@ -1138,9 +1253,12 @@ module Aws::States
       req.send_request(options)
     end
 
-    # Lists the executions of a state machine that meet the filtering
-    # criteria. Results are sorted by time, with the most recent execution
-    # first.
+    # Lists all executions of a state machine or a Map Run. You can list all
+    # executions related to a state machine by specifying a state machine
+    # Amazon Resource Name (ARN), or those related to a Map Run by
+    # specifying a Map Run ARN.
+    #
+    # Results are sorted by time, with the most recent execution first.
     #
     # If `nextToken` is returned, there are more results available. The
     # value of `nextToken` is a unique pagination token for each page. Make
@@ -1156,10 +1274,13 @@ module Aws::States
     #
     # This API action is not supported by `EXPRESS` state machines.
     #
-    # @option params [required, String] :state_machine_arn
+    # @option params [String] :state_machine_arn
     #   The Amazon Resource Name (ARN) of the state machine whose executions
     #   is listed.
     #
+    #   You can specify either a `mapRunArn` or a `stateMachineArn`, but not
+    #   both.
+    #
     # @option params [String] :status_filter
     #   If specified, only list the executions whose current execution status
     #   matches the given filter.
@@ -1180,6 +1301,20 @@ module Aws::States
     #   after 24 hours. Using an expired pagination token will return an *HTTP
     #   400 InvalidToken* error.
     #
+    # @option params [String] :map_run_arn
+    #   The Amazon Resource Name (ARN) of the Map Run that started the child
+    #   workflow executions. If the `mapRunArn` field is specified, a list of
+    #   all of the child workflow executions started by a Map Run is returned.
+    #   For more information, see [Examining Map Run][1] in the *Step
+    #   Functions Developer Guide*.
+    #
+    #   You can specify either a `mapRunArn` or a `stateMachineArn`, but not
+    #   both.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-examine-map-run.html
+    #
     # @return [Types::ListExecutionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListExecutionsOutput#executions #executions} => Array&lt;Types::ExecutionListItem&gt;
@@ -1190,10 +1325,11 @@ module Aws::States
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_executions({
-    #     state_machine_arn: "Arn", # required
+    #     state_machine_arn: "Arn",
     #     status_filter: "RUNNING", # accepts RUNNING, SUCCEEDED, FAILED, TIMED_OUT, ABORTED
     #     max_results: 1,
     #     next_token: "ListExecutionsPageToken",
+    #     map_run_arn: "LongArn",
     #   })
     #
     # @example Response structure
@@ -1205,6 +1341,8 @@ module Aws::States
     #   resp.executions[0].status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "TIMED_OUT", "ABORTED"
     #   resp.executions[0].start_date #=> Time
     #   resp.executions[0].stop_date #=> Time
+    #   resp.executions[0].map_run_arn #=> String
+    #   resp.executions[0].item_count #=> Integer
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ListExecutions AWS API Documentation
@@ -1216,6 +1354,64 @@ module Aws::States
       req.send_request(options)
     end
 
+    # Lists all Map Runs that were started by a given state machine
+    # execution. Use this API action to obtain Map Run ARNs, and then call
+    # `DescribeMapRun` to obtain more information, if needed.
+    #
+    # @option params [required, String] :execution_arn
+    #   The Amazon Resource Name (ARN) of the execution for which the Map Runs
+    #   must be listed.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results that are returned per call. You can use
+    #   `nextToken` to obtain further pages of results. The default is 100 and
+    #   the maximum allowed page size is 1000. A value of 0 uses the default.
+    #
+    #   This is only an upper limit. The actual number of results returned per
+    #   call might be fewer than the specified maximum.
+    #
+    # @option params [String] :next_token
+    #   If `nextToken` is returned, there are more results available. The
+    #   value of `nextToken` is a unique pagination token for each page. Make
+    #   the call again using the returned token to retrieve the next page.
+    #   Keep all other arguments unchanged. Each pagination token expires
+    #   after 24 hours. Using an expired pagination token will return an *HTTP
+    #   400 InvalidToken* error.
+    #
+    # @return [Types::ListMapRunsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListMapRunsOutput#map_runs #map_runs} => Array&lt;Types::MapRunListItem&gt;
+    #   * {Types::ListMapRunsOutput#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_map_runs({
+    #     execution_arn: "Arn", # required
+    #     max_results: 1,
+    #     next_token: "PageToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.map_runs #=> Array
+    #   resp.map_runs[0].execution_arn #=> String
+    #   resp.map_runs[0].map_run_arn #=> String
+    #   resp.map_runs[0].state_machine_arn #=> String
+    #   resp.map_runs[0].start_date #=> Time
+    #   resp.map_runs[0].stop_date #=> Time
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ListMapRuns AWS API Documentation
+    #
+    # @overload list_map_runs(params = {})
+    # @param [Hash] params ({})
+    def list_map_runs(params = {}, options = {})
+      req = build_request(:list_map_runs, params)
+      req.send_request(options)
+    end
+
     # Lists the existing state machines.
     #
     # If `nextToken` is returned, there are more results available. The
@@ -1444,13 +1640,25 @@ module Aws::States
       req.send_request(options)
     end
 
-    # Starts a state machine execution.
-    #
-    # <note markdown="1"> `StartExecution` is idempotent. If `StartExecution` is called with the
-    # same name and input as a running execution, the call will succeed and
-    # return the same response as the original request. If the execution is
-    # closed or if the input is different, it will return a 400
-    # `ExecutionAlreadyExists` error. Names can be reused after 90 days.
+    # Starts a state machine execution. If the given state machine Amazon
+    # Resource Name (ARN) is a qualified state machine ARN, it will fail
+    # with ValidationException.
+    #
+    # A qualified state machine ARN refers to a *Distributed Map state*
+    # defined within a state machine. For example, the qualified state
+    # machine ARN
+    # `arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel`
+    # refers to a *Distributed Map state* with a label `mapStateLabel` in
+    # the state machine named `stateMachineName`.
+    #
+    # <note markdown="1"> `StartExecution` is idempotent for `STANDARD` workflows. For a
+    # `STANDARD` workflow, if `StartExecution` is called with the same name
+    # and input as a running execution, the call will succeed and return the
+    # same response as the original request. If the execution is closed or
+    # if the input is different, it will return a `400
+    # ExecutionAlreadyExists` error. Names can be reused after 90 days.
+    #
+    #  `StartExecution` is not idempotent for `EXPRESS` workflows.
     #
     #  </note>
     #
@@ -1458,10 +1666,10 @@ module Aws::States
     #   The Amazon Resource Name (ARN) of the state machine to execute.
     #
     # @option params [String] :name
-    #   The name of the execution. This name must be unique for your AWS
-    #   account, region, and state machine for 90 days. For more information,
-    #   see [ Limits Related to State Machine Executions][1] in the *AWS Step
-    #   Functions Developer Guide*.
+    #   The name of the execution. This name must be unique for your Amazon
+    #   Web Services account, region, and state machine for 90 days. For more
+    #   information, see [ Limits Related to State Machine Executions][1] in
+    #   the *Step Functions Developer Guide*.
     #
     #   A name must *not* contain:
     #
@@ -1497,8 +1705,8 @@ module Aws::States
     #   bytes in UTF-8 encoding.
     #
     # @option params [String] :trace_header
-    #   Passes the AWS X-Ray trace header. The trace header can also be passed
-    #   in the request payload.
+    #   Passes the X-Ray trace header. The trace header can also be passed in
+    #   the request payload.
     #
     # @return [Types::StartExecutionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1529,6 +1737,19 @@ module Aws::States
     end
 
     # Starts a Synchronous Express state machine execution.
+    # `StartSyncExecution` is not available for `STANDARD` workflows.
+    #
+    # <note markdown="1"> `StartSyncExecution` will return a `200 OK` response, even if your
+    # execution fails, because the status code in the API response doesn't
+    # reflect function errors. Error codes are reserved for errors that
+    # prevent your execution from running, such as permissions errors, limit
+    # errors, or issues with your state machine code and configuration.
+    #
+    #  </note>
+    #
+    # <note markdown="1"> This API action isn't logged in CloudTrail.
+    #
+    #  </note>
     #
     # @option params [required, String] :state_machine_arn
     #   The Amazon Resource Name (ARN) of the state machine to execute.
@@ -1551,8 +1772,8 @@ module Aws::States
     #   bytes in UTF-8 encoding.
     #
     # @option params [String] :trace_header
-    #   Passes the AWS X-Ray trace header. The trace header can also be passed
-    #   in the request payload.
+    #   Passes the X-Ray trace header. The trace header can also be passed in
+    #   the request payload.
     #
     # @return [Types::StartSyncExecutionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1648,8 +1869,8 @@ module Aws::States
     # Add a tag to a Step Functions resource.
     #
     # An array of key-value pairs. For more information, see [Using Cost
-    # Allocation Tags][1] in the *AWS Billing and Cost Management User
-    # Guide*, and [Controlling Access Using IAM Tags][2].
+    # Allocation Tags][1] in the *Amazon Web Services Billing and Cost
+    # Management User Guide*, and [Controlling Access Using IAM Tags][2].
     #
     # Tags may only contain Unicode letters, digits, white space, or these
     # symbols: `_ . : / = + - @`.
@@ -1719,12 +1940,58 @@ module Aws::States
       req.send_request(options)
     end
 
+    # Updates an in-progress Map Run's configuration to include changes to
+    # the settings that control maximum concurrency and Map Run failure.
+    #
+    # @option params [required, String] :map_run_arn
+    #   The Amazon Resource Name (ARN) of a Map Run.
+    #
+    # @option params [Integer] :max_concurrency
+    #   The maximum number of child workflow executions that can be specified
+    #   to run in parallel for the Map Run at the same time.
+    #
+    # @option params [Float] :tolerated_failure_percentage
+    #   The maximum percentage of failed items before the Map Run fails.
+    #
+    # @option params [Integer] :tolerated_failure_count
+    #   The maximum number of failed items before the Map Run fails.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_map_run({
+    #     map_run_arn: "LongArn", # required
+    #     max_concurrency: 1,
+    #     tolerated_failure_percentage: 1.0,
+    #     tolerated_failure_count: 1,
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateMapRun AWS API Documentation
+    #
+    # @overload update_map_run(params = {})
+    # @param [Hash] params ({})
+    def update_map_run(params = {}, options = {})
+      req = build_request(:update_map_run, params)
+      req.send_request(options)
+    end
+
     # Updates an existing state machine by modifying its `definition`,
     # `roleArn`, or `loggingConfiguration`. Running executions will continue
     # to use the previous `definition` and `roleArn`. You must include at
     # least one of `definition` or `roleArn` or you will receive a
     # `MissingRequiredParameter` error.
     #
+    # If the given state machine Amazon Resource Name (ARN) is a qualified
+    # state machine ARN, it will fail with ValidationException.
+    #
+    # A qualified state machine ARN refers to a *Distributed Map state*
+    # defined within a state machine. For example, the qualified state
+    # machine ARN
+    # `arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel`
+    # refers to a *Distributed Map state* with a label `mapStateLabel` in
+    # the state machine named `stateMachineName`.
+    #
     # <note markdown="1"> All `StartExecution` calls within a few seconds will use the updated
     # `definition` and `roleArn`. Executions started immediately after
     # calling `UpdateStateMachine` may use the previous state machine
@@ -1751,7 +2018,7 @@ module Aws::States
     #   options.
     #
     # @option params [Types::TracingConfiguration] :tracing_configuration
-    #   Selects whether AWS X-Ray tracing is enabled.
+    #   Selects whether X-Ray tracing is enabled.
     #
     # @return [Types::UpdateStateMachineOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1805,7 +2072,7 @@ module Aws::States
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-states'
-      context[:gem_version] = '1.49.0'
+      context[:gem_version] = '1.51.0'
       Seahorse::Client::Request.new(handlers, context)
     end