aws-sdk-states 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: ff461c7df3b7ef42cb055a5d1c10943503a1e557
4
- data.tar.gz: 746d2ce2cbf1301e8776fc7b440ae24a620a9777
3
+ metadata.gz: fd1178a48e8b1a6c8218516aafe1502075de1dc3
4
+ data.tar.gz: 3ba0dc325469cf39d9a8ec1e65c0cf7844b5f0ea
5
5
  SHA512:
6
- metadata.gz: fe63445ecd302642c9ff0cd5ee3e0a08acb6852d282afe1653c1ade9508dbdd2d5fd91e732a076033257f08edc4836115ffb132b76fcd1ff7a830896e3953381
7
- data.tar.gz: 746a6b6e31e99dd2fad71c5a5cf3d4c7dd886c10e18d7f399e6f25e9afbc22cc88f72cc4a5a7d185fd76ca8ff5a17c8174086f222f924fd526d7e40932aff16a
6
+ metadata.gz: 038298c53dfe23c86f1ffa51f00e3e1fbac553be43aac958fce5febe3bcd7b2c22908480ccc359d5d800231c55d860409febc1bed263b42f36e2e001c797dcc0
7
+ data.tar.gz: 045268e73d597f7599e03f1840a1054535b201b3b3dff1a78affc4be7eac43b3dbcbc27641fa24d3eebad111c777fd857f3e12d9a83fc0bc31f4fab9599dc54c
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-states/customizations'
42
42
  # @service
43
43
  module Aws::States
44
44
 
45
- GEM_VERSION = '1.1.0'
45
+ GEM_VERSION = '1.2.0'
46
46
 
47
47
  end
@@ -155,13 +155,13 @@ module Aws::States
155
155
 
156
156
  # @!group API Operations
157
157
 
158
- # Creates an activity. An Activity is a task which you write, in any
159
- # language and hosted on any machine which has access to AWS Step
160
- # Functions. Activities must poll Step Functions using the
161
- # `GetActivityTask` and respond using `SendTask*` API calls. This
162
- # function lets Step Functions know the existence of your activity and
163
- # returns an identifier for use in a state machine and when polling from
164
- # the activity.
158
+ # Creates an activity. An activity is a task which you write in any
159
+ # programming language and host on any machine which has access to AWS
160
+ # Step Functions. Activities must poll Step Functions using the
161
+ # `GetActivityTask` API action and respond using `SendTask*` API
162
+ # actions. This function lets Step Functions know the existence of your
163
+ # activity and returns an identifier for use in a state machine and when
164
+ # polling from the activity.
165
165
  #
166
166
  # @option params [required, String] :name
167
167
  # The name of the activity to create. This name must be unique for your
@@ -211,8 +211,8 @@ module Aws::States
211
211
  end
212
212
 
213
213
  # Creates a state machine. A state machine consists of a collection of
214
- # states that can do work (`Task` states), determine which states to
215
- # transition to next (`Choice` states), stop an execution with an error
214
+ # states that can do work (`Task` states), determine to which states to
215
+ # transition next (`Choice` states), stop an execution with an error
216
216
  # (`Fail` states), and so on. State machines are specified using a
217
217
  # JSON-based, structured language.
218
218
  #
@@ -294,11 +294,15 @@ module Aws::States
294
294
  req.send_request(options)
295
295
  end
296
296
 
297
- # Deletes a state machine. This is an asynchronous operation-- it sets
298
- # the state machine's status to "DELETING" and begins the delete
299
- # process. Each state machine execution will be deleted the next time it
300
- # makes a state transition. After all executions have completed or been
301
- # deleted, the state machine itself will be deleted.
297
+ # Deletes a state machine. This is an asynchronous operation: It sets
298
+ # the state machine's status to `DELETING` and begins the deletion
299
+ # process. Each state machine execution is deleted the next time it
300
+ # makes a state transition.
301
+ #
302
+ # <note markdown="1"> The state machine itself is deleted after all executions are completed
303
+ # or deleted.
304
+ #
305
+ # </note>
302
306
  #
303
307
  # @option params [required, String] :state_machine_arn
304
308
  # The Amazon Resource Name (ARN) of the state machine to delete.
@@ -432,14 +436,51 @@ module Aws::States
432
436
  req.send_request(options)
433
437
  end
434
438
 
439
+ # Describes the state machine associated with a specific execution.
440
+ #
441
+ # @option params [required, String] :execution_arn
442
+ # The Amazon Resource Name (ARN) of the execution you want state machine
443
+ # information for.
444
+ #
445
+ # @return [Types::DescribeStateMachineForExecutionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
446
+ #
447
+ # * {Types::DescribeStateMachineForExecutionOutput#state_machine_arn #state_machine_arn} => String
448
+ # * {Types::DescribeStateMachineForExecutionOutput#name #name} => String
449
+ # * {Types::DescribeStateMachineForExecutionOutput#definition #definition} => String
450
+ # * {Types::DescribeStateMachineForExecutionOutput#role_arn #role_arn} => String
451
+ # * {Types::DescribeStateMachineForExecutionOutput#update_date #update_date} => Time
452
+ #
453
+ # @example Request syntax with placeholder values
454
+ #
455
+ # resp = client.describe_state_machine_for_execution({
456
+ # execution_arn: "Arn", # required
457
+ # })
458
+ #
459
+ # @example Response structure
460
+ #
461
+ # resp.state_machine_arn #=> String
462
+ # resp.name #=> String
463
+ # resp.definition #=> String
464
+ # resp.role_arn #=> String
465
+ # resp.update_date #=> Time
466
+ #
467
+ # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineForExecution AWS API Documentation
468
+ #
469
+ # @overload describe_state_machine_for_execution(params = {})
470
+ # @param [Hash] params ({})
471
+ def describe_state_machine_for_execution(params = {}, options = {})
472
+ req = build_request(:describe_state_machine_for_execution, params)
473
+ req.send_request(options)
474
+ end
475
+
435
476
  # Used by workers to retrieve a task (with the specified activity ARN)
436
477
  # which has been scheduled for execution by a running state machine.
437
478
  # This initiates a long poll, where the service holds the HTTP
438
479
  # connection open and responds as soon as a task becomes available (i.e.
439
480
  # an execution of a task of this type is needed.) The maximum time the
440
481
  # service holds on to the request before responding is 60 seconds. If no
441
- # task is available within 60 seconds, the poll will return a
442
- # `taskToken` with a null string.
482
+ # task is available within 60 seconds, the poll returns a `taskToken`
483
+ # with a null string.
443
484
  #
444
485
  # Workers should set their client side socket timeout to at least 65
445
486
  # seconds (5 seconds higher than the maximum time the service may hold
@@ -451,8 +492,8 @@ module Aws::States
451
492
  #
452
493
  # @option params [String] :worker_name
453
494
  # You can provide an arbitrary name in order to identify the worker that
454
- # the task is assigned to. This name will be used when it is logged in
455
- # the execution history.
495
+ # the task is assigned to. This name is used when it is logged in the
496
+ # execution history.
456
497
  #
457
498
  # @return [Types::GetActivityTaskOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
458
499
  #
@@ -483,27 +524,29 @@ module Aws::States
483
524
  # Returns the history of the specified execution as a list of events. By
484
525
  # default, the results are returned in ascending order of the
485
526
  # `timeStamp` of the events. Use the `reverseOrder` parameter to get the
486
- # latest events first. The results may be split into multiple pages. To
487
- # retrieve subsequent pages, make the call again using the `nextToken`
488
- # returned by the previous call.
527
+ # latest events first.
528
+ #
529
+ # If a `nextToken` is returned by a previous call, there are more
530
+ # results available. To retrieve the next page of results, make the call
531
+ # again using the returned token in `nextToken`. Keep all other
532
+ # arguments unchanged.
489
533
  #
490
534
  # @option params [required, String] :execution_arn
491
535
  # The Amazon Resource Name (ARN) of the execution.
492
536
  #
493
537
  # @option params [Integer] :max_results
494
- # The maximum number of results that will be returned per call.
495
- # `nextToken` can be used to obtain further pages of results. The
496
- # default is 100 and the maximum allowed page size is 100. A value of 0
497
- # means to use the default.
538
+ # The maximum number of results that are returned per call. You can use
539
+ # `nextToken` to obtain further pages of results. The default is 100 and
540
+ # the maximum allowed page size is 100. A value of 0 uses the default.
498
541
  #
499
- # This is an upper limit only; the actual number of results returned per
500
- # call may be fewer than the specified maximum.
542
+ # This is only an upper limit. The actual number of results returned per
543
+ # call might be fewer than the specified maximum.
501
544
  #
502
545
  # @option params [Boolean] :reverse_order
503
546
  # Lists events in descending order of their `timeStamp`.
504
547
  #
505
548
  # @option params [String] :next_token
506
- # If a `nextToken` was returned by a previous call, there are more
549
+ # If a `nextToken` is returned by a previous call, there are more
507
550
  # results available. To retrieve the next page of results, make the call
508
551
  # again using the returned token in `nextToken`. Keep all other
509
552
  # arguments unchanged.
@@ -580,21 +623,23 @@ module Aws::States
580
623
  req.send_request(options)
581
624
  end
582
625
 
583
- # Lists the existing activities. The results may be split into multiple
584
- # pages. To retrieve subsequent pages, make the call again using the
585
- # `nextToken` returned by the previous call.
626
+ # Lists the existing activities.
627
+ #
628
+ # If a `nextToken` is returned by a previous call, there are more
629
+ # results available. To retrieve the next page of results, make the call
630
+ # again using the returned token in `nextToken`. Keep all other
631
+ # arguments unchanged.
586
632
  #
587
633
  # @option params [Integer] :max_results
588
- # The maximum number of results that will be returned per call.
589
- # `nextToken` can be used to obtain further pages of results. The
590
- # default is 100 and the maximum allowed page size is 100. A value of 0
591
- # means to use the default.
634
+ # The maximum number of results that are returned per call. You can use
635
+ # `nextToken` to obtain further pages of results. The default is 100 and
636
+ # the maximum allowed page size is 100. A value of 0 uses the default.
592
637
  #
593
- # This is an upper limit only; the actual number of results returned per
594
- # call may be fewer than the specified maximum.
638
+ # This is only an upper limit. The actual number of results returned per
639
+ # call might be fewer than the specified maximum.
595
640
  #
596
641
  # @option params [String] :next_token
597
- # If a `nextToken` was returned by a previous call, there are more
642
+ # If a `nextToken` is returned by a previous call, there are more
598
643
  # results available. To retrieve the next page of results, make the call
599
644
  # again using the returned token in `nextToken`. Keep all other
600
645
  # arguments unchanged.
@@ -632,29 +677,31 @@ module Aws::States
632
677
  end
633
678
 
634
679
  # Lists the executions of a state machine that meet the filtering
635
- # criteria. The results may be split into multiple pages. To retrieve
636
- # subsequent pages, make the call again using the `nextToken` returned
637
- # by the previous call.
680
+ # criteria.
681
+ #
682
+ # If a `nextToken` is returned by a previous call, there are more
683
+ # results available. To retrieve the next page of results, make the call
684
+ # again using the returned token in `nextToken`. Keep all other
685
+ # arguments unchanged.
638
686
  #
639
687
  # @option params [required, String] :state_machine_arn
640
688
  # The Amazon Resource Name (ARN) of the state machine whose executions
641
- # will be listed.
689
+ # is listed.
642
690
  #
643
691
  # @option params [String] :status_filter
644
692
  # If specified, only list the executions whose current execution status
645
693
  # matches the given filter.
646
694
  #
647
695
  # @option params [Integer] :max_results
648
- # The maximum number of results that will be returned per call.
649
- # `nextToken` can be used to obtain further pages of results. The
650
- # default is 100 and the maximum allowed page size is 100. A value of 0
651
- # means to use the default.
696
+ # The maximum number of results that are returned per call. You can use
697
+ # `nextToken` to obtain further pages of results. The default is 100 and
698
+ # the maximum allowed page size is 100. A value of 0 uses the default.
652
699
  #
653
- # This is an upper limit only; the actual number of results returned per
654
- # call may be fewer than the specified maximum.
700
+ # This is only an upper limit. The actual number of results returned per
701
+ # call might be fewer than the specified maximum.
655
702
  #
656
703
  # @option params [String] :next_token
657
- # If a `nextToken` was returned by a previous call, there are more
704
+ # If a `nextToken` is returned by a previous call, there are more
658
705
  # results available. To retrieve the next page of results, make the call
659
706
  # again using the returned token in `nextToken`. Keep all other
660
707
  # arguments unchanged.
@@ -696,21 +743,23 @@ module Aws::States
696
743
  req.send_request(options)
697
744
  end
698
745
 
699
- # Lists the existing state machines. The results may be split into
700
- # multiple pages. To retrieve subsequent pages, make the call again
701
- # using the `nextToken` returned by the previous call.
746
+ # Lists the existing state machines.
747
+ #
748
+ # If a `nextToken` is returned by a previous call, there are more
749
+ # results available. To retrieve the next page of results, make the call
750
+ # again using the returned token in `nextToken`. Keep all other
751
+ # arguments unchanged.
702
752
  #
703
753
  # @option params [Integer] :max_results
704
- # The maximum number of results that will be returned per call.
705
- # `nextToken` can be used to obtain further pages of results. The
706
- # default is 100 and the maximum allowed page size is 100. A value of 0
707
- # means to use the default.
754
+ # The maximum number of results that are returned per call. You can use
755
+ # `nextToken` to obtain further pages of results. The default is 100 and
756
+ # the maximum allowed page size is 100. A value of 0 uses the default.
708
757
  #
709
- # This is an upper limit only; the actual number of results returned per
710
- # call may be fewer than the specified maximum.
758
+ # This is only an upper limit. The actual number of results returned per
759
+ # call might be fewer than the specified maximum.
711
760
  #
712
761
  # @option params [String] :next_token
713
- # If a `nextToken` was returned by a previous call, there are more
762
+ # If a `nextToken` is returned by a previous call, there are more
714
763
  # results available. To retrieve the next page of results, make the call
715
764
  # again using the returned token in `nextToken`. Keep all other
716
765
  # arguments unchanged.
@@ -785,7 +834,7 @@ module Aws::States
785
834
  # the `Heartbeat` clock. The `Heartbeat` threshold is specified in the
786
835
  # state machine's Amazon States Language definition. This action does
787
836
  # not in itself create an event in the execution history. However, if
788
- # the task times out, the execution history will contain an
837
+ # the task times out, the execution history contains an
789
838
  # `ActivityTimedOut` event.
790
839
  #
791
840
  # <note markdown="1"> The `Timeout` of a task, defined in the state machine's Amazon States
@@ -802,7 +851,7 @@ module Aws::States
802
851
  # @option params [required, String] :task_token
803
852
  # The token that represents this task. Task tokens are generated by the
804
853
  # service when the tasks are assigned to a worker (see
805
- # GetActivityTask::taskToken).
854
+ # GetActivityTaskOutput$taskToken).
806
855
  #
807
856
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
808
857
  #
@@ -827,7 +876,7 @@ module Aws::States
827
876
  # @option params [required, String] :task_token
828
877
  # The token that represents this task. Task tokens are generated by the
829
878
  # service when the tasks are assigned to a worker (see
830
- # GetActivityTask::taskToken).
879
+ # GetActivityTaskOutput$taskToken).
831
880
  #
832
881
  # @option params [required, String] :output
833
882
  # The JSON output of the task.
@@ -861,6 +910,22 @@ module Aws::States
861
910
  # Related to State Machine Executions][1] in the *AWS Step Functions
862
911
  # Developer Guide*.
863
912
  #
913
+ # An execution can't use the name of another execution for 90 days.
914
+ #
915
+ # When you make multiple `StartExecution` calls with the same name, the
916
+ # new execution doesn't run and the following rules apply:
917
+ #
918
+ # * When the original execution is open and the execution input from
919
+ # the
920
+ # new call is *different*, the `ExecutionAlreadyExists` message is
921
+ # returned.
922
+ #
923
+ # * When the original execution is open and the execution input from the
924
+ # new call is *identical*, the `Success` message is returned.
925
+ #
926
+ # * When the original execution is closed, the `ExecutionAlreadyExists`
927
+ # message is returned regardless of input.
928
+ #
864
929
  # A name must *not* contain:
865
930
  #
866
931
  # * whitespace
@@ -951,6 +1016,53 @@ module Aws::States
951
1016
  req.send_request(options)
952
1017
  end
953
1018
 
1019
+ # Updates an existing state machine by modifying its `definition` and/or
1020
+ # `roleArn`. Running executions will continue to use the previous
1021
+ # `definition` and `roleArn`.
1022
+ #
1023
+ # <note markdown="1"> All `StartExecution` calls within a few seconds will use the updated
1024
+ # `definition` and `roleArn`. Executions started immediately after
1025
+ # calling `UpdateStateMachine` may use the previous state machine
1026
+ # `definition` and `roleArn`. You must include at least one of
1027
+ # `definition` or `roleArn` or you will receive a
1028
+ # `MissingRequiredParameter` error.
1029
+ #
1030
+ # </note>
1031
+ #
1032
+ # @option params [required, String] :state_machine_arn
1033
+ # The Amazon Resource Name (ARN) of the state machine.
1034
+ #
1035
+ # @option params [String] :definition
1036
+ # The Amazon States Language definition of the state machine.
1037
+ #
1038
+ # @option params [String] :role_arn
1039
+ # The Amazon Resource Name (ARN) of the IAM role of the state machine.
1040
+ #
1041
+ # @return [Types::UpdateStateMachineOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1042
+ #
1043
+ # * {Types::UpdateStateMachineOutput#update_date #update_date} => Time
1044
+ #
1045
+ # @example Request syntax with placeholder values
1046
+ #
1047
+ # resp = client.update_state_machine({
1048
+ # state_machine_arn: "Arn", # required
1049
+ # definition: "Definition",
1050
+ # role_arn: "Arn",
1051
+ # })
1052
+ #
1053
+ # @example Response structure
1054
+ #
1055
+ # resp.update_date #=> Time
1056
+ #
1057
+ # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateStateMachine AWS API Documentation
1058
+ #
1059
+ # @overload update_state_machine(params = {})
1060
+ # @param [Hash] params ({})
1061
+ def update_state_machine(params = {}, options = {})
1062
+ req = build_request(:update_state_machine, params)
1063
+ req.send_request(options)
1064
+ end
1065
+
954
1066
  # @!endgroup
955
1067
 
956
1068
  # @param params ({})
@@ -964,7 +1076,7 @@ module Aws::States
964
1076
  params: params,
965
1077
  config: config)
966
1078
  context[:gem_name] = 'aws-sdk-states'
967
- context[:gem_version] = '1.1.0'
1079
+ context[:gem_version] = '1.2.0'
968
1080
  Seahorse::Client::Request.new(handlers, context)
969
1081
  end
970
1082
 
@@ -38,6 +38,8 @@ module Aws::States
38
38
  DescribeActivityOutput = Shapes::StructureShape.new(name: 'DescribeActivityOutput')
39
39
  DescribeExecutionInput = Shapes::StructureShape.new(name: 'DescribeExecutionInput')
40
40
  DescribeExecutionOutput = Shapes::StructureShape.new(name: 'DescribeExecutionOutput')
41
+ DescribeStateMachineForExecutionInput = Shapes::StructureShape.new(name: 'DescribeStateMachineForExecutionInput')
42
+ DescribeStateMachineForExecutionOutput = Shapes::StructureShape.new(name: 'DescribeStateMachineForExecutionOutput')
41
43
  DescribeStateMachineInput = Shapes::StructureShape.new(name: 'DescribeStateMachineInput')
42
44
  DescribeStateMachineOutput = Shapes::StructureShape.new(name: 'DescribeStateMachineOutput')
43
45
  Error = Shapes::StringShape.new(name: 'Error')
@@ -80,6 +82,7 @@ module Aws::States
80
82
  ListExecutionsOutput = Shapes::StructureShape.new(name: 'ListExecutionsOutput')
81
83
  ListStateMachinesInput = Shapes::StructureShape.new(name: 'ListStateMachinesInput')
82
84
  ListStateMachinesOutput = Shapes::StructureShape.new(name: 'ListStateMachinesOutput')
85
+ MissingRequiredParameter = Shapes::StructureShape.new(name: 'MissingRequiredParameter')
83
86
  Name = Shapes::StringShape.new(name: 'Name')
84
87
  PageSize = Shapes::IntegerShape.new(name: 'PageSize')
85
88
  PageToken = Shapes::StringShape.new(name: 'PageToken')
@@ -108,6 +111,8 @@ module Aws::States
108
111
  TaskToken = Shapes::StringShape.new(name: 'TaskToken')
109
112
  TimeoutInSeconds = Shapes::IntegerShape.new(name: 'TimeoutInSeconds')
110
113
  Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
114
+ UpdateStateMachineInput = Shapes::StructureShape.new(name: 'UpdateStateMachineInput')
115
+ UpdateStateMachineOutput = Shapes::StructureShape.new(name: 'UpdateStateMachineOutput')
111
116
 
112
117
  ActivityFailedEventDetails.add_member(:error, Shapes::ShapeRef.new(shape: Error, location_name: "error"))
113
118
  ActivityFailedEventDetails.add_member(:cause, Shapes::ShapeRef.new(shape: Cause, location_name: "cause"))
@@ -187,6 +192,16 @@ module Aws::States
187
192
  DescribeExecutionOutput.add_member(:output, Shapes::ShapeRef.new(shape: Data, location_name: "output"))
188
193
  DescribeExecutionOutput.struct_class = Types::DescribeExecutionOutput
189
194
 
195
+ DescribeStateMachineForExecutionInput.add_member(:execution_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "executionArn"))
196
+ DescribeStateMachineForExecutionInput.struct_class = Types::DescribeStateMachineForExecutionInput
197
+
198
+ DescribeStateMachineForExecutionOutput.add_member(:state_machine_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "stateMachineArn"))
199
+ DescribeStateMachineForExecutionOutput.add_member(:name, Shapes::ShapeRef.new(shape: Name, required: true, location_name: "name"))
200
+ DescribeStateMachineForExecutionOutput.add_member(:definition, Shapes::ShapeRef.new(shape: Definition, required: true, location_name: "definition"))
201
+ DescribeStateMachineForExecutionOutput.add_member(:role_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "roleArn"))
202
+ DescribeStateMachineForExecutionOutput.add_member(:update_date, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "updateDate"))
203
+ DescribeStateMachineForExecutionOutput.struct_class = Types::DescribeStateMachineForExecutionOutput
204
+
190
205
  DescribeStateMachineInput.add_member(:state_machine_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "stateMachineArn"))
191
206
  DescribeStateMachineInput.struct_class = Types::DescribeStateMachineInput
192
207
 
@@ -372,6 +387,14 @@ module Aws::States
372
387
  StopExecutionOutput.add_member(:stop_date, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "stopDate"))
373
388
  StopExecutionOutput.struct_class = Types::StopExecutionOutput
374
389
 
390
+ UpdateStateMachineInput.add_member(:state_machine_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "stateMachineArn"))
391
+ UpdateStateMachineInput.add_member(:definition, Shapes::ShapeRef.new(shape: Definition, location_name: "definition"))
392
+ UpdateStateMachineInput.add_member(:role_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "roleArn"))
393
+ UpdateStateMachineInput.struct_class = Types::UpdateStateMachineInput
394
+
395
+ UpdateStateMachineOutput.add_member(:update_date, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "updateDate"))
396
+ UpdateStateMachineOutput.struct_class = Types::UpdateStateMachineOutput
397
+
375
398
 
376
399
  # @api private
377
400
  API = Seahorse::Model::Api.new.tap do |api|
@@ -459,6 +482,16 @@ module Aws::States
459
482
  o.errors << Shapes::ShapeRef.new(shape: StateMachineDoesNotExist)
460
483
  end)
461
484
 
485
+ api.add_operation(:describe_state_machine_for_execution, Seahorse::Model::Operation.new.tap do |o|
486
+ o.name = "DescribeStateMachineForExecution"
487
+ o.http_method = "POST"
488
+ o.http_request_uri = "/"
489
+ o.input = Shapes::ShapeRef.new(shape: DescribeStateMachineForExecutionInput)
490
+ o.output = Shapes::ShapeRef.new(shape: DescribeStateMachineForExecutionOutput)
491
+ o.errors << Shapes::ShapeRef.new(shape: ExecutionDoesNotExist)
492
+ o.errors << Shapes::ShapeRef.new(shape: InvalidArn)
493
+ end)
494
+
462
495
  api.add_operation(:get_activity_task, Seahorse::Model::Operation.new.tap do |o|
463
496
  o.name = "GetActivityTask"
464
497
  o.http_method = "POST"
@@ -592,6 +625,19 @@ module Aws::States
592
625
  o.errors << Shapes::ShapeRef.new(shape: ExecutionDoesNotExist)
593
626
  o.errors << Shapes::ShapeRef.new(shape: InvalidArn)
594
627
  end)
628
+
629
+ api.add_operation(:update_state_machine, Seahorse::Model::Operation.new.tap do |o|
630
+ o.name = "UpdateStateMachine"
631
+ o.http_method = "POST"
632
+ o.http_request_uri = "/"
633
+ o.input = Shapes::ShapeRef.new(shape: UpdateStateMachineInput)
634
+ o.output = Shapes::ShapeRef.new(shape: UpdateStateMachineOutput)
635
+ o.errors << Shapes::ShapeRef.new(shape: InvalidArn)
636
+ o.errors << Shapes::ShapeRef.new(shape: InvalidDefinition)
637
+ o.errors << Shapes::ShapeRef.new(shape: MissingRequiredParameter)
638
+ o.errors << Shapes::ShapeRef.new(shape: StateMachineDeleting)
639
+ o.errors << Shapes::ShapeRef.new(shape: StateMachineDoesNotExist)
640
+ end)
595
641
  end
596
642
 
597
643
  end
@@ -49,7 +49,7 @@ module Aws::States
49
49
  # @return [String]
50
50
  #
51
51
  # @!attribute [rw] creation_date
52
- # The date the activity was created.
52
+ # The date the activity is created.
53
53
  # @return [Time]
54
54
  #
55
55
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ActivityListItem AWS API Documentation
@@ -112,8 +112,8 @@ module Aws::States
112
112
  # Contains details about the start of an activity during an execution.
113
113
  #
114
114
  # @!attribute [rw] worker_name
115
- # The name of the worker that the task was assigned to. These names
116
- # are provided by the workers when calling GetActivityTask.
115
+ # The name of the worker that the task is assigned to. These names are
116
+ # provided by the workers when calling GetActivityTask.
117
117
  # @return [String]
118
118
  #
119
119
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ActivityStartedEventDetails AWS API Documentation
@@ -198,7 +198,7 @@ module Aws::States
198
198
  # @return [String]
199
199
  #
200
200
  # @!attribute [rw] creation_date
201
- # The date the activity was created.
201
+ # The date the activity is created.
202
202
  # @return [Time]
203
203
  #
204
204
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/CreateActivityOutput AWS API Documentation
@@ -265,7 +265,7 @@ module Aws::States
265
265
  # @return [String]
266
266
  #
267
267
  # @!attribute [rw] creation_date
268
- # The date the state machine was created.
268
+ # The date the state machine is created.
269
269
  # @return [Time]
270
270
  #
271
271
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/CreateStateMachineOutput AWS API Documentation
@@ -359,7 +359,7 @@ module Aws::States
359
359
  # @return [String]
360
360
  #
361
361
  # @!attribute [rw] creation_date
362
- # The date the activity was created.
362
+ # The date the activity is created.
363
363
  # @return [Time]
364
364
  #
365
365
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeActivityOutput AWS API Documentation
@@ -418,7 +418,7 @@ module Aws::States
418
418
  # @return [String]
419
419
  #
420
420
  # @!attribute [rw] start_date
421
- # The date the execution was started.
421
+ # The date the execution is started.
422
422
  # @return [Time]
423
423
  #
424
424
  # @!attribute [rw] stop_date
@@ -431,6 +431,11 @@ module Aws::States
431
431
  #
432
432
  # @!attribute [rw] output
433
433
  # The JSON output data of the execution.
434
+ #
435
+ # <note markdown="1"> This field is set only if the execution succeeds. If the execution
436
+ # fails, this field is null.
437
+ #
438
+ # </note>
434
439
  # @return [String]
435
440
  #
436
441
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeExecutionOutput AWS API Documentation
@@ -447,6 +452,60 @@ module Aws::States
447
452
  include Aws::Structure
448
453
  end
449
454
 
455
+ # @note When making an API call, you may pass DescribeStateMachineForExecutionInput
456
+ # data as a hash:
457
+ #
458
+ # {
459
+ # execution_arn: "Arn", # required
460
+ # }
461
+ #
462
+ # @!attribute [rw] execution_arn
463
+ # The Amazon Resource Name (ARN) of the execution you want state
464
+ # machine information for.
465
+ # @return [String]
466
+ #
467
+ # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineForExecutionInput AWS API Documentation
468
+ #
469
+ class DescribeStateMachineForExecutionInput < Struct.new(
470
+ :execution_arn)
471
+ include Aws::Structure
472
+ end
473
+
474
+ # @!attribute [rw] state_machine_arn
475
+ # The Amazon Resource Name (ARN) of the state machine associated with
476
+ # the execution.
477
+ # @return [String]
478
+ #
479
+ # @!attribute [rw] name
480
+ # The name of the state machine associated with the execution.
481
+ # @return [String]
482
+ #
483
+ # @!attribute [rw] definition
484
+ # The Amazon States Language definition of the state machine.
485
+ # @return [String]
486
+ #
487
+ # @!attribute [rw] role_arn
488
+ # The Amazon Resource Name (ARN) of the IAM role of the State Machine
489
+ # for the execution.
490
+ # @return [String]
491
+ #
492
+ # @!attribute [rw] update_date
493
+ # The date and time the state machine associated with an execution was
494
+ # updated. For a newly created state machine, this is the creation
495
+ # date.
496
+ # @return [Time]
497
+ #
498
+ # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineForExecutionOutput AWS API Documentation
499
+ #
500
+ class DescribeStateMachineForExecutionOutput < Struct.new(
501
+ :state_machine_arn,
502
+ :name,
503
+ :definition,
504
+ :role_arn,
505
+ :update_date)
506
+ include Aws::Structure
507
+ end
508
+
450
509
  # @note When making an API call, you may pass DescribeStateMachineInput
451
510
  # data as a hash:
452
511
  #
@@ -500,7 +559,7 @@ module Aws::States
500
559
  # @return [String]
501
560
  #
502
561
  # @!attribute [rw] creation_date
503
- # The date the state machine was created.
562
+ # The date the state machine is created.
504
563
  # @return [Time]
505
564
  #
506
565
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineOutput AWS API Documentation
@@ -667,8 +726,8 @@ module Aws::States
667
726
  #
668
727
  # @!attribute [rw] worker_name
669
728
  # You can provide an arbitrary name in order to identify the worker
670
- # that the task is assigned to. This name will be used when it is
671
- # logged in the execution history.
729
+ # that the task is assigned to. This name is used when it is logged in
730
+ # the execution history.
672
731
  # @return [String]
673
732
  #
674
733
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/GetActivityTaskInput AWS API Documentation
@@ -713,13 +772,13 @@ module Aws::States
713
772
  # @return [String]
714
773
  #
715
774
  # @!attribute [rw] max_results
716
- # The maximum number of results that will be returned per call.
717
- # `nextToken` can be used to obtain further pages of results. The
718
- # default is 100 and the maximum allowed page size is 100. A value of
719
- # 0 means to use the default.
775
+ # The maximum number of results that are returned per call. You can
776
+ # use `nextToken` to obtain further pages of results. The default is
777
+ # 100 and the maximum allowed page size is 100. A value of 0 uses the
778
+ # default.
720
779
  #
721
- # This is an upper limit only; the actual number of results returned
722
- # per call may be fewer than the specified maximum.
780
+ # This is only an upper limit. The actual number of results returned
781
+ # per call might be fewer than the specified maximum.
723
782
  # @return [Integer]
724
783
  #
725
784
  # @!attribute [rw] reverse_order
@@ -727,7 +786,7 @@ module Aws::States
727
786
  # @return [Boolean]
728
787
  #
729
788
  # @!attribute [rw] next_token
730
- # If a `nextToken` was returned by a previous call, there are more
789
+ # If a `nextToken` is returned by a previous call, there are more
731
790
  # results available. To retrieve the next page of results, make the
732
791
  # call again using the returned token in `nextToken`. Keep all other
733
792
  # arguments unchanged.
@@ -751,9 +810,10 @@ module Aws::States
751
810
  # @return [Array<Types::HistoryEvent>]
752
811
  #
753
812
  # @!attribute [rw] next_token
754
- # If a `nextToken` is returned, there are more results available. To
755
- # retrieve the next page of results, make the call again using the
756
- # returned token in `nextToken`. Keep all other arguments unchanged.
813
+ # If a `nextToken` is returned by a previous call, there are more
814
+ # results available. To retrieve the next page of results, make the
815
+ # call again using the returned token in `nextToken`. Keep all other
816
+ # arguments unchanged.
757
817
  #
758
818
  # The configured `maxResults` determines how many results can be
759
819
  # returned in a single call.
@@ -1024,17 +1084,17 @@ module Aws::States
1024
1084
  # }
1025
1085
  #
1026
1086
  # @!attribute [rw] max_results
1027
- # The maximum number of results that will be returned per call.
1028
- # `nextToken` can be used to obtain further pages of results. The
1029
- # default is 100 and the maximum allowed page size is 100. A value of
1030
- # 0 means to use the default.
1087
+ # The maximum number of results that are returned per call. You can
1088
+ # use `nextToken` to obtain further pages of results. The default is
1089
+ # 100 and the maximum allowed page size is 100. A value of 0 uses the
1090
+ # default.
1031
1091
  #
1032
- # This is an upper limit only; the actual number of results returned
1033
- # per call may be fewer than the specified maximum.
1092
+ # This is only an upper limit. The actual number of results returned
1093
+ # per call might be fewer than the specified maximum.
1034
1094
  # @return [Integer]
1035
1095
  #
1036
1096
  # @!attribute [rw] next_token
1037
- # If a `nextToken` was returned by a previous call, there are more
1097
+ # If a `nextToken` is returned by a previous call, there are more
1038
1098
  # results available. To retrieve the next page of results, make the
1039
1099
  # call again using the returned token in `nextToken`. Keep all other
1040
1100
  # arguments unchanged.
@@ -1056,9 +1116,10 @@ module Aws::States
1056
1116
  # @return [Array<Types::ActivityListItem>]
1057
1117
  #
1058
1118
  # @!attribute [rw] next_token
1059
- # If a `nextToken` is returned, there are more results available. To
1060
- # retrieve the next page of results, make the call again using the
1061
- # returned token in `nextToken`. Keep all other arguments unchanged.
1119
+ # If a `nextToken` is returned by a previous call, there are more
1120
+ # results available. To retrieve the next page of results, make the
1121
+ # call again using the returned token in `nextToken`. Keep all other
1122
+ # arguments unchanged.
1062
1123
  #
1063
1124
  # The configured `maxResults` determines how many results can be
1064
1125
  # returned in a single call.
@@ -1084,7 +1145,7 @@ module Aws::States
1084
1145
  #
1085
1146
  # @!attribute [rw] state_machine_arn
1086
1147
  # The Amazon Resource Name (ARN) of the state machine whose executions
1087
- # will be listed.
1148
+ # is listed.
1088
1149
  # @return [String]
1089
1150
  #
1090
1151
  # @!attribute [rw] status_filter
@@ -1093,17 +1154,17 @@ module Aws::States
1093
1154
  # @return [String]
1094
1155
  #
1095
1156
  # @!attribute [rw] max_results
1096
- # The maximum number of results that will be returned per call.
1097
- # `nextToken` can be used to obtain further pages of results. The
1098
- # default is 100 and the maximum allowed page size is 100. A value of
1099
- # 0 means to use the default.
1157
+ # The maximum number of results that are returned per call. You can
1158
+ # use `nextToken` to obtain further pages of results. The default is
1159
+ # 100 and the maximum allowed page size is 100. A value of 0 uses the
1160
+ # default.
1100
1161
  #
1101
- # This is an upper limit only; the actual number of results returned
1102
- # per call may be fewer than the specified maximum.
1162
+ # This is only an upper limit. The actual number of results returned
1163
+ # per call might be fewer than the specified maximum.
1103
1164
  # @return [Integer]
1104
1165
  #
1105
1166
  # @!attribute [rw] next_token
1106
- # If a `nextToken` was returned by a previous call, there are more
1167
+ # If a `nextToken` is returned by a previous call, there are more
1107
1168
  # results available. To retrieve the next page of results, make the
1108
1169
  # call again using the returned token in `nextToken`. Keep all other
1109
1170
  # arguments unchanged.
@@ -1127,9 +1188,10 @@ module Aws::States
1127
1188
  # @return [Array<Types::ExecutionListItem>]
1128
1189
  #
1129
1190
  # @!attribute [rw] next_token
1130
- # If a `nextToken` is returned, there are more results available. To
1131
- # retrieve the next page of results, make the call again using the
1132
- # returned token in `nextToken`. Keep all other arguments unchanged.
1191
+ # If a `nextToken` is returned by a previous call, there are more
1192
+ # results available. To retrieve the next page of results, make the
1193
+ # call again using the returned token in `nextToken`. Keep all other
1194
+ # arguments unchanged.
1133
1195
  #
1134
1196
  # The configured `maxResults` determines how many results can be
1135
1197
  # returned in a single call.
@@ -1152,17 +1214,17 @@ module Aws::States
1152
1214
  # }
1153
1215
  #
1154
1216
  # @!attribute [rw] max_results
1155
- # The maximum number of results that will be returned per call.
1156
- # `nextToken` can be used to obtain further pages of results. The
1157
- # default is 100 and the maximum allowed page size is 100. A value of
1158
- # 0 means to use the default.
1217
+ # The maximum number of results that are returned per call. You can
1218
+ # use `nextToken` to obtain further pages of results. The default is
1219
+ # 100 and the maximum allowed page size is 100. A value of 0 uses the
1220
+ # default.
1159
1221
  #
1160
- # This is an upper limit only; the actual number of results returned
1161
- # per call may be fewer than the specified maximum.
1222
+ # This is only an upper limit. The actual number of results returned
1223
+ # per call might be fewer than the specified maximum.
1162
1224
  # @return [Integer]
1163
1225
  #
1164
1226
  # @!attribute [rw] next_token
1165
- # If a `nextToken` was returned by a previous call, there are more
1227
+ # If a `nextToken` is returned by a previous call, there are more
1166
1228
  # results available. To retrieve the next page of results, make the
1167
1229
  # call again using the returned token in `nextToken`. Keep all other
1168
1230
  # arguments unchanged.
@@ -1183,9 +1245,10 @@ module Aws::States
1183
1245
  # @return [Array<Types::StateMachineListItem>]
1184
1246
  #
1185
1247
  # @!attribute [rw] next_token
1186
- # If a `nextToken` is returned, there are more results available. To
1187
- # retrieve the next page of results, make the call again using the
1188
- # returned token in `nextToken`. Keep all other arguments unchanged.
1248
+ # If a `nextToken` is returned by a previous call, there are more
1249
+ # results available. To retrieve the next page of results, make the
1250
+ # call again using the returned token in `nextToken`. Keep all other
1251
+ # arguments unchanged.
1189
1252
  #
1190
1253
  # The configured `maxResults` determines how many results can be
1191
1254
  # returned in a single call.
@@ -1245,7 +1308,7 @@ module Aws::States
1245
1308
  # @!attribute [rw] task_token
1246
1309
  # The token that represents this task. Task tokens are generated by
1247
1310
  # the service when the tasks are assigned to a worker (see
1248
- # GetActivityTask::taskToken).
1311
+ # GetActivityTaskOutput$taskToken).
1249
1312
  # @return [String]
1250
1313
  #
1251
1314
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/SendTaskHeartbeatInput AWS API Documentation
@@ -1270,7 +1333,7 @@ module Aws::States
1270
1333
  # @!attribute [rw] task_token
1271
1334
  # The token that represents this task. Task tokens are generated by
1272
1335
  # the service when the tasks are assigned to a worker (see
1273
- # GetActivityTask::taskToken).
1336
+ # GetActivityTaskOutput$taskToken).
1274
1337
  # @return [String]
1275
1338
  #
1276
1339
  # @!attribute [rw] output
@@ -1308,6 +1371,21 @@ module Aws::States
1308
1371
  # Related to State Machine Executions][1] in the *AWS Step Functions
1309
1372
  # Developer Guide*.
1310
1373
  #
1374
+ # An execution can't use the name of another execution for 90 days.
1375
+ #
1376
+ # When you make multiple `StartExecution` calls with the same name,
1377
+ # the new execution doesn't run and the following rules apply:
1378
+ #
1379
+ # * When the original execution is open and the execution input from
1380
+ # the new call is *different*, the `ExecutionAlreadyExists` message
1381
+ # is returned.
1382
+ #
1383
+ # * When the original execution is open and the execution input from
1384
+ # the new call is *identical*, the `Success` message is returned.
1385
+ #
1386
+ # * When the original execution is closed, the
1387
+ # `ExecutionAlreadyExists` message is returned regardless of input.
1388
+ #
1311
1389
  # A name must *not* contain:
1312
1390
  #
1313
1391
  # * whitespace
@@ -1351,7 +1429,7 @@ module Aws::States
1351
1429
  # @return [String]
1352
1430
  #
1353
1431
  # @!attribute [rw] start_date
1354
- # The date the execution was started.
1432
+ # The date the execution is started.
1355
1433
  # @return [Time]
1356
1434
  #
1357
1435
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/StartExecutionOutput AWS API Documentation
@@ -1433,7 +1511,7 @@ module Aws::States
1433
1511
  # @return [String]
1434
1512
  #
1435
1513
  # @!attribute [rw] creation_date
1436
- # The date the state machine was created.
1514
+ # The date the state machine is created.
1437
1515
  # @return [Time]
1438
1516
  #
1439
1517
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/StateMachineListItem AWS API Documentation
@@ -1477,7 +1555,7 @@ module Aws::States
1477
1555
  end
1478
1556
 
1479
1557
  # @!attribute [rw] stop_date
1480
- # The date the execution was stopped.
1558
+ # The date the execution is stopped.
1481
1559
  # @return [Time]
1482
1560
  #
1483
1561
  # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/StopExecutionOutput AWS API Documentation
@@ -1487,5 +1565,46 @@ module Aws::States
1487
1565
  include Aws::Structure
1488
1566
  end
1489
1567
 
1568
+ # @note When making an API call, you may pass UpdateStateMachineInput
1569
+ # data as a hash:
1570
+ #
1571
+ # {
1572
+ # state_machine_arn: "Arn", # required
1573
+ # definition: "Definition",
1574
+ # role_arn: "Arn",
1575
+ # }
1576
+ #
1577
+ # @!attribute [rw] state_machine_arn
1578
+ # The Amazon Resource Name (ARN) of the state machine.
1579
+ # @return [String]
1580
+ #
1581
+ # @!attribute [rw] definition
1582
+ # The Amazon States Language definition of the state machine.
1583
+ # @return [String]
1584
+ #
1585
+ # @!attribute [rw] role_arn
1586
+ # The Amazon Resource Name (ARN) of the IAM role of the state machine.
1587
+ # @return [String]
1588
+ #
1589
+ # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateStateMachineInput AWS API Documentation
1590
+ #
1591
+ class UpdateStateMachineInput < Struct.new(
1592
+ :state_machine_arn,
1593
+ :definition,
1594
+ :role_arn)
1595
+ include Aws::Structure
1596
+ end
1597
+
1598
+ # @!attribute [rw] update_date
1599
+ # The date and time the state machine was updated.
1600
+ # @return [Time]
1601
+ #
1602
+ # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateStateMachineOutput AWS API Documentation
1603
+ #
1604
+ class UpdateStateMachineOutput < Struct.new(
1605
+ :update_date)
1606
+ include Aws::Structure
1607
+ end
1608
+
1490
1609
  end
1491
1610
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-states
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.0
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2017-11-07 00:00:00.000000000 Z
11
+ date: 2017-11-15 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core