aws-sdk-states 1.1.0 → 1.2.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
  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