aws-sdk-states 1.54.0 → 1.55.0

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

@@ -268,6 +268,24 @@ module Aws::States
       include Aws::Structure
     end
 
+    # Updating or deleting a resource can cause an inconsistent state. This
+    # error occurs when there're concurrent requests for
+    # DeleteStateMachineVersion, PublishStateMachineVersion, or
+    # UpdateStateMachine with the `publish` parameter set to `true`.
+    #
+    # HTTP Status Code: 409
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ConflictException AWS API Documentation
+    #
+    class ConflictException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] name
     #   The name of the activity to create. This name must be unique for
     #   your Amazon Web Services account and region for 90 days. For more
@@ -336,6 +354,55 @@ module Aws::States
       include Aws::Structure
     end
 
+    # @!attribute [rw] description
+    #   A description for the state machine alias.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the state machine alias.
+    #
+    #   To avoid conflict with version ARNs, don't use an integer in the
+    #   name of the alias.
+    #   @return [String]
+    #
+    # @!attribute [rw] routing_configuration
+    #   The routing configuration of a state machine alias. The routing
+    #   configuration shifts execution traffic between two state machine
+    #   versions. `routingConfiguration` contains an array of
+    #   `RoutingConfig` objects that specify up to two state machine
+    #   versions. Step Functions then randomly choses which version to run
+    #   an execution with based on the weight assigned to each
+    #   `RoutingConfig`.
+    #   @return [Array<Types::RoutingConfigurationListItem>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/CreateStateMachineAliasInput AWS API Documentation
+    #
+    class CreateStateMachineAliasInput < Struct.new(
+      :description,
+      :name,
+      :routing_configuration)
+      SENSITIVE = [:description]
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] state_machine_alias_arn
+    #   The Amazon Resource Name (ARN) that identifies the created state
+    #   machine alias.
+    #   @return [String]
+    #
+    # @!attribute [rw] creation_date
+    #   The date the state machine alias was created.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/CreateStateMachineAliasOutput AWS API Documentation
+    #
+    class CreateStateMachineAliasOutput < Struct.new(
+      :state_machine_alias_arn,
+      :creation_date)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] name
     #   The name of the state machine.
     #
@@ -409,6 +476,18 @@ module Aws::States
     #   Selects whether X-Ray tracing is enabled.
     #   @return [Types::TracingConfiguration]
     #
+    # @!attribute [rw] publish
+    #   Set to `true` to publish the first version of the state machine
+    #   during creation. The default is `false`.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] version_description
+    #   Sets description about the state machine version. You can only set
+    #   the description if the `publish` parameter is set to `true`.
+    #   Otherwise, if you set `versionDescription`, but `publish` to
+    #   `false`, this API action throws `ValidationException`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/CreateStateMachineInput AWS API Documentation
     #
     class CreateStateMachineInput < Struct.new(
@@ -418,8 +497,10 @@ module Aws::States
       :type,
       :logging_configuration,
       :tags,
-      :tracing_configuration)
-      SENSITIVE = [:definition]
+      :tracing_configuration,
+      :publish,
+      :version_description)
+      SENSITIVE = [:definition, :version_description]
       include Aws::Structure
     end
 
@@ -432,11 +513,18 @@ module Aws::States
     #   The date the state machine is created.
     #   @return [Time]
     #
+    # @!attribute [rw] state_machine_version_arn
+    #   The Amazon Resource Name (ARN) that identifies the created state
+    #   machine version. If you do not set the `publish` parameter to
+    #   `true`, this field returns null value.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/CreateStateMachineOutput AWS API Documentation
     #
     class CreateStateMachineOutput < Struct.new(
       :state_machine_arn,
-      :creation_date)
+      :creation_date,
+      :state_machine_version_arn)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -457,6 +545,22 @@ module Aws::States
     #
     class DeleteActivityOutput < Aws::EmptyStructure; end
 
+    # @!attribute [rw] state_machine_alias_arn
+    #   The Amazon Resource Name (ARN) of the state machine alias to delete.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DeleteStateMachineAliasInput AWS API Documentation
+    #
+    class DeleteStateMachineAliasInput < Struct.new(
+      :state_machine_alias_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DeleteStateMachineAliasOutput AWS API Documentation
+    #
+    class DeleteStateMachineAliasOutput < Aws::EmptyStructure; end
+
     # @!attribute [rw] state_machine_arn
     #   The Amazon Resource Name (ARN) of the state machine to delete.
     #   @return [String]
@@ -473,6 +577,23 @@ module Aws::States
     #
     class DeleteStateMachineOutput < Aws::EmptyStructure; end
 
+    # @!attribute [rw] state_machine_version_arn
+    #   The Amazon Resource Name (ARN) of the state machine version to
+    #   delete.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DeleteStateMachineVersionInput AWS API Documentation
+    #
+    class DeleteStateMachineVersionInput < Struct.new(
+      :state_machine_version_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DeleteStateMachineVersionOutput AWS API Documentation
+    #
+    class DeleteStateMachineVersionOutput < Aws::EmptyStructure; end
+
     # @!attribute [rw] activity_arn
     #   The Amazon Resource Name (ARN) of the activity to describe.
     #   @return [String]
@@ -570,7 +691,7 @@ module Aws::States
     #   @return [Time]
     #
     # @!attribute [rw] stop_date
-    #   If the execution has already ended, the date the execution stopped.
+    #   If the execution ended, the date the execution stopped.
     #   @return [Time]
     #
     # @!attribute [rw] input
@@ -614,6 +735,27 @@ module Aws::States
     #   The cause string if the state machine execution failed.
     #   @return [String]
     #
+    # @!attribute [rw] state_machine_version_arn
+    #   The Amazon Resource Name (ARN) of the state machine version
+    #   associated with the execution. The version ARN is a combination of
+    #   state machine ARN and the version number separated by a colon (:).
+    #   For example, `stateMachineARN:1`.
+    #
+    #   If you start an execution from a `StartExecution` request without
+    #   specifying a state machine version or alias ARN, Step Functions
+    #   returns a null value.
+    #   @return [String]
+    #
+    # @!attribute [rw] state_machine_alias_arn
+    #   The Amazon Resource Name (ARN) of the state machine alias associated
+    #   with the execution. The alias ARN is a combination of state machine
+    #   ARN and the alias name separated by a colon (:). For example,
+    #   `stateMachineARN:PROD`.
+    #
+    #   If you start an execution from a `StartExecution` request with a
+    #   state machine version ARN, this field will be null.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeExecutionOutput AWS API Documentation
     #
     class DescribeExecutionOutput < Struct.new(
@@ -630,7 +772,9 @@ module Aws::States
       :trace_header,
       :map_run_arn,
       :error,
-      :cause)
+      :cause,
+      :state_machine_version_arn,
+      :state_machine_alias_arn)
       SENSITIVE = [:input, :output, :error, :cause]
       include Aws::Structure
     end
@@ -713,6 +857,58 @@ module Aws::States
       include Aws::Structure
     end
 
+    # @!attribute [rw] state_machine_alias_arn
+    #   The Amazon Resource Name (ARN) of the state machine alias.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineAliasInput AWS API Documentation
+    #
+    class DescribeStateMachineAliasInput < Struct.new(
+      :state_machine_alias_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] state_machine_alias_arn
+    #   The Amazon Resource Name (ARN) of the state machine alias.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the state machine alias.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   A description of the alias.
+    #   @return [String]
+    #
+    # @!attribute [rw] routing_configuration
+    #   The routing configuration of the alias.
+    #   @return [Array<Types::RoutingConfigurationListItem>]
+    #
+    # @!attribute [rw] creation_date
+    #   The date the state machine alias was created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] update_date
+    #   The date the state machine alias was last updated.
+    #
+    #   For a newly created state machine, this is the same as the creation
+    #   date.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineAliasOutput AWS API Documentation
+    #
+    class DescribeStateMachineAliasOutput < Struct.new(
+      :state_machine_alias_arn,
+      :name,
+      :description,
+      :routing_configuration,
+      :creation_date,
+      :update_date)
+      SENSITIVE = [:description]
+      include Aws::Structure
+    end
+
     # @!attribute [rw] execution_arn
     #   The Amazon Resource Name (ARN) of the execution you want state
     #   machine information for.
@@ -777,6 +973,16 @@ module Aws::States
     #   workflow execution that was started by a Distributed Map state.
     #   @return [String]
     #
+    # @!attribute [rw] revision_id
+    #   The revision identifier for the state machine. The first revision ID
+    #   when you create the state machine is null.
+    #
+    #   Use the state machine `revisionId` parameter to compare the revision
+    #   of a state machine with the configuration of the state machine used
+    #   for executions without performing a diff of the properties, such as
+    #   `definition` and `roleArn`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineForExecutionOutput AWS API Documentation
     #
     class DescribeStateMachineForExecutionOutput < Struct.new(
@@ -788,13 +994,20 @@ module Aws::States
       :logging_configuration,
       :tracing_configuration,
       :map_run_arn,
-      :label)
+      :label,
+      :revision_id)
       SENSITIVE = [:definition]
       include Aws::Structure
     end
 
     # @!attribute [rw] state_machine_arn
-    #   The Amazon Resource Name (ARN) of the state machine to describe.
+    #   The Amazon Resource Name (ARN) of the state machine for which you
+    #   want the information.
+    #
+    #   If you specify a state machine version ARN, this API returns details
+    #   about that version. The version ARN is a combination of state
+    #   machine ARN and the version number separated by a colon (:). For
+    #   example, `stateMachineARN:1`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineInput AWS API Documentation
@@ -807,6 +1020,11 @@ module Aws::States
 
     # @!attribute [rw] state_machine_arn
     #   The Amazon Resource Name (ARN) that identifies the state machine.
+    #
+    #   If you specified a state machine version ARN in your request, the
+    #   API returns the version ARN. The version ARN is a combination of
+    #   state machine ARN and the version number separated by a colon (:).
+    #   For example, `stateMachineARN:1`.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -853,6 +1071,9 @@ module Aws::States
     #
     # @!attribute [rw] creation_date
     #   The date the state machine is created.
+    #
+    #   For a state machine version, `creationDate` is the date the version
+    #   was created.
     #   @return [Time]
     #
     # @!attribute [rw] logging_configuration
@@ -870,6 +1091,18 @@ module Aws::States
     #   specified in input is a qualified state machine ARN.
     #   @return [String]
     #
+    # @!attribute [rw] revision_id
+    #   The revision identifier for the state machine.
+    #
+    #   Use the `revisionId` parameter to compare between versions of a
+    #   state machine configuration used for executions without performing a
+    #   diff of the properties, such as `definition` and `roleArn`.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The description of the state machine version.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/DescribeStateMachineOutput AWS API Documentation
     #
     class DescribeStateMachineOutput < Struct.new(
@@ -882,8 +1115,10 @@ module Aws::States
       :creation_date,
       :logging_configuration,
       :tracing_configuration,
-      :label)
-      SENSITIVE = [:definition]
+      :label,
+      :revision_id,
+      :description)
+      SENSITIVE = [:definition, :description]
       include Aws::Structure
     end
 
@@ -978,7 +1213,8 @@ module Aws::States
     #   @return [String]
     #
     # @!attribute [rw] state_machine_arn
-    #   The Amazon Resource Name (ARN) of the executed state machine.
+    #   The Amazon Resource Name (ARN) of the state machine that ran the
+    #   execution.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -1026,6 +1262,26 @@ module Aws::States
     #   `ListExecutions`, the `itemCount` field isn't returned.
     #   @return [Integer]
     #
+    # @!attribute [rw] state_machine_version_arn
+    #   The Amazon Resource Name (ARN) of the state machine version
+    #   associated with the execution.
+    #
+    #   If the state machine execution was started with an unqualified ARN,
+    #   it returns null.
+    #
+    #   If the execution was started using a `stateMachineAliasArn`, both
+    #   the `stateMachineAliasArn` and `stateMachineVersionArn` parameters
+    #   contain the respective values.
+    #   @return [String]
+    #
+    # @!attribute [rw] state_machine_alias_arn
+    #   The Amazon Resource Name (ARN) of the state machine alias used to
+    #   start an execution.
+    #
+    #   If the state machine execution was started with an unqualified ARN
+    #   or a version ARN, it returns null.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ExecutionListItem AWS API Documentation
     #
     class ExecutionListItem < Struct.new(
@@ -1036,7 +1292,9 @@ module Aws::States
       :start_date,
       :stop_date,
       :map_run_arn,
-      :item_count)
+      :item_count,
+      :state_machine_version_arn,
+      :state_machine_alias_arn)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1057,12 +1315,24 @@ module Aws::States
     #   Lambda tasks.
     #   @return [String]
     #
+    # @!attribute [rw] state_machine_alias_arn
+    #   The Amazon Resource Name (ARN) that identifies a state machine alias
+    #   used for starting the state machine execution.
+    #   @return [String]
+    #
+    # @!attribute [rw] state_machine_version_arn
+    #   The Amazon Resource Name (ARN) that identifies a state machine
+    #   version used for starting the state machine execution.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ExecutionStartedEventDetails AWS API Documentation
     #
     class ExecutionStartedEventDetails < Struct.new(
       :input,
       :input_details,
-      :role_arn)
+      :role_arn,
+      :state_machine_alias_arn,
+      :state_machine_version_arn)
       SENSITIVE = [:input]
       include Aws::Structure
     end
@@ -1739,6 +2009,15 @@ module Aws::States
     #
     #   You can specify either a `mapRunArn` or a `stateMachineArn`, but not
     #   both.
+    #
+    #   You can also return a list of executions associated with a specific
+    #   [alias][1] or [version][2], by specifying an alias ARN or a version
+    #   ARN in the `stateMachineArn` parameter.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-state-machine-alias.html
+    #   [2]: https://docs.aws.amazon.com/step-functions/latest/dg/concepts-state-machine-version.html
     #   @return [String]
     #
     # @!attribute [rw] status_filter
@@ -1872,6 +2151,120 @@ module Aws::States
       include Aws::Structure
     end
 
+    # @!attribute [rw] state_machine_arn
+    #   The Amazon Resource Name (ARN) of the state machine for which you
+    #   want to list aliases.
+    #
+    #   If you specify a state machine version ARN, this API returns a list
+    #   of aliases for that version.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   If `nextToken` is returned, there are more results available. The
+    #   value of `nextToken` is a unique pagination token for each page.
+    #   Make the call again using the returned token to retrieve the next
+    #   page. Keep all other arguments unchanged. Each pagination token
+    #   expires after 24 hours. Using an expired pagination token will
+    #   return an *HTTP 400 InvalidToken* error.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results that are returned per call. You can
+    #   use `nextToken` to obtain further pages of results. The default is
+    #   100 and the maximum allowed page size is 1000. A value of 0 uses the
+    #   default.
+    #
+    #   This is only an upper limit. The actual number of results returned
+    #   per call might be fewer than the specified maximum.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ListStateMachineAliasesInput AWS API Documentation
+    #
+    class ListStateMachineAliasesInput < Struct.new(
+      :state_machine_arn,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] state_machine_aliases
+    #   Aliases for the state machine.
+    #   @return [Array<Types::StateMachineAliasListItem>]
+    #
+    # @!attribute [rw] next_token
+    #   If `nextToken` is returned, there are more results available. The
+    #   value of `nextToken` is a unique pagination token for each page.
+    #   Make the call again using the returned token to retrieve the next
+    #   page. Keep all other arguments unchanged. Each pagination token
+    #   expires after 24 hours. Using an expired pagination token will
+    #   return an *HTTP 400 InvalidToken* error.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ListStateMachineAliasesOutput AWS API Documentation
+    #
+    class ListStateMachineAliasesOutput < Struct.new(
+      :state_machine_aliases,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] state_machine_arn
+    #   The Amazon Resource Name (ARN) of the state machine.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   If `nextToken` is returned, there are more results available. The
+    #   value of `nextToken` is a unique pagination token for each page.
+    #   Make the call again using the returned token to retrieve the next
+    #   page. Keep all other arguments unchanged. Each pagination token
+    #   expires after 24 hours. Using an expired pagination token will
+    #   return an *HTTP 400 InvalidToken* error.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results that are returned per call. You can
+    #   use `nextToken` to obtain further pages of results. The default is
+    #   100 and the maximum allowed page size is 1000. A value of 0 uses the
+    #   default.
+    #
+    #   This is only an upper limit. The actual number of results returned
+    #   per call might be fewer than the specified maximum.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ListStateMachineVersionsInput AWS API Documentation
+    #
+    class ListStateMachineVersionsInput < Struct.new(
+      :state_machine_arn,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] state_machine_versions
+    #   Versions for the state machine.
+    #   @return [Array<Types::StateMachineVersionListItem>]
+    #
+    # @!attribute [rw] next_token
+    #   If `nextToken` is returned, there are more results available. The
+    #   value of `nextToken` is a unique pagination token for each page.
+    #   Make the call again using the returned token to retrieve the next
+    #   page. Keep all other arguments unchanged. Each pagination token
+    #   expires after 24 hours. Using an expired pagination token will
+    #   return an *HTTP 400 InvalidToken* error.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ListStateMachineVersionsOutput AWS API Documentation
+    #
+    class ListStateMachineVersionsOutput < Struct.new(
+      :state_machine_versions,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] max_results
     #   The maximum number of results that are returned per call. You can
     #   use `nextToken` to obtain further pages of results. The default is
@@ -2236,8 +2629,61 @@ module Aws::States
       include Aws::Structure
     end
 
-    # Could not find the referenced resource. Only state machine and
-    # activity ARNs are supported.
+    # @!attribute [rw] state_machine_arn
+    #   The Amazon Resource Name (ARN) of the state machine.
+    #   @return [String]
+    #
+    # @!attribute [rw] revision_id
+    #   Only publish the state machine version if the current state
+    #   machine's revision ID matches the specified ID.
+    #
+    #   Use this option to avoid publishing a version if the state machine
+    #   changed since you last updated it. If the specified revision ID
+    #   doesn't match the state machine's current revision ID, the API
+    #   returns `ConflictException`.
+    #
+    #   <note markdown="1"> To specify an initial revision ID for a state machine with no
+    #   revision ID assigned, specify the string `INITIAL` for the
+    #   `revisionId` parameter. For example, you can specify a `revisionID`
+    #   of `INITIAL` when you create a state machine using the
+    #   CreateStateMachine API action.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   An optional description of the state machine version.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/PublishStateMachineVersionInput AWS API Documentation
+    #
+    class PublishStateMachineVersionInput < Struct.new(
+      :state_machine_arn,
+      :revision_id,
+      :description)
+      SENSITIVE = [:description]
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] creation_date
+    #   The date the version was created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] state_machine_version_arn
+    #   The Amazon Resource Name (ARN) (ARN) that identifies the state
+    #   machine version.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/PublishStateMachineVersionOutput AWS API Documentation
+    #
+    class PublishStateMachineVersionOutput < Struct.new(
+      :creation_date,
+      :state_machine_version_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Could not find the referenced resource.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -2254,6 +2700,34 @@ module Aws::States
       include Aws::Structure
     end
 
+    # Contains details about the routing configuration of a state machine
+    # alias. In a routing configuration, you define an array of objects that
+    # specify up to two state machine versions. You also specify the
+    # percentage of traffic to be routed to each version.
+    #
+    # @!attribute [rw] state_machine_version_arn
+    #   The Amazon Resource Name (ARN) that identifies one or two state
+    #   machine versions defined in the routing configuration.
+    #
+    #   If you specify the ARN of a second version, it must belong to the
+    #   same state machine as the first version.
+    #   @return [String]
+    #
+    # @!attribute [rw] weight
+    #   The percentage of traffic you want to route to the second state
+    #   machine version. The sum of the weights in the routing configuration
+    #   must be equal to 100.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/RoutingConfigurationListItem AWS API Documentation
+    #
+    class RoutingConfigurationListItem < Struct.new(
+      :state_machine_version_arn,
+      :weight)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] task_token
     #   The token that represents this task. Task tokens are generated by
     #   Step Functions when tasks are assigned to a worker, or in the
@@ -2339,14 +2813,63 @@ module Aws::States
     #
     class SendTaskSuccessOutput < Aws::EmptyStructure; end
 
+    # The request would cause a service quota to be exceeded.
+    #
+    # HTTP Status Code: 402
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/ServiceQuotaExceededException AWS API Documentation
+    #
+    class ServiceQuotaExceededException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] state_machine_arn
     #   The Amazon Resource Name (ARN) of the state machine to execute.
+    #
+    #   The `stateMachineArn` parameter accepts one of the following inputs:
+    #
+    #   * **An unqualified state machine ARN** – Refers to a state machine
+    #     ARN that isn't qualified with a version or alias ARN. The
+    #     following is an example of an unqualified state machine ARN.
+    #
+    #     `arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine>`
+    #
+    #     Step Functions doesn't associate state machine executions that
+    #     you start with an unqualified ARN with a version. This is true
+    #     even if that version uses the same revision that the execution
+    #     used.
+    #
+    #   * **A state machine version ARN** – Refers to a version ARN, which
+    #     is a combination of state machine ARN and the version number
+    #     separated by a colon (:). The following is an example of the ARN
+    #     for version 10.
+    #
+    #     `arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine>:10`
+    #
+    #     Step Functions doesn't associate executions that you start with a
+    #     version ARN with any aliases that point to that version.
+    #
+    #   * **A state machine alias ARN** – Refers to an alias ARN, which is a
+    #     combination of state machine ARN and the alias name separated by a
+    #     colon (:). The following is an example of the ARN for an alias
+    #     named `PROD`.
+    #
+    #     `arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine:PROD>`
+    #
+    #     Step Functions associates executions that you start with an alias
+    #     ARN with that alias and the state machine version used for that
+    #     execution.
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The name of the execution. This name must be unique for your Amazon
-    #   Web Services account, region, and state machine for 90 days. For
-    #   more information, see [ Limits Related to State Machine
+    #   Optional name of the execution. This name must be unique for your
+    #   Amazon Web Services account, Region, and state machine for 90 days.
+    #   For more information, see [ Limits Related to State Machine
     #   Executions][1] in the *Step Functions Developer Guide*.
     #
     #   A name must *not* contain:
@@ -2608,6 +3131,28 @@ module Aws::States
       include Aws::Structure
     end
 
+    # Contains details about a specific state machine alias.
+    #
+    # @!attribute [rw] state_machine_alias_arn
+    #   The Amazon Resource Name (ARN) that identifies a state machine
+    #   alias. The alias ARN is a combination of state machine ARN and the
+    #   alias name separated by a colon (:). For example,
+    #   `stateMachineARN:PROD`.
+    #   @return [String]
+    #
+    # @!attribute [rw] creation_date
+    #   The creation date of a state machine alias.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/StateMachineAliasListItem AWS API Documentation
+    #
+    class StateMachineAliasListItem < Struct.new(
+      :state_machine_alias_arn,
+      :creation_date)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A state machine with the same name but a different definition or role
     # ARN already exists.
     #
@@ -2716,6 +3261,28 @@ module Aws::States
       include Aws::Structure
     end
 
+    # Contains details about a specific state machine version.
+    #
+    # @!attribute [rw] state_machine_version_arn
+    #   The Amazon Resource Name (ARN) that identifies a state machine
+    #   version. The version ARN is a combination of state machine ARN and
+    #   the version number separated by a colon (:). For example,
+    #   `stateMachineARN:1`.
+    #   @return [String]
+    #
+    # @!attribute [rw] creation_date
+    #   The creation date of a state machine version.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/StateMachineVersionListItem AWS API Documentation
+    #
+    class StateMachineVersionListItem < Struct.new(
+      :state_machine_version_arn,
+      :creation_date)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] execution_arn
     #   The Amazon Resource Name (ARN) of the execution to stop.
     #   @return [String]
@@ -3183,6 +3750,43 @@ module Aws::States
     #
     class UpdateMapRunOutput < Aws::EmptyStructure; end
 
+    # @!attribute [rw] state_machine_alias_arn
+    #   The Amazon Resource Name (ARN) of the state machine alias.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   A description of the state machine alias.
+    #   @return [String]
+    #
+    # @!attribute [rw] routing_configuration
+    #   The routing configuration of the state machine alias.
+    #
+    #   An array of `RoutingConfig` objects that specifies up to two state
+    #   machine versions that the alias starts executions for.
+    #   @return [Array<Types::RoutingConfigurationListItem>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateStateMachineAliasInput AWS API Documentation
+    #
+    class UpdateStateMachineAliasInput < Struct.new(
+      :state_machine_alias_arn,
+      :description,
+      :routing_configuration)
+      SENSITIVE = [:description]
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] update_date
+    #   The date and time the state machine alias was updated.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateStateMachineAliasOutput AWS API Documentation
+    #
+    class UpdateStateMachineAliasOutput < Struct.new(
+      :update_date)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] state_machine_arn
     #   The Amazon Resource Name (ARN) of the state machine.
     #   @return [String]
@@ -3201,7 +3805,7 @@ module Aws::States
     #   @return [String]
     #
     # @!attribute [rw] logging_configuration
-    #   The `LoggingConfiguration` data type is used to set CloudWatch Logs
+    #   Use the `LoggingConfiguration` data type to set CloudWatch Logs
     #   options.
     #   @return [Types::LoggingConfiguration]
     #
@@ -3209,6 +3813,19 @@ module Aws::States
     #   Selects whether X-Ray tracing is enabled.
     #   @return [Types::TracingConfiguration]
     #
+    # @!attribute [rw] publish
+    #   Specifies whether the state machine version is published. The
+    #   default is `false`. To publish a version after updating the state
+    #   machine, set `publish` to `true`.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] version_description
+    #   An optional description of the state machine version to publish.
+    #
+    #   You can only specify the `versionDescription` parameter if you've
+    #   set `publish` to `true`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateStateMachineInput AWS API Documentation
     #
     class UpdateStateMachineInput < Struct.new(
@@ -3216,8 +3833,10 @@ module Aws::States
       :definition,
       :role_arn,
       :logging_configuration,
-      :tracing_configuration)
-      SENSITIVE = [:definition]
+      :tracing_configuration,
+      :publish,
+      :version_description)
+      SENSITIVE = [:definition, :version_description]
       include Aws::Structure
     end
 
@@ -3225,10 +3844,24 @@ module Aws::States
     #   The date and time the state machine was updated.
     #   @return [Time]
     #
+    # @!attribute [rw] revision_id
+    #   The revision identifier for the updated state machine.
+    #   @return [String]
+    #
+    # @!attribute [rw] state_machine_version_arn
+    #   The Amazon Resource Name (ARN) of the published state machine
+    #   version.
+    #
+    #   If the `publish` parameter isn't set to `true`, this field returns
+    #   null.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/states-2016-11-23/UpdateStateMachineOutput AWS API Documentation
     #
     class UpdateStateMachineOutput < Struct.new(
-      :update_date)
+      :update_date,
+      :revision_id,
+      :state_machine_version_arn)
       SENSITIVE = []
       include Aws::Structure
     end