@aws-sdk/client-sfn 3.357.0 → 3.358.0

package/dist-types/models/models_0.d.ts

@@ -285,6 +285,19 @@ export declare class TooManyTags extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<TooManyTags, __BaseException>);
 }
+/**
+ * @public
+ * <p>Updating or deleting a resource can cause an inconsistent state. This error occurs when there're concurrent requests for <a>DeleteStateMachineVersion</a>, <a>PublishStateMachineVersion</a>, or <a>UpdateStateMachine</a> with the <code>publish</code> parameter set to <code>true</code>.</p>
+ *          <p>HTTP Status Code: 409</p>
+ */
+export declare class ConflictException extends __BaseException {
+    readonly name: "ConflictException";
+    readonly $fault: "client";
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
+}
 /**
  * @public
  * <p></p>
@@ -432,6 +445,14 @@ export interface CreateStateMachineInput {
      * <p>Selects whether X-Ray tracing is enabled.</p>
      */
     tracingConfiguration?: TracingConfiguration;
+    /**
+     * <p>Set to <code>true</code> to publish the first version of the state machine during creation. The default is <code>false</code>.</p>
+     */
+    publish?: boolean;
+    /**
+     * <p>Sets description about the state machine version. You can only set the description if the <code>publish</code> parameter is set to <code>true</code>. Otherwise, if you set <code>versionDescription</code>, but <code>publish</code> to <code>false</code>, this API action throws <code>ValidationException</code>.</p>
+     */
+    versionDescription?: string;
 }
 /**
  * @public
@@ -445,6 +466,10 @@ export interface CreateStateMachineOutput {
      * <p>The date the state machine is created.</p>
      */
     creationDate: Date | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) that identifies the created state machine version. If you do not set the <code>publish</code> parameter to <code>true</code>, this field returns null value.</p>
+     */
+    stateMachineVersionArn?: string;
 }
 /**
  * @public
@@ -545,6 +570,116 @@ export declare class StateMachineTypeNotSupported extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<StateMachineTypeNotSupported, __BaseException>);
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const ValidationExceptionReason: {
+    readonly API_DOES_NOT_SUPPORT_LABELED_ARNS: "API_DOES_NOT_SUPPORT_LABELED_ARNS";
+    readonly CANNOT_UPDATE_COMPLETED_MAP_RUN: "CANNOT_UPDATE_COMPLETED_MAP_RUN";
+    readonly INVALID_ROUTING_CONFIGURATION: "INVALID_ROUTING_CONFIGURATION";
+    readonly MISSING_REQUIRED_PARAMETER: "MISSING_REQUIRED_PARAMETER";
+};
+/**
+ * @public
+ */
+export type ValidationExceptionReason = (typeof ValidationExceptionReason)[keyof typeof ValidationExceptionReason];
+/**
+ * @public
+ * <p>The input does not satisfy the constraints specified by an Amazon Web Services service.</p>
+ */
+export declare class ValidationException extends __BaseException {
+    readonly name: "ValidationException";
+    readonly $fault: "client";
+    /**
+     * <p>The input does not satisfy the constraints specified by an Amazon Web Services service.</p>
+     */
+    reason?: ValidationExceptionReason | string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
+}
+/**
+ * @public
+ * <p>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.</p>
+ */
+export interface RoutingConfigurationListItem {
+    /**
+     * <p>The Amazon Resource Name (ARN) that identifies one or two state machine versions defined in the routing configuration.</p>
+     *          <p>If you specify the ARN of a second version, it must belong to the same state machine as the first version.</p>
+     */
+    stateMachineVersionArn: string | undefined;
+    /**
+     * <p>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.</p>
+     */
+    weight: number | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateStateMachineAliasInput {
+    /**
+     * <p>A description for the state machine alias.</p>
+     */
+    description?: string;
+    /**
+     * <p>The name of the state machine alias.</p>
+     *          <p>To avoid conflict with version ARNs, don't use an integer in the name of the alias.</p>
+     */
+    name: string | undefined;
+    /**
+     * <p>The routing configuration of a state machine alias. The routing configuration shifts
+     *       execution traffic between two state machine versions. <code>routingConfiguration</code>
+     *       contains an array of <code>RoutingConfig</code> 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 <code>RoutingConfig</code>.</p>
+     */
+    routingConfiguration: RoutingConfigurationListItem[] | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateStateMachineAliasOutput {
+    /**
+     * <p>The Amazon Resource Name (ARN) that identifies the created state machine alias.</p>
+     */
+    stateMachineAliasArn: string | undefined;
+    /**
+     * <p>The date the state machine alias was created.</p>
+     */
+    creationDate: Date | undefined;
+}
+/**
+ * @public
+ * <p>Could not find the referenced resource.</p>
+ */
+export declare class ResourceNotFound extends __BaseException {
+    readonly name: "ResourceNotFound";
+    readonly $fault: "client";
+    resourceName?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ResourceNotFound, __BaseException>);
+}
+/**
+ * @public
+ * <p>The request would cause a service quota to be exceeded.</p>
+ *          <p>HTTP Status Code: 402</p>
+ */
+export declare class ServiceQuotaExceededException extends __BaseException {
+    readonly name: "ServiceQuotaExceededException";
+    readonly $fault: "client";
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
+}
 /**
  * @public
  */
@@ -575,32 +710,31 @@ export interface DeleteStateMachineOutput {
 }
 /**
  * @public
- * @enum
  */
-export declare const ValidationExceptionReason: {
-    readonly API_DOES_NOT_SUPPORT_LABELED_ARNS: "API_DOES_NOT_SUPPORT_LABELED_ARNS";
-    readonly CANNOT_UPDATE_COMPLETED_MAP_RUN: "CANNOT_UPDATE_COMPLETED_MAP_RUN";
-    readonly MISSING_REQUIRED_PARAMETER: "MISSING_REQUIRED_PARAMETER";
-};
+export interface DeleteStateMachineAliasInput {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the state machine alias to delete.</p>
+     */
+    stateMachineAliasArn: string | undefined;
+}
 /**
  * @public
  */
-export type ValidationExceptionReason = (typeof ValidationExceptionReason)[keyof typeof ValidationExceptionReason];
+export interface DeleteStateMachineAliasOutput {
+}
 /**
  * @public
- * <p>The input does not satisfy the constraints specified by an Amazon Web Services service.</p>
  */
-export declare class ValidationException extends __BaseException {
-    readonly name: "ValidationException";
-    readonly $fault: "client";
-    /**
-     * <p>The input does not satisfy the constraints specified by an Amazon Web Services service.</p>
-     */
-    reason?: ValidationExceptionReason | string;
+export interface DeleteStateMachineVersionInput {
     /**
-     * @internal
+     * <p>The Amazon Resource Name (ARN) of the state machine version to delete.</p>
      */
-    constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
+    stateMachineVersionArn: string | undefined;
+}
+/**
+ * @public
+ */
+export interface DeleteStateMachineVersionOutput {
 }
 /**
  * @public
@@ -732,7 +866,7 @@ export interface DescribeExecutionOutput {
      */
     startDate: Date | undefined;
     /**
-     * <p>If the execution has already ended, the date the execution stopped.</p>
+     * <p>If the execution ended, the date the execution stopped.</p>
      */
     stopDate?: Date;
     /**
@@ -771,6 +905,18 @@ export interface DescribeExecutionOutput {
      * <p>The cause string if the state machine execution failed.</p>
      */
     cause?: string;
+    /**
+     * <p>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, <code>stateMachineARN:1</code>.</p>
+     *          <p>If you start an execution from a <code>StartExecution</code> request without specifying a
+     *       state machine version or alias ARN, Step Functions returns a null value.</p>
+     */
+    stateMachineVersionArn?: string;
+    /**
+     * <p>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, <code>stateMachineARN:PROD</code>.</p>
+     *          <p>If you start an execution from a <code>StartExecution</code> request with a
+     *       state machine version ARN, this field will be null.</p>
+     */
+    stateMachineAliasArn?: string;
 }
 /**
  * @public
@@ -928,26 +1074,13 @@ export interface DescribeMapRunOutput {
      */
     executionCounts: MapRunExecutionCounts | undefined;
 }
-/**
- * @public
- * <p>Could not find the referenced resource. Only state machine and activity ARNs are
- *       supported.</p>
- */
-export declare class ResourceNotFound extends __BaseException {
-    readonly name: "ResourceNotFound";
-    readonly $fault: "client";
-    resourceName?: string;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<ResourceNotFound, __BaseException>);
-}
 /**
  * @public
  */
 export interface DescribeStateMachineInput {
     /**
-     * <p>The Amazon Resource Name (ARN) of the state machine to describe.</p>
+     * <p>The Amazon Resource Name (ARN) of the state machine for which you want the information.</p>
+     *          <p>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, <code>stateMachineARN:1</code>.</p>
      */
     stateMachineArn: string | undefined;
 }
@@ -969,6 +1102,7 @@ export type StateMachineStatus = (typeof StateMachineStatus)[keyof typeof StateM
 export interface DescribeStateMachineOutput {
     /**
      * <p>The Amazon Resource Name (ARN) that identifies the state machine.</p>
+     *          <p>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, <code>stateMachineARN:1</code>.</p>
      */
     stateMachineArn: string | undefined;
     /**
@@ -1017,6 +1151,7 @@ export interface DescribeStateMachineOutput {
     type: StateMachineType | string | undefined;
     /**
      * <p>The date the state machine is created.</p>
+     *          <p>For a state machine version, <code>creationDate</code> is the date the version was created.</p>
      */
     creationDate: Date | undefined;
     /**
@@ -1032,6 +1167,17 @@ export interface DescribeStateMachineOutput {
      * <p>A user-defined or an auto-generated string that identifies a <code>Map</code> state. This parameter is present only if the <code>stateMachineArn</code> specified in input is a qualified state machine ARN.</p>
      */
     label?: string;
+    /**
+     * <p>The revision identifier for the state machine.</p>
+     *          <p>Use the <code>revisionId</code> parameter to compare between versions of a state machine
+     *       configuration used for executions without performing a diff of the properties, such as
+     *         <code>definition</code> and <code>roleArn</code>.</p>
+     */
+    revisionId?: string;
+    /**
+     * <p>The description of the state machine version.</p>
+     */
+    description?: string;
 }
 /**
  * @public
@@ -1045,6 +1191,45 @@ export declare class StateMachineDoesNotExist extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<StateMachineDoesNotExist, __BaseException>);
 }
+/**
+ * @public
+ */
+export interface DescribeStateMachineAliasInput {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the state machine alias.</p>
+     */
+    stateMachineAliasArn: string | undefined;
+}
+/**
+ * @public
+ */
+export interface DescribeStateMachineAliasOutput {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the state machine alias.</p>
+     */
+    stateMachineAliasArn?: string;
+    /**
+     * <p>The name of the state machine alias.</p>
+     */
+    name?: string;
+    /**
+     * <p>A description of the alias.</p>
+     */
+    description?: string;
+    /**
+     * <p>The routing configuration of the alias.</p>
+     */
+    routingConfiguration?: RoutingConfigurationListItem[];
+    /**
+     * <p>The date the state machine alias was created.</p>
+     */
+    creationDate?: Date;
+    /**
+     * <p>The date the state machine alias was last updated.</p>
+     *          <p>For a newly created state machine, this is the same as the creation date.</p>
+     */
+    updateDate?: Date;
+}
 /**
  * @public
  */
@@ -1096,6 +1281,11 @@ export interface DescribeStateMachineForExecutionOutput {
      * <p>A user-defined or an auto-generated string that identifies a <code>Map</code> state. This field is returned only if the <code>executionArn</code> is a child workflow execution that was started by a Distributed Map state.</p>
      */
     label?: string;
+    /**
+     * <p>The revision identifier for the state machine. The first revision ID when you create the state machine is null.</p>
+     *          <p>Use the state machine <code>revisionId</code> 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 <code>definition</code> and <code>roleArn</code>.</p>
+     */
+    revisionId?: string;
 }
 /**
  * @public
@@ -1202,6 +1392,14 @@ export interface ExecutionStartedEventDetails {
      * <p>The Amazon Resource Name (ARN) of the IAM role used for executing Lambda tasks.</p>
      */
     roleArn?: string;
+    /**
+     * <p>The Amazon Resource Name (ARN) that identifies a state machine alias used for starting the state machine execution.</p>
+     */
+    stateMachineAliasArn?: string;
+    /**
+     * <p>The Amazon Resource Name (ARN) that identifies a state machine version used for starting the state machine execution.</p>
+     */
+    stateMachineVersionArn?: string;
 }
 /**
  * @public
@@ -1920,6 +2118,7 @@ export interface ListExecutionsInput {
     /**
      * <p>The Amazon Resource Name (ARN) of the state machine whose executions is listed.</p>
      *          <p>You can specify either a <code>mapRunArn</code> or a <code>stateMachineArn</code>, but not both.</p>
+     *          <p>You can also return a list of executions associated with a specific <a href="https://docs.aws.amazon.com/step-functions/latest/dg/concepts-state-machine-alias.html">alias</a> or <a href="https://docs.aws.amazon.com/step-functions/latest/dg/concepts-state-machine-version.html">version</a>, by specifying an alias ARN or a version ARN in the <code>stateMachineArn</code> parameter.</p>
      */
     stateMachineArn?: string;
     /**
@@ -1954,7 +2153,7 @@ export interface ExecutionListItem {
      */
     executionArn: string | undefined;
     /**
-     * <p>The Amazon Resource Name (ARN) of the executed state machine.</p>
+     * <p>The Amazon Resource Name (ARN) of the state machine that ran the execution.</p>
      */
     stateMachineArn: string | undefined;
     /**
@@ -2003,6 +2202,17 @@ export interface ExecutionListItem {
      * <p>The total number of items processed in a child workflow execution. This field is returned only if <code>mapRunArn</code> was specified in the <code>ListExecutions</code> API action. If <code>stateMachineArn</code> was specified in <code>ListExecutions</code>, the <code>itemCount</code> field isn't returned.</p>
      */
     itemCount?: number;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the state machine version associated with the execution.</p>
+     *          <p>If the state machine execution was started with an unqualified ARN, it returns null.</p>
+     *          <p>If the execution was started using a <code>stateMachineAliasArn</code>, both the <code>stateMachineAliasArn</code> and <code>stateMachineVersionArn</code> parameters contain the respective values.</p>
+     */
+    stateMachineVersionArn?: string;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the state machine alias used to start an execution.</p>
+     *          <p>If the state machine execution was started with an unqualified ARN or a version ARN, it returns null.</p>
+     */
+    stateMachineAliasArn?: string;
 }
 /**
  * @public
@@ -2078,6 +2288,55 @@ export interface ListMapRunsOutput {
      */
     nextToken?: string;
 }
+/**
+ * @public
+ */
+export interface ListStateMachineAliasesInput {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the state machine for which you want to list aliases.</p>
+     *          <p>If you specify a state machine version ARN, this API returns a list of aliases for that version.</p>
+     */
+    stateMachineArn: string | undefined;
+    /**
+     * <p>If <code>nextToken</code> is returned, there are more results available. The value of <code>nextToken</code> 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 <i>HTTP 400 InvalidToken</i> error.</p>
+     */
+    nextToken?: string;
+    /**
+     * <p>The maximum number of results that are returned per call. You can use <code>nextToken</code> 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.</p>
+     *          <p>This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.</p>
+     */
+    maxResults?: number;
+}
+/**
+ * @public
+ * <p>Contains details about a specific state machine alias.</p>
+ */
+export interface StateMachineAliasListItem {
+    /**
+     * <p>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, <code>stateMachineARN:PROD</code>.</p>
+     */
+    stateMachineAliasArn: string | undefined;
+    /**
+     * <p>The creation date of a state machine alias.</p>
+     */
+    creationDate: Date | undefined;
+}
+/**
+ * @public
+ */
+export interface ListStateMachineAliasesOutput {
+    /**
+     * <p>Aliases for the state machine.</p>
+     */
+    stateMachineAliases: StateMachineAliasListItem[] | undefined;
+    /**
+     * <p>If <code>nextToken</code> is returned, there are more results available. The value of <code>nextToken</code> 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 <i>HTTP 400 InvalidToken</i> error.</p>
+     */
+    nextToken?: string;
+}
 /**
  * @public
  */
@@ -2149,6 +2408,54 @@ export interface ListStateMachinesOutput {
      */
     nextToken?: string;
 }
+/**
+ * @public
+ */
+export interface ListStateMachineVersionsInput {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the state machine.</p>
+     */
+    stateMachineArn: string | undefined;
+    /**
+     * <p>If <code>nextToken</code> is returned, there are more results available. The value of <code>nextToken</code> 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 <i>HTTP 400 InvalidToken</i> error.</p>
+     */
+    nextToken?: string;
+    /**
+     * <p>The maximum number of results that are returned per call. You can use <code>nextToken</code> 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.</p>
+     *          <p>This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum.</p>
+     */
+    maxResults?: number;
+}
+/**
+ * @public
+ * <p>Contains details about a specific state machine version.</p>
+ */
+export interface StateMachineVersionListItem {
+    /**
+     * <p>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, <code>stateMachineARN:1</code>.</p>
+     */
+    stateMachineVersionArn: string | undefined;
+    /**
+     * <p>The creation date of a state machine version.</p>
+     */
+    creationDate: Date | undefined;
+}
+/**
+ * @public
+ */
+export interface ListStateMachineVersionsOutput {
+    /**
+     * <p>Versions for the state machine.</p>
+     */
+    stateMachineVersions: StateMachineVersionListItem[] | undefined;
+    /**
+     * <p>If <code>nextToken</code> is returned, there are more results available. The value of <code>nextToken</code> 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 <i>HTTP 400 InvalidToken</i> error.</p>
+     */
+    nextToken?: string;
+}
 /**
  * @public
  */
@@ -2167,6 +2474,45 @@ export interface ListTagsForResourceOutput {
      */
     tags?: Tag[];
 }
+/**
+ * @public
+ */
+export interface PublishStateMachineVersionInput {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the state machine.</p>
+     */
+    stateMachineArn: string | undefined;
+    /**
+     * <p>Only publish the state machine version if the current state machine's revision ID matches the specified ID.</p>
+     *          <p>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 <code>ConflictException</code>.</p>
+     *          <note>
+     *             <p>To specify an initial revision ID for a state machine with no revision ID assigned,
+     *         specify the string <code>INITIAL</code> for the <code>revisionId</code> parameter. For
+     *         example, you can specify a <code>revisionID</code> of <code>INITIAL</code> when you create a
+     *         state machine using the <a>CreateStateMachine</a> API action.</p>
+     *          </note>
+     */
+    revisionId?: string;
+    /**
+     * <p>An optional description of the state machine version.</p>
+     */
+    description?: string;
+}
+/**
+ * @public
+ */
+export interface PublishStateMachineVersionOutput {
+    /**
+     * <p>The date the version was created.</p>
+     */
+    creationDate: Date | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) (ARN) that identifies the state machine version.</p>
+     */
+    stateMachineVersionArn: string | undefined;
+}
 /**
  * @public
  */
@@ -2309,10 +2655,40 @@ export declare class InvalidExecutionInput extends __BaseException {
 export interface StartExecutionInput {
     /**
      * <p>The Amazon Resource Name (ARN) of the state machine to execute.</p>
+     *          <p>The <code>stateMachineArn</code> parameter accepts one of the following inputs:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <b>An unqualified state machine ARN</b> – 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.</p>
+     *                <p>
+     *                   <code>arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine></code>
+     *                </p>
+     *                <p>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.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <b>A state machine version ARN</b> – 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. </p>
+     *                <p>
+     *                   <code>arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine>:10</code>
+     *                </p>
+     *                <p>Step Functions doesn't associate executions that you start with a version ARN with any aliases that point to that version.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <b>A state machine alias ARN</b> – 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 <code>PROD</code>.</p>
+     *                <p>
+     *                   <code>arn:<partition>:states:<region>:<account-id>:stateMachine:<myStateMachine:PROD></code>
+     *                </p>
+     *                <p>Step Functions associates executions
+     *           that you start with an alias ARN with that alias and the state machine version used for
+     *           that execution.</p>
+     *             </li>
+     *          </ul>
      */
     stateMachineArn: string | undefined;
     /**
-     * <p>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,
+     * <p>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 <a href="https://docs.aws.amazon.com/step-functions/latest/dg/limits.html#service-limits-state-machine-executions">
      *     Limits Related to State Machine Executions</a> in the <i>Step Functions Developer Guide</i>.</p>
      *          <p>A name must <i>not</i> contain:</p>
@@ -2614,7 +2990,7 @@ export interface UpdateStateMachineInput {
      */
     roleArn?: string;
     /**
-     * <p>The <code>LoggingConfiguration</code> data type is used to set CloudWatch Logs
+     * <p>Use the <code>LoggingConfiguration</code> data type to set CloudWatch Logs
      *       options.</p>
      */
     loggingConfiguration?: LoggingConfiguration;
@@ -2622,6 +2998,17 @@ export interface UpdateStateMachineInput {
      * <p>Selects whether X-Ray tracing is enabled.</p>
      */
     tracingConfiguration?: TracingConfiguration;
+    /**
+     * <p>Specifies whether the state machine version is published. The default is
+     *         <code>false</code>. To publish a version after updating the state machine, set
+     *         <code>publish</code> to <code>true</code>.</p>
+     */
+    publish?: boolean;
+    /**
+     * <p>An optional description of the state machine version to publish.</p>
+     *          <p>You can only specify the <code>versionDescription</code> parameter if you've set <code>publish</code> to <code>true</code>.</p>
+     */
+    versionDescription?: string;
 }
 /**
  * @public
@@ -2631,6 +3018,42 @@ export interface UpdateStateMachineOutput {
      * <p>The date and time the state machine was updated.</p>
      */
     updateDate: Date | undefined;
+    /**
+     * <p>The revision identifier for the updated state machine.</p>
+     */
+    revisionId?: string;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the published state machine version.</p>
+     *          <p>If the <code>publish</code> parameter isn't set to <code>true</code>, this field returns null.</p>
+     */
+    stateMachineVersionArn?: string;
+}
+/**
+ * @public
+ */
+export interface UpdateStateMachineAliasInput {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the state machine alias.</p>
+     */
+    stateMachineAliasArn: string | undefined;
+    /**
+     * <p>A description of the state machine alias.</p>
+     */
+    description?: string;
+    /**
+     * <p>The routing configuration of the state machine alias.</p>
+     *          <p>An array of <code>RoutingConfig</code> objects that specifies up to two state machine versions that the alias starts executions for.</p>
+     */
+    routingConfiguration?: RoutingConfigurationListItem[];
+}
+/**
+ * @public
+ */
+export interface UpdateStateMachineAliasOutput {
+    /**
+     * <p>The date and time the state machine alias was updated.</p>
+     */
+    updateDate: Date | undefined;
 }
 /**
  * @internal
@@ -2656,6 +3079,10 @@ export declare const ActivityTimedOutEventDetailsFilterSensitiveLog: (obj: Activ
  * @internal
  */
 export declare const CreateStateMachineInputFilterSensitiveLog: (obj: CreateStateMachineInput) => any;
+/**
+ * @internal
+ */
+export declare const CreateStateMachineAliasInputFilterSensitiveLog: (obj: CreateStateMachineAliasInput) => any;
 /**
  * @internal
  */
@@ -2664,6 +3091,10 @@ export declare const DescribeExecutionOutputFilterSensitiveLog: (obj: DescribeEx
  * @internal
  */
 export declare const DescribeStateMachineOutputFilterSensitiveLog: (obj: DescribeStateMachineOutput) => any;
+/**
+ * @internal
+ */
+export declare const DescribeStateMachineAliasOutputFilterSensitiveLog: (obj: DescribeStateMachineAliasOutput) => any;
 /**
  * @internal
  */
@@ -2764,6 +3195,10 @@ export declare const HistoryEventFilterSensitiveLog: (obj: HistoryEvent) => any;
  * @internal
  */
 export declare const GetExecutionHistoryOutputFilterSensitiveLog: (obj: GetExecutionHistoryOutput) => any;
+/**
+ * @internal
+ */
+export declare const PublishStateMachineVersionInputFilterSensitiveLog: (obj: PublishStateMachineVersionInput) => any;
 /**
  * @internal
  */
@@ -2792,3 +3227,7 @@ export declare const StopExecutionInputFilterSensitiveLog: (obj: StopExecutionIn
  * @internal
  */
 export declare const UpdateStateMachineInputFilterSensitiveLog: (obj: UpdateStateMachineInput) => any;
+/**
+ * @internal
+ */
+export declare const UpdateStateMachineAliasInputFilterSensitiveLog: (obj: UpdateStateMachineAliasInput) => any;