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 +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-states/client.rb +257 -12
- data/lib/aws-sdk-states/client_api.rb +148 -1
- data/lib/aws-sdk-states/endpoint_parameters.rb +3 -0
- data/lib/aws-sdk-states/endpoint_provider.rb +80 -81
- data/lib/aws-sdk-states/endpoints.rb +42 -0
- data/lib/aws-sdk-states/errors.rb +21 -0
- data/lib/aws-sdk-states/plugins/endpoints.rb +6 -0
- data/lib/aws-sdk-states/types.rb +479 -288
- data/lib/aws-sdk-states.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 41a52c7f7ca5d10e0b7d71f42b5b96c8945ba2ed88dcca42807c38ea1d0ac08e
|
4
|
+
data.tar.gz: df6ae396713e880121cf250474c73a0bc81138cd5241ee77662ea0ab10da90b2
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
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
|
-
#
|
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
|
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
|
-
#
|
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
|
-
#
|
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
|
1148
|
-
#
|
1149
|
-
#
|
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 [
|
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<Types::ExecutionListItem>
|
@@ -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",
|
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<Types::MapRunListItem>
|
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.
|
2075
|
+
context[:gem_version] = '1.51.0'
|
1831
2076
|
Seahorse::Client::Request.new(handlers, context)
|
1832
2077
|
end
|
1833
2078
|
|