aws-sdk-states 1.50.0 → 1.51.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f8a4391c3c1388779afc11712f7082efc08dee8d3c0ce3a3f7d971f849c56e6b
4
- data.tar.gz: 41c13bf8db8a02f7d66b69e2095ea73588ddc0c920232f72eb62cd30673e38d7
3
+ metadata.gz: 41a52c7f7ca5d10e0b7d71f42b5b96c8945ba2ed88dcca42807c38ea1d0ac08e
4
+ data.tar.gz: df6ae396713e880121cf250474c73a0bc81138cd5241ee77662ea0ab10da90b2
5
5
  SHA512:
6
- metadata.gz: 2884d9201413a2723096e9fc42899297dac3dd623b10913bc38b90ca63ae1cc7b11049015a60e39902c98b5a6d59c8d9e8356d6f64cfce3cf4a789adcd4cd98c
7
- data.tar.gz: e16841af64a6a0fe88b7fd6265ecf6e6015a3df6da8bdbfc769f9b7bb28c66880c4e0e4f6bd4a10ef279a41549e0a9c615e7c928899e28db095c9bbeace6bc99
6
+ metadata.gz: 85b0c6e9bc25c354b1feabdc2f48b9dcc9dcb6a24b1a6402ddb0405b117adcd2b35ecc70492b0397a52f1e03a1c757a8cd05298b72e933e1ae57c3ec350ff707
7
+ data.tar.gz: 64f5a0472f54313332d6b95cde5a8653a924a46b04815ea58c437e7451f1486b3ce7c89927aff4666a7f8b727b101fe13781f417e0ddd2d955bbd07c7239e970
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.51.0 (2022-12-01)
5
+ ------------------
6
+
7
+ * 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.
8
+
4
9
  1.50.0 (2022-11-18)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.50.0
1
+ 1.51.0
@@ -639,6 +639,16 @@ module Aws::States
639
639
  # the state machine's status to `DELETING` and begins the deletion
640
640
  # process.
641
641
  #
642
+ # If the given state machine Amazon Resource Name (ARN) is a qualified
643
+ # state machine ARN, it will fail with ValidationException.
644
+ #
645
+ # A qualified state machine ARN refers to a *Distributed Map state*
646
+ # defined within a state machine. For example, the qualified state
647
+ # machine ARN
648
+ # `arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel`
649
+ # refers to a *Distributed Map state* with a label `mapStateLabel` in
650
+ # the state machine named `stateMachineName`.
651
+ #
642
652
  # <note markdown="1"> For `EXPRESS` state machines, the deletion will happen eventually
643
653
  # (usually less than a minute). Running executions may emit logs after
644
654
  # `DeleteStateMachine` API is called.
@@ -702,14 +712,18 @@ module Aws::States
702
712
  req.send_request(options)
703
713
  end
704
714
 
705
- # Describes an execution.
715
+ # Provides all information about a state machine execution, such as the
716
+ # state machine associated with the execution, the execution input and
717
+ # output, and relevant execution metadata. Use this API action to return
718
+ # the Map Run ARN if the execution was dispatched by a Map Run.
706
719
  #
707
720
  # <note markdown="1"> This operation is eventually consistent. The results are best effort
708
721
  # and may not reflect very recent updates and changes.
709
722
  #
710
723
  # </note>
711
724
  #
712
- # This API action is not supported by `EXPRESS` state machines.
725
+ # This API action is not supported by `EXPRESS` state machine executions
726
+ # unless they were dispatched by a Map Run.
713
727
  #
714
728
  # @option params [required, String] :execution_arn
715
729
  # The Amazon Resource Name (ARN) of the execution to describe.
@@ -727,6 +741,9 @@ module Aws::States
727
741
  # * {Types::DescribeExecutionOutput#output #output} => String
728
742
  # * {Types::DescribeExecutionOutput#output_details #output_details} => Types::CloudWatchEventsExecutionDataDetails
729
743
  # * {Types::DescribeExecutionOutput#trace_header #trace_header} => String
744
+ # * {Types::DescribeExecutionOutput#map_run_arn #map_run_arn} => String
745
+ # * {Types::DescribeExecutionOutput#error #error} => String
746
+ # * {Types::DescribeExecutionOutput#cause #cause} => String
730
747
  #
731
748
  # @example Request syntax with placeholder values
732
749
  #
@@ -747,6 +764,9 @@ module Aws::States
747
764
  # resp.output #=> String
748
765
  # resp.output_details.included #=> Boolean
749
766
  # resp.trace_header #=> String
767
+ # resp.map_run_arn #=> String
768
+ # resp.error #=> String
769
+ # resp.cause #=> String
750
770
  #
751
771
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeExecution AWS API Documentation
752
772
  #
@@ -757,7 +777,83 @@ module Aws::States
757
777
  req.send_request(options)
758
778
  end
759
779
 
760
- # Describes a state machine.
780
+ # Provides information about a Map Run's configuration, progress, and
781
+ # results. For more information, see [Examining Map Run][1] in the *Step
782
+ # Functions Developer Guide*.
783
+ #
784
+ #
785
+ #
786
+ # [1]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-examine-map-run.html
787
+ #
788
+ # @option params [required, String] :map_run_arn
789
+ # The Amazon Resource Name (ARN) that identifies a Map Run.
790
+ #
791
+ # @return [Types::DescribeMapRunOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
792
+ #
793
+ # * {Types::DescribeMapRunOutput#map_run_arn #map_run_arn} => String
794
+ # * {Types::DescribeMapRunOutput#execution_arn #execution_arn} => String
795
+ # * {Types::DescribeMapRunOutput#status #status} => String
796
+ # * {Types::DescribeMapRunOutput#start_date #start_date} => Time
797
+ # * {Types::DescribeMapRunOutput#stop_date #stop_date} => Time
798
+ # * {Types::DescribeMapRunOutput#max_concurrency #max_concurrency} => Integer
799
+ # * {Types::DescribeMapRunOutput#tolerated_failure_percentage #tolerated_failure_percentage} => Float
800
+ # * {Types::DescribeMapRunOutput#tolerated_failure_count #tolerated_failure_count} => Integer
801
+ # * {Types::DescribeMapRunOutput#item_counts #item_counts} => Types::MapRunItemCounts
802
+ # * {Types::DescribeMapRunOutput#execution_counts #execution_counts} => Types::MapRunExecutionCounts
803
+ #
804
+ # @example Request syntax with placeholder values
805
+ #
806
+ # resp = client.describe_map_run({
807
+ # map_run_arn: "LongArn", # required
808
+ # })
809
+ #
810
+ # @example Response structure
811
+ #
812
+ # resp.map_run_arn #=> String
813
+ # resp.execution_arn #=> String
814
+ # resp.status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "ABORTED"
815
+ # resp.start_date #=> Time
816
+ # resp.stop_date #=> Time
817
+ # resp.max_concurrency #=> Integer
818
+ # resp.tolerated_failure_percentage #=> Float
819
+ # resp.tolerated_failure_count #=> Integer
820
+ # resp.item_counts.pending #=> Integer
821
+ # resp.item_counts.running #=> Integer
822
+ # resp.item_counts.succeeded #=> Integer
823
+ # resp.item_counts.failed #=> Integer
824
+ # resp.item_counts.timed_out #=> Integer
825
+ # resp.item_counts.aborted #=> Integer
826
+ # resp.item_counts.total #=> Integer
827
+ # resp.item_counts.results_written #=> Integer
828
+ # resp.execution_counts.pending #=> Integer
829
+ # resp.execution_counts.running #=> Integer
830
+ # resp.execution_counts.succeeded #=> Integer
831
+ # resp.execution_counts.failed #=> Integer
832
+ # resp.execution_counts.timed_out #=> Integer
833
+ # resp.execution_counts.aborted #=> Integer
834
+ # resp.execution_counts.total #=> Integer
835
+ # resp.execution_counts.results_written #=> Integer
836
+ #
837
+ # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeMapRun AWS API Documentation
838
+ #
839
+ # @overload describe_map_run(params = {})
840
+ # @param [Hash] params ({})
841
+ def describe_map_run(params = {}, options = {})
842
+ req = build_request(:describe_map_run, params)
843
+ req.send_request(options)
844
+ end
845
+
846
+ # Provides information about a state machine's definition, its IAM role
847
+ # Amazon Resource Name (ARN), and configuration. If the state machine
848
+ # ARN is a qualified state machine ARN, the response returned includes
849
+ # the `Map` state's label.
850
+ #
851
+ # A qualified state machine ARN refers to a *Distributed Map state*
852
+ # defined within a state machine. For example, the qualified state
853
+ # machine ARN
854
+ # `arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel`
855
+ # refers to a *Distributed Map state* with a label `mapStateLabel` in
856
+ # the state machine named `stateMachineName`.
761
857
  #
762
858
  # <note markdown="1"> This operation is eventually consistent. The results are best effort
763
859
  # and may not reflect very recent updates and changes.
@@ -778,6 +874,7 @@ module Aws::States
778
874
  # * {Types::DescribeStateMachineOutput#creation_date #creation_date} => Time
779
875
  # * {Types::DescribeStateMachineOutput#logging_configuration #logging_configuration} => Types::LoggingConfiguration
780
876
  # * {Types::DescribeStateMachineOutput#tracing_configuration #tracing_configuration} => Types::TracingConfiguration
877
+ # * {Types::DescribeStateMachineOutput#label #label} => String
781
878
  #
782
879
  # @example Request syntax with placeholder values
783
880
  #
@@ -799,6 +896,7 @@ module Aws::States
799
896
  # resp.logging_configuration.destinations #=> Array
800
897
  # resp.logging_configuration.destinations[0].cloud_watch_logs_log_group.log_group_arn #=> String
801
898
  # resp.tracing_configuration.enabled #=> Boolean
899
+ # resp.label #=> String
802
900
  #
803
901
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachine AWS API Documentation
804
902
  #
@@ -809,7 +907,11 @@ module Aws::States
809
907
  req.send_request(options)
810
908
  end
811
909
 
812
- # Describes the state machine associated with a specific execution.
910
+ # Provides information about a state machine's definition, its
911
+ # execution role ARN, and configuration. If an execution was dispatched
912
+ # by a Map Run, the Map Run is returned in the response. Additionally,
913
+ # the state machine returned will be the state machine associated with
914
+ # the Map Run.
813
915
  #
814
916
  # <note markdown="1"> This operation is eventually consistent. The results are best effort
815
917
  # and may not reflect very recent updates and changes.
@@ -831,6 +933,8 @@ module Aws::States
831
933
  # * {Types::DescribeStateMachineForExecutionOutput#update_date #update_date} => Time
832
934
  # * {Types::DescribeStateMachineForExecutionOutput#logging_configuration #logging_configuration} => Types::LoggingConfiguration
833
935
  # * {Types::DescribeStateMachineForExecutionOutput#tracing_configuration #tracing_configuration} => Types::TracingConfiguration
936
+ # * {Types::DescribeStateMachineForExecutionOutput#map_run_arn #map_run_arn} => String
937
+ # * {Types::DescribeStateMachineForExecutionOutput#label #label} => String
834
938
  #
835
939
  # @example Request syntax with placeholder values
836
940
  #
@@ -850,6 +954,8 @@ module Aws::States
850
954
  # resp.logging_configuration.destinations #=> Array
851
955
  # resp.logging_configuration.destinations[0].cloud_watch_logs_log_group.log_group_arn #=> String
852
956
  # resp.tracing_configuration.enabled #=> Boolean
957
+ # resp.map_run_arn #=> String
958
+ # resp.label #=> String
853
959
  #
854
960
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineForExecution AWS API Documentation
855
961
  #
@@ -981,7 +1087,7 @@ module Aws::States
981
1087
  #
982
1088
  # resp.events #=> Array
983
1089
  # resp.events[0].timestamp #=> Time
984
- # 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"
1090
+ # 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"
985
1091
  # resp.events[0].id #=> Integer
986
1092
  # resp.events[0].previous_event_id #=> Integer
987
1093
  # resp.events[0].activity_failed_event_details.error #=> String
@@ -1072,6 +1178,9 @@ module Aws::States
1072
1178
  # resp.events[0].state_exited_event_details.name #=> String
1073
1179
  # resp.events[0].state_exited_event_details.output #=> String
1074
1180
  # resp.events[0].state_exited_event_details.output_details.truncated #=> Boolean
1181
+ # resp.events[0].map_run_started_event_details.map_run_arn #=> String
1182
+ # resp.events[0].map_run_failed_event_details.error #=> String
1183
+ # resp.events[0].map_run_failed_event_details.cause #=> String
1075
1184
  # resp.next_token #=> String
1076
1185
  #
1077
1186
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/GetExecutionHistory AWS API Documentation
@@ -1144,9 +1253,12 @@ module Aws::States
1144
1253
  req.send_request(options)
1145
1254
  end
1146
1255
 
1147
- # Lists the executions of a state machine that meet the filtering
1148
- # criteria. Results are sorted by time, with the most recent execution
1149
- # first.
1256
+ # Lists all executions of a state machine or a Map Run. You can list all
1257
+ # executions related to a state machine by specifying a state machine
1258
+ # Amazon Resource Name (ARN), or those related to a Map Run by
1259
+ # specifying a Map Run ARN.
1260
+ #
1261
+ # Results are sorted by time, with the most recent execution first.
1150
1262
  #
1151
1263
  # If `nextToken` is returned, there are more results available. The
1152
1264
  # value of `nextToken` is a unique pagination token for each page. Make
@@ -1162,10 +1274,13 @@ module Aws::States
1162
1274
  #
1163
1275
  # This API action is not supported by `EXPRESS` state machines.
1164
1276
  #
1165
- # @option params [required, String] :state_machine_arn
1277
+ # @option params [String] :state_machine_arn
1166
1278
  # The Amazon Resource Name (ARN) of the state machine whose executions
1167
1279
  # is listed.
1168
1280
  #
1281
+ # You can specify either a `mapRunArn` or a `stateMachineArn`, but not
1282
+ # both.
1283
+ #
1169
1284
  # @option params [String] :status_filter
1170
1285
  # If specified, only list the executions whose current execution status
1171
1286
  # matches the given filter.
@@ -1186,6 +1301,20 @@ module Aws::States
1186
1301
  # after 24 hours. Using an expired pagination token will return an *HTTP
1187
1302
  # 400 InvalidToken* error.
1188
1303
  #
1304
+ # @option params [String] :map_run_arn
1305
+ # The Amazon Resource Name (ARN) of the Map Run that started the child
1306
+ # workflow executions. If the `mapRunArn` field is specified, a list of
1307
+ # all of the child workflow executions started by a Map Run is returned.
1308
+ # For more information, see [Examining Map Run][1] in the *Step
1309
+ # Functions Developer Guide*.
1310
+ #
1311
+ # You can specify either a `mapRunArn` or a `stateMachineArn`, but not
1312
+ # both.
1313
+ #
1314
+ #
1315
+ #
1316
+ # [1]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-examine-map-run.html
1317
+ #
1189
1318
  # @return [Types::ListExecutionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1190
1319
  #
1191
1320
  # * {Types::ListExecutionsOutput#executions #executions} => Array&lt;Types::ExecutionListItem&gt;
@@ -1196,10 +1325,11 @@ module Aws::States
1196
1325
  # @example Request syntax with placeholder values
1197
1326
  #
1198
1327
  # resp = client.list_executions({
1199
- # state_machine_arn: "Arn", # required
1328
+ # state_machine_arn: "Arn",
1200
1329
  # status_filter: "RUNNING", # accepts RUNNING, SUCCEEDED, FAILED, TIMED_OUT, ABORTED
1201
1330
  # max_results: 1,
1202
1331
  # next_token: "ListExecutionsPageToken",
1332
+ # map_run_arn: "LongArn",
1203
1333
  # })
1204
1334
  #
1205
1335
  # @example Response structure
@@ -1211,6 +1341,8 @@ module Aws::States
1211
1341
  # resp.executions[0].status #=> String, one of "RUNNING", "SUCCEEDED", "FAILED", "TIMED_OUT", "ABORTED"
1212
1342
  # resp.executions[0].start_date #=> Time
1213
1343
  # resp.executions[0].stop_date #=> Time
1344
+ # resp.executions[0].map_run_arn #=> String
1345
+ # resp.executions[0].item_count #=> Integer
1214
1346
  # resp.next_token #=> String
1215
1347
  #
1216
1348
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ListExecutions AWS API Documentation
@@ -1222,6 +1354,64 @@ module Aws::States
1222
1354
  req.send_request(options)
1223
1355
  end
1224
1356
 
1357
+ # Lists all Map Runs that were started by a given state machine
1358
+ # execution. Use this API action to obtain Map Run ARNs, and then call
1359
+ # `DescribeMapRun` to obtain more information, if needed.
1360
+ #
1361
+ # @option params [required, String] :execution_arn
1362
+ # The Amazon Resource Name (ARN) of the execution for which the Map Runs
1363
+ # must be listed.
1364
+ #
1365
+ # @option params [Integer] :max_results
1366
+ # The maximum number of results that are returned per call. You can use
1367
+ # `nextToken` to obtain further pages of results. The default is 100 and
1368
+ # the maximum allowed page size is 1000. A value of 0 uses the default.
1369
+ #
1370
+ # This is only an upper limit. The actual number of results returned per
1371
+ # call might be fewer than the specified maximum.
1372
+ #
1373
+ # @option params [String] :next_token
1374
+ # If `nextToken` is returned, there are more results available. The
1375
+ # value of `nextToken` is a unique pagination token for each page. Make
1376
+ # the call again using the returned token to retrieve the next page.
1377
+ # Keep all other arguments unchanged. Each pagination token expires
1378
+ # after 24 hours. Using an expired pagination token will return an *HTTP
1379
+ # 400 InvalidToken* error.
1380
+ #
1381
+ # @return [Types::ListMapRunsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1382
+ #
1383
+ # * {Types::ListMapRunsOutput#map_runs #map_runs} => Array&lt;Types::MapRunListItem&gt;
1384
+ # * {Types::ListMapRunsOutput#next_token #next_token} => String
1385
+ #
1386
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1387
+ #
1388
+ # @example Request syntax with placeholder values
1389
+ #
1390
+ # resp = client.list_map_runs({
1391
+ # execution_arn: "Arn", # required
1392
+ # max_results: 1,
1393
+ # next_token: "PageToken",
1394
+ # })
1395
+ #
1396
+ # @example Response structure
1397
+ #
1398
+ # resp.map_runs #=> Array
1399
+ # resp.map_runs[0].execution_arn #=> String
1400
+ # resp.map_runs[0].map_run_arn #=> String
1401
+ # resp.map_runs[0].state_machine_arn #=> String
1402
+ # resp.map_runs[0].start_date #=> Time
1403
+ # resp.map_runs[0].stop_date #=> Time
1404
+ # resp.next_token #=> String
1405
+ #
1406
+ # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ListMapRuns AWS API Documentation
1407
+ #
1408
+ # @overload list_map_runs(params = {})
1409
+ # @param [Hash] params ({})
1410
+ def list_map_runs(params = {}, options = {})
1411
+ req = build_request(:list_map_runs, params)
1412
+ req.send_request(options)
1413
+ end
1414
+
1225
1415
  # Lists the existing state machines.
1226
1416
  #
1227
1417
  # If `nextToken` is returned, there are more results available. The
@@ -1450,7 +1640,16 @@ module Aws::States
1450
1640
  req.send_request(options)
1451
1641
  end
1452
1642
 
1453
- # Starts a state machine execution.
1643
+ # Starts a state machine execution. If the given state machine Amazon
1644
+ # Resource Name (ARN) is a qualified state machine ARN, it will fail
1645
+ # with ValidationException.
1646
+ #
1647
+ # A qualified state machine ARN refers to a *Distributed Map state*
1648
+ # defined within a state machine. For example, the qualified state
1649
+ # machine ARN
1650
+ # `arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel`
1651
+ # refers to a *Distributed Map state* with a label `mapStateLabel` in
1652
+ # the state machine named `stateMachineName`.
1454
1653
  #
1455
1654
  # <note markdown="1"> `StartExecution` is idempotent for `STANDARD` workflows. For a
1456
1655
  # `STANDARD` workflow, if `StartExecution` is called with the same name
@@ -1741,12 +1940,58 @@ module Aws::States
1741
1940
  req.send_request(options)
1742
1941
  end
1743
1942
 
1943
+ # Updates an in-progress Map Run's configuration to include changes to
1944
+ # the settings that control maximum concurrency and Map Run failure.
1945
+ #
1946
+ # @option params [required, String] :map_run_arn
1947
+ # The Amazon Resource Name (ARN) of a Map Run.
1948
+ #
1949
+ # @option params [Integer] :max_concurrency
1950
+ # The maximum number of child workflow executions that can be specified
1951
+ # to run in parallel for the Map Run at the same time.
1952
+ #
1953
+ # @option params [Float] :tolerated_failure_percentage
1954
+ # The maximum percentage of failed items before the Map Run fails.
1955
+ #
1956
+ # @option params [Integer] :tolerated_failure_count
1957
+ # The maximum number of failed items before the Map Run fails.
1958
+ #
1959
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1960
+ #
1961
+ # @example Request syntax with placeholder values
1962
+ #
1963
+ # resp = client.update_map_run({
1964
+ # map_run_arn: "LongArn", # required
1965
+ # max_concurrency: 1,
1966
+ # tolerated_failure_percentage: 1.0,
1967
+ # tolerated_failure_count: 1,
1968
+ # })
1969
+ #
1970
+ # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateMapRun AWS API Documentation
1971
+ #
1972
+ # @overload update_map_run(params = {})
1973
+ # @param [Hash] params ({})
1974
+ def update_map_run(params = {}, options = {})
1975
+ req = build_request(:update_map_run, params)
1976
+ req.send_request(options)
1977
+ end
1978
+
1744
1979
  # Updates an existing state machine by modifying its `definition`,
1745
1980
  # `roleArn`, or `loggingConfiguration`. Running executions will continue
1746
1981
  # to use the previous `definition` and `roleArn`. You must include at
1747
1982
  # least one of `definition` or `roleArn` or you will receive a
1748
1983
  # `MissingRequiredParameter` error.
1749
1984
  #
1985
+ # If the given state machine Amazon Resource Name (ARN) is a qualified
1986
+ # state machine ARN, it will fail with ValidationException.
1987
+ #
1988
+ # A qualified state machine ARN refers to a *Distributed Map state*
1989
+ # defined within a state machine. For example, the qualified state
1990
+ # machine ARN
1991
+ # `arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel`
1992
+ # refers to a *Distributed Map state* with a label `mapStateLabel` in
1993
+ # the state machine named `stateMachineName`.
1994
+ #
1750
1995
  # <note markdown="1"> All `StartExecution` calls within a few seconds will use the updated
1751
1996
  # `definition` and `roleArn`. Executions started immediately after
1752
1997
  # calling `UpdateStateMachine` may use the previous state machine
@@ -1827,7 +2072,7 @@ module Aws::States
1827
2072
  params: params,
1828
2073
  config: config)
1829
2074
  context[:gem_name] = 'aws-sdk-states'
1830
- context[:gem_version] = '1.50.0'
2075
+ context[:gem_version] = '1.51.0'
1831
2076
  Seahorse::Client::Request.new(handlers, context)
1832
2077
  end
1833
2078