@aws-sdk/client-sfn 3.218.0 → 3.223.0

package/dist-types/commands/DeleteStateMachineCommand.d.ts

@@ -10,6 +10,11 @@ export interface DeleteStateMachineCommandOutput extends DeleteStateMachineOutpu
 /**
  * <p>Deletes a state machine. This is an asynchronous operation: It sets the state machine's
  *       status to <code>DELETING</code> and begins the deletion process. </p>
+ *
+ *          <p>If the given state machine Amazon Resource Name (ARN) is a qualified state machine ARN, it will fail with ValidationException.</p>
+ *
+ *          <p>A qualified state machine ARN refers to a <i>Distributed Map state</i> defined within a state machine. For example, the qualified state machine ARN <code>arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel</code> refers to a <i>Distributed Map state</i> with a label <code>mapStateLabel</code> in the state machine named <code>stateMachineName</code>.</p>
+ *
  *          <note>
  *             <p>For <code>EXPRESS</code> state machines, the deletion will happen eventually (usually
  *         less than a minute). Running executions may emit logs after <code>DeleteStateMachine</code>

package/dist-types/commands/DescribeExecutionCommand.d.ts

@@ -8,11 +8,11 @@ export interface DescribeExecutionCommandInput extends DescribeExecutionInput {
 export interface DescribeExecutionCommandOutput extends DescribeExecutionOutput, __MetadataBearer {
 }
 /**
- * <p>Describes an execution.</p>
+ * <p>Provides all information about a state machine execution, such as the state machine associated with the execution, the execution input and output, and relevant execution metadata. Use this API action to return the Map Run ARN if the execution was dispatched by a Map Run.</p>
  *          <note>
  *             <p>This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.</p>
  *          </note>
- *          <p>This API action is not supported by <code>EXPRESS</code> state machines.</p>
+ *          <p>This API action is not supported by <code>EXPRESS</code> state machine executions unless they were dispatched by a Map Run.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DescribeMapRunCommand.d.ts

@@ -0,0 +1,37 @@
+import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { DescribeMapRunInput, DescribeMapRunOutput } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SFNClientResolvedConfig } from "../SFNClient";
+export interface DescribeMapRunCommandInput extends DescribeMapRunInput {
+}
+export interface DescribeMapRunCommandOutput extends DescribeMapRunOutput, __MetadataBearer {
+}
+/**
+ * <p>Provides information about a Map Run's configuration, progress, and results. For more information, see <a href="https://docs.aws.amazon.com/step-functions/latest/dg/concepts-examine-map-run.html">Examining Map Run</a> in the <i>Step Functions Developer Guide</i>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SFNClient, DescribeMapRunCommand } from "@aws-sdk/client-sfn"; // ES Modules import
+ * // const { SFNClient, DescribeMapRunCommand } = require("@aws-sdk/client-sfn"); // CommonJS import
+ * const client = new SFNClient(config);
+ * const command = new DescribeMapRunCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link DescribeMapRunCommandInput} for command's `input` shape.
+ * @see {@link DescribeMapRunCommandOutput} for command's `response` shape.
+ * @see {@link SFNClientResolvedConfig | config} for SFNClient's `config` shape.
+ *
+ */
+export declare class DescribeMapRunCommand extends $Command<DescribeMapRunCommandInput, DescribeMapRunCommandOutput, SFNClientResolvedConfig> {
+    readonly input: DescribeMapRunCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    constructor(input: DescribeMapRunCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SFNClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DescribeMapRunCommandInput, DescribeMapRunCommandOutput>;
+    private serialize;
+    private deserialize;
+}

package/dist-types/commands/DescribeStateMachineCommand.d.ts

@@ -8,7 +8,10 @@ export interface DescribeStateMachineCommandInput extends DescribeStateMachineIn
 export interface DescribeStateMachineCommandOutput extends DescribeStateMachineOutput, __MetadataBearer {
 }
 /**
- * <p>Describes a state machine.</p>
+ * <p>Provides information about a state machine's definition, its IAM role Amazon Resource Name (ARN), and configuration. If the state machine ARN is a qualified state machine ARN, the response returned includes the <code>Map</code> state's label.</p>
+ *
+ *          <p>A qualified state machine ARN refers to a <i>Distributed Map state</i> defined within a state machine. For example, the qualified state machine ARN <code>arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel</code> refers to a <i>Distributed Map state</i> with a label <code>mapStateLabel</code> in the state machine named <code>stateMachineName</code>.</p>
+ *
  *          <note>
  *             <p>This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.</p>
  *          </note>

package/dist-types/commands/DescribeStateMachineForExecutionCommand.d.ts

@@ -8,7 +8,7 @@ export interface DescribeStateMachineForExecutionCommandInput extends DescribeSt
 export interface DescribeStateMachineForExecutionCommandOutput extends DescribeStateMachineForExecutionOutput, __MetadataBearer {
 }
 /**
- * <p>Describes the state machine associated with a specific execution.</p>
+ * <p>Provides information about a state machine's definition, its execution role ARN, and configuration. If an execution was dispatched by a Map Run, the Map Run is returned in the response. Additionally, the state machine returned will be the state machine associated with the Map Run.</p>
  *          <note>
  *             <p>This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.</p>
  *          </note>

package/dist-types/commands/ListExecutionsCommand.d.ts

@@ -8,7 +8,8 @@ export interface ListExecutionsCommandInput extends ListExecutionsInput {
 export interface ListExecutionsCommandOutput extends ListExecutionsOutput, __MetadataBearer {
 }
 /**
- * <p>Lists the executions of a state machine that meet the filtering criteria. Results are
+ * <p>Lists all executions of a state machine or a Map Run. You can list all executions related to a state machine by specifying a state machine Amazon Resource Name (ARN), or those related to a Map Run by specifying a Map Run ARN.</p>
+ *          <p>Results are
  *       sorted by time, with the most recent execution first.</p>
  *          <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>

package/dist-types/commands/ListMapRunsCommand.d.ts

@@ -0,0 +1,37 @@
+import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { ListMapRunsInput, ListMapRunsOutput } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SFNClientResolvedConfig } from "../SFNClient";
+export interface ListMapRunsCommandInput extends ListMapRunsInput {
+}
+export interface ListMapRunsCommandOutput extends ListMapRunsOutput, __MetadataBearer {
+}
+/**
+ * <p>Lists all Map Runs that were started by a given state machine execution. Use this API action to obtain Map Run ARNs, and then call <code>DescribeMapRun</code> to obtain more information, if needed.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SFNClient, ListMapRunsCommand } from "@aws-sdk/client-sfn"; // ES Modules import
+ * // const { SFNClient, ListMapRunsCommand } = require("@aws-sdk/client-sfn"); // CommonJS import
+ * const client = new SFNClient(config);
+ * const command = new ListMapRunsCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link ListMapRunsCommandInput} for command's `input` shape.
+ * @see {@link ListMapRunsCommandOutput} for command's `response` shape.
+ * @see {@link SFNClientResolvedConfig | config} for SFNClient's `config` shape.
+ *
+ */
+export declare class ListMapRunsCommand extends $Command<ListMapRunsCommandInput, ListMapRunsCommandOutput, SFNClientResolvedConfig> {
+    readonly input: ListMapRunsCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    constructor(input: ListMapRunsCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SFNClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListMapRunsCommandInput, ListMapRunsCommandOutput>;
+    private serialize;
+    private deserialize;
+}

package/dist-types/commands/StartExecutionCommand.d.ts

@@ -8,7 +8,10 @@ export interface StartExecutionCommandInput extends StartExecutionInput {
 export interface StartExecutionCommandOutput extends StartExecutionOutput, __MetadataBearer {
 }
 /**
- * <p>Starts a state machine execution.</p>
+ * <p>Starts a state machine execution. If the given state machine Amazon Resource Name (ARN) is a qualified state machine ARN, it will fail with ValidationException.</p>
+ *
+ *          <p>A qualified state machine ARN refers to a <i>Distributed Map state</i> defined within a state machine. For example, the qualified state machine ARN <code>arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel</code> refers to a <i>Distributed Map state</i> with a label <code>mapStateLabel</code> in the state machine named <code>stateMachineName</code>.</p>
+ *
  *          <note>
  *             <p>
  *                <code>StartExecution</code> is idempotent for <code>STANDARD</code> workflows. For a

package/dist-types/commands/UpdateMapRunCommand.d.ts

@@ -0,0 +1,37 @@
+import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { UpdateMapRunInput, UpdateMapRunOutput } from "../models/models_0";
+import { ServiceInputTypes, ServiceOutputTypes, SFNClientResolvedConfig } from "../SFNClient";
+export interface UpdateMapRunCommandInput extends UpdateMapRunInput {
+}
+export interface UpdateMapRunCommandOutput extends UpdateMapRunOutput, __MetadataBearer {
+}
+/**
+ * <p>Updates an in-progress Map Run's configuration to include changes to the settings that control maximum concurrency and Map Run failure.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { SFNClient, UpdateMapRunCommand } from "@aws-sdk/client-sfn"; // ES Modules import
+ * // const { SFNClient, UpdateMapRunCommand } = require("@aws-sdk/client-sfn"); // CommonJS import
+ * const client = new SFNClient(config);
+ * const command = new UpdateMapRunCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link UpdateMapRunCommandInput} for command's `input` shape.
+ * @see {@link UpdateMapRunCommandOutput} for command's `response` shape.
+ * @see {@link SFNClientResolvedConfig | config} for SFNClient's `config` shape.
+ *
+ */
+export declare class UpdateMapRunCommand extends $Command<UpdateMapRunCommandInput, UpdateMapRunCommandOutput, SFNClientResolvedConfig> {
+    readonly input: UpdateMapRunCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    constructor(input: UpdateMapRunCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SFNClientResolvedConfig, options?: __HttpHandlerOptions): Handler<UpdateMapRunCommandInput, UpdateMapRunCommandOutput>;
+    private serialize;
+    private deserialize;
+}

package/dist-types/commands/UpdateStateMachineCommand.d.ts

@@ -13,6 +13,11 @@ export interface UpdateStateMachineCommandOutput extends UpdateStateMachineOutpu
  *       to use the previous <code>definition</code> and <code>roleArn</code>. You must include at
  *       least one of <code>definition</code> or <code>roleArn</code> or you will receive a
  *         <code>MissingRequiredParameter</code> error.</p>
+ *
+ *          <p>If the given state machine Amazon Resource Name (ARN) is a qualified state machine ARN, it will fail with ValidationException.</p>
+ *
+ *          <p>A qualified state machine ARN refers to a <i>Distributed Map state</i> defined within a state machine. For example, the qualified state machine ARN <code>arn:partition:states:region:account-id:stateMachine:stateMachineName/mapStateLabel</code> refers to a <i>Distributed Map state</i> with a label <code>mapStateLabel</code> in the state machine named <code>stateMachineName</code>.</p>
+ *
  *          <note>
  *             <p>All <code>StartExecution</code> calls within a few seconds will use the updated
  *           <code>definition</code> and <code>roleArn</code>. Executions started immediately after

package/dist-types/commands/index.d.ts

@@ -4,12 +4,14 @@ export * from "./DeleteActivityCommand";
 export * from "./DeleteStateMachineCommand";
 export * from "./DescribeActivityCommand";
 export * from "./DescribeExecutionCommand";
+export * from "./DescribeMapRunCommand";
 export * from "./DescribeStateMachineCommand";
 export * from "./DescribeStateMachineForExecutionCommand";
 export * from "./GetActivityTaskCommand";
 export * from "./GetExecutionHistoryCommand";
 export * from "./ListActivitiesCommand";
 export * from "./ListExecutionsCommand";
+export * from "./ListMapRunsCommand";
 export * from "./ListStateMachinesCommand";
 export * from "./ListTagsForResourceCommand";
 export * from "./SendTaskFailureCommand";
@@ -20,4 +22,5 @@ export * from "./StartSyncExecutionCommand";
 export * from "./StopExecutionCommand";
 export * from "./TagResourceCommand";
 export * from "./UntagResourceCommand";
+export * from "./UpdateMapRunCommand";
 export * from "./UpdateStateMachineCommand";

package/dist-types/endpoint/EndpointParameters.d.ts

@@ -12,7 +12,7 @@ export declare const resolveClientEndpointParameters: <T>(options: T & ClientInp
     defaultSigningName: string;
 };
 export interface EndpointParameters extends __EndpointParameters {
-    Region?: string;
+    Region: string;
     UseDualStack?: boolean;
     UseFIPS?: boolean;
     Endpoint?: string;