@aws-sdk/client-sfn 3.454.0 → 3.458.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist-es/SFN.js CHANGED
@@ -30,6 +30,7 @@ import { StartExecutionCommand, } from "./commands/StartExecutionCommand";
30
30
  import { StartSyncExecutionCommand, } from "./commands/StartSyncExecutionCommand";
31
31
  import { StopExecutionCommand, } from "./commands/StopExecutionCommand";
32
32
  import { TagResourceCommand } from "./commands/TagResourceCommand";
33
+ import { TestStateCommand } from "./commands/TestStateCommand";
33
34
  import { UntagResourceCommand, } from "./commands/UntagResourceCommand";
34
35
  import { UpdateMapRunCommand, } from "./commands/UpdateMapRunCommand";
35
36
  import { UpdateStateMachineAliasCommand, } from "./commands/UpdateStateMachineAliasCommand";
@@ -67,6 +68,7 @@ const commands = {
67
68
  StartSyncExecutionCommand,
68
69
  StopExecutionCommand,
69
70
  TagResourceCommand,
71
+ TestStateCommand,
70
72
  UntagResourceCommand,
71
73
  UpdateMapRunCommand,
72
74
  UpdateStateMachineCommand,
@@ -0,0 +1,48 @@
1
+ import { getEndpointPlugin } from "@smithy/middleware-endpoint";
2
+ import { getSerdePlugin } from "@smithy/middleware-serde";
3
+ import { Command as $Command } from "@smithy/smithy-client";
4
+ import { SMITHY_CONTEXT_KEY, } from "@smithy/types";
5
+ import { TestStateInputFilterSensitiveLog, TestStateOutputFilterSensitiveLog, } from "../models/models_0";
6
+ import { de_TestStateCommand, se_TestStateCommand } from "../protocols/Aws_json1_0";
7
+ export { $Command };
8
+ export class TestStateCommand extends $Command {
9
+ static getEndpointParameterInstructions() {
10
+ return {
11
+ UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
12
+ Endpoint: { type: "builtInParams", name: "endpoint" },
13
+ Region: { type: "builtInParams", name: "region" },
14
+ UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
15
+ };
16
+ }
17
+ constructor(input) {
18
+ super();
19
+ this.input = input;
20
+ }
21
+ resolveMiddleware(clientStack, configuration, options) {
22
+ this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
23
+ this.middlewareStack.use(getEndpointPlugin(configuration, TestStateCommand.getEndpointParameterInstructions()));
24
+ const stack = clientStack.concat(this.middlewareStack);
25
+ const { logger } = configuration;
26
+ const clientName = "SFNClient";
27
+ const commandName = "TestStateCommand";
28
+ const handlerExecutionContext = {
29
+ logger,
30
+ clientName,
31
+ commandName,
32
+ inputFilterSensitiveLog: TestStateInputFilterSensitiveLog,
33
+ outputFilterSensitiveLog: TestStateOutputFilterSensitiveLog,
34
+ [SMITHY_CONTEXT_KEY]: {
35
+ service: "AWSStepFunctions",
36
+ operation: "TestState",
37
+ },
38
+ };
39
+ const { requestHandler } = configuration;
40
+ return stack.resolve((request) => requestHandler.handle(request.request, options || {}), handlerExecutionContext);
41
+ }
42
+ serialize(input, context) {
43
+ return se_TestStateCommand(input, context);
44
+ }
45
+ deserialize(output, context) {
46
+ return de_TestStateCommand(output, context);
47
+ }
48
+ }
@@ -29,6 +29,7 @@ export * from "./StartExecutionCommand";
29
29
  export * from "./StartSyncExecutionCommand";
30
30
  export * from "./StopExecutionCommand";
31
31
  export * from "./TagResourceCommand";
32
+ export * from "./TestStateCommand";
32
33
  export * from "./UntagResourceCommand";
33
34
  export * from "./UpdateMapRunCommand";
34
35
  export * from "./UpdateStateMachineAliasCommand";
@@ -438,6 +438,17 @@ export const SyncExecutionStatus = {
438
438
  SUCCEEDED: "SUCCEEDED",
439
439
  TIMED_OUT: "TIMED_OUT",
440
440
  };
441
+ export const InspectionLevel = {
442
+ DEBUG: "DEBUG",
443
+ INFO: "INFO",
444
+ TRACE: "TRACE",
445
+ };
446
+ export const TestExecutionStatus = {
447
+ CAUGHT_ERROR: "CAUGHT_ERROR",
448
+ FAILED: "FAILED",
449
+ RETRIABLE: "RETRIABLE",
450
+ SUCCEEDED: "SUCCEEDED",
451
+ };
441
452
  export class MissingRequiredParameter extends __BaseException {
442
453
  constructor(opts) {
443
454
  super({
@@ -721,6 +732,27 @@ export const StopExecutionInputFilterSensitiveLog = (obj) => ({
721
732
  ...(obj.error && { error: SENSITIVE_STRING }),
722
733
  ...(obj.cause && { cause: SENSITIVE_STRING }),
723
734
  });
735
+ export const TestStateInputFilterSensitiveLog = (obj) => ({
736
+ ...obj,
737
+ ...(obj.definition && { definition: SENSITIVE_STRING }),
738
+ ...(obj.input && { input: SENSITIVE_STRING }),
739
+ });
740
+ export const InspectionDataFilterSensitiveLog = (obj) => ({
741
+ ...obj,
742
+ ...(obj.input && { input: SENSITIVE_STRING }),
743
+ ...(obj.afterInputPath && { afterInputPath: SENSITIVE_STRING }),
744
+ ...(obj.afterParameters && { afterParameters: SENSITIVE_STRING }),
745
+ ...(obj.result && { result: SENSITIVE_STRING }),
746
+ ...(obj.afterResultSelector && { afterResultSelector: SENSITIVE_STRING }),
747
+ ...(obj.afterResultPath && { afterResultPath: SENSITIVE_STRING }),
748
+ });
749
+ export const TestStateOutputFilterSensitiveLog = (obj) => ({
750
+ ...obj,
751
+ ...(obj.output && { output: SENSITIVE_STRING }),
752
+ ...(obj.error && { error: SENSITIVE_STRING }),
753
+ ...(obj.cause && { cause: SENSITIVE_STRING }),
754
+ ...(obj.inspectionData && { inspectionData: SENSITIVE_STRING }),
755
+ });
724
756
  export const UpdateStateMachineInputFilterSensitiveLog = (obj) => ({
725
757
  ...obj,
726
758
  ...(obj.definition && { definition: SENSITIVE_STRING }),
@@ -196,6 +196,19 @@ export const se_TagResourceCommand = async (input, context) => {
196
196
  body = JSON.stringify(_json(input));
197
197
  return buildHttpRpcRequest(context, headers, "/", undefined, body);
198
198
  };
199
+ export const se_TestStateCommand = async (input, context) => {
200
+ const headers = sharedHeaders("TestState");
201
+ let body;
202
+ body = JSON.stringify(_json(input));
203
+ let { hostname: resolvedHostname } = await context.endpoint();
204
+ if (context.disableHostPrefix !== true) {
205
+ resolvedHostname = "sync-" + resolvedHostname;
206
+ if (!__isValidHostname(resolvedHostname)) {
207
+ throw new Error("ValidationError: prefixed hostname must be hostname compatible.");
208
+ }
209
+ }
210
+ return buildHttpRpcRequest(context, headers, "/", resolvedHostname, body);
211
+ };
199
212
  export const se_UntagResourceCommand = async (input, context) => {
200
213
  const headers = sharedHeaders("UntagResource");
201
214
  let body;
@@ -1455,6 +1468,47 @@ const de_TagResourceCommandError = async (output, context) => {
1455
1468
  });
1456
1469
  }
1457
1470
  };
1471
+ export const de_TestStateCommand = async (output, context) => {
1472
+ if (output.statusCode >= 300) {
1473
+ return de_TestStateCommandError(output, context);
1474
+ }
1475
+ const data = await parseBody(output.body, context);
1476
+ let contents = {};
1477
+ contents = _json(data);
1478
+ const response = {
1479
+ $metadata: deserializeMetadata(output),
1480
+ ...contents,
1481
+ };
1482
+ return response;
1483
+ };
1484
+ const de_TestStateCommandError = async (output, context) => {
1485
+ const parsedOutput = {
1486
+ ...output,
1487
+ body: await parseErrorBody(output.body, context),
1488
+ };
1489
+ const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
1490
+ switch (errorCode) {
1491
+ case "InvalidArn":
1492
+ case "com.amazonaws.sfn#InvalidArn":
1493
+ throw await de_InvalidArnRes(parsedOutput, context);
1494
+ case "InvalidDefinition":
1495
+ case "com.amazonaws.sfn#InvalidDefinition":
1496
+ throw await de_InvalidDefinitionRes(parsedOutput, context);
1497
+ case "InvalidExecutionInput":
1498
+ case "com.amazonaws.sfn#InvalidExecutionInput":
1499
+ throw await de_InvalidExecutionInputRes(parsedOutput, context);
1500
+ case "ValidationException":
1501
+ case "com.amazonaws.sfn#ValidationException":
1502
+ throw await de_ValidationExceptionRes(parsedOutput, context);
1503
+ default:
1504
+ const parsedBody = parsedOutput.body;
1505
+ return throwDefaultError({
1506
+ output,
1507
+ parsedBody,
1508
+ errorCode,
1509
+ });
1510
+ }
1511
+ };
1458
1512
  export const de_UntagResourceCommand = async (output, context) => {
1459
1513
  if (output.statusCode >= 300) {
1460
1514
  return de_UntagResourceCommandError(output, context);
@@ -1616,6 +1670,9 @@ const de_UpdateStateMachineAliasCommandError = async (output, context) => {
1616
1670
  case "ResourceNotFound":
1617
1671
  case "com.amazonaws.sfn#ResourceNotFound":
1618
1672
  throw await de_ResourceNotFoundRes(parsedOutput, context);
1673
+ case "StateMachineDeleting":
1674
+ case "com.amazonaws.sfn#StateMachineDeleting":
1675
+ throw await de_StateMachineDeletingRes(parsedOutput, context);
1619
1676
  case "ValidationException":
1620
1677
  case "com.amazonaws.sfn#ValidationException":
1621
1678
  throw await de_ValidationExceptionRes(parsedOutput, context);
@@ -30,6 +30,7 @@ import { StartExecutionCommandInput, StartExecutionCommandOutput } from "./comma
30
30
  import { StartSyncExecutionCommandInput, StartSyncExecutionCommandOutput } from "./commands/StartSyncExecutionCommand";
31
31
  import { StopExecutionCommandInput, StopExecutionCommandOutput } from "./commands/StopExecutionCommand";
32
32
  import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
33
+ import { TestStateCommandInput, TestStateCommandOutput } from "./commands/TestStateCommand";
33
34
  import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
34
35
  import { UpdateMapRunCommandInput, UpdateMapRunCommandOutput } from "./commands/UpdateMapRunCommand";
35
36
  import { UpdateStateMachineAliasCommandInput, UpdateStateMachineAliasCommandOutput } from "./commands/UpdateStateMachineAliasCommand";
@@ -222,6 +223,12 @@ export interface SFN {
222
223
  tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
223
224
  tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
224
225
  tagResource(args: TagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
226
+ /**
227
+ * @see {@link TestStateCommand}
228
+ */
229
+ testState(args: TestStateCommandInput, options?: __HttpHandlerOptions): Promise<TestStateCommandOutput>;
230
+ testState(args: TestStateCommandInput, cb: (err: any, data?: TestStateCommandOutput) => void): void;
231
+ testState(args: TestStateCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TestStateCommandOutput) => void): void;
225
232
  /**
226
233
  * @see {@link UntagResourceCommand}
227
234
  */
@@ -39,6 +39,7 @@ import { StartExecutionCommandInput, StartExecutionCommandOutput } from "./comma
39
39
  import { StartSyncExecutionCommandInput, StartSyncExecutionCommandOutput } from "./commands/StartSyncExecutionCommand";
40
40
  import { StopExecutionCommandInput, StopExecutionCommandOutput } from "./commands/StopExecutionCommand";
41
41
  import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
42
+ import { TestStateCommandInput, TestStateCommandOutput } from "./commands/TestStateCommand";
42
43
  import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
43
44
  import { UpdateMapRunCommandInput, UpdateMapRunCommandOutput } from "./commands/UpdateMapRunCommand";
44
45
  import { UpdateStateMachineAliasCommandInput, UpdateStateMachineAliasCommandOutput } from "./commands/UpdateStateMachineAliasCommand";
@@ -49,11 +50,11 @@ export { __Client };
49
50
  /**
50
51
  * @public
51
52
  */
52
- export type ServiceInputTypes = CreateActivityCommandInput | CreateStateMachineAliasCommandInput | CreateStateMachineCommandInput | DeleteActivityCommandInput | DeleteStateMachineAliasCommandInput | DeleteStateMachineCommandInput | DeleteStateMachineVersionCommandInput | DescribeActivityCommandInput | DescribeExecutionCommandInput | DescribeMapRunCommandInput | DescribeStateMachineAliasCommandInput | DescribeStateMachineCommandInput | DescribeStateMachineForExecutionCommandInput | GetActivityTaskCommandInput | GetExecutionHistoryCommandInput | ListActivitiesCommandInput | ListExecutionsCommandInput | ListMapRunsCommandInput | ListStateMachineAliasesCommandInput | ListStateMachineVersionsCommandInput | ListStateMachinesCommandInput | ListTagsForResourceCommandInput | PublishStateMachineVersionCommandInput | RedriveExecutionCommandInput | SendTaskFailureCommandInput | SendTaskHeartbeatCommandInput | SendTaskSuccessCommandInput | StartExecutionCommandInput | StartSyncExecutionCommandInput | StopExecutionCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateMapRunCommandInput | UpdateStateMachineAliasCommandInput | UpdateStateMachineCommandInput;
53
+ export type ServiceInputTypes = CreateActivityCommandInput | CreateStateMachineAliasCommandInput | CreateStateMachineCommandInput | DeleteActivityCommandInput | DeleteStateMachineAliasCommandInput | DeleteStateMachineCommandInput | DeleteStateMachineVersionCommandInput | DescribeActivityCommandInput | DescribeExecutionCommandInput | DescribeMapRunCommandInput | DescribeStateMachineAliasCommandInput | DescribeStateMachineCommandInput | DescribeStateMachineForExecutionCommandInput | GetActivityTaskCommandInput | GetExecutionHistoryCommandInput | ListActivitiesCommandInput | ListExecutionsCommandInput | ListMapRunsCommandInput | ListStateMachineAliasesCommandInput | ListStateMachineVersionsCommandInput | ListStateMachinesCommandInput | ListTagsForResourceCommandInput | PublishStateMachineVersionCommandInput | RedriveExecutionCommandInput | SendTaskFailureCommandInput | SendTaskHeartbeatCommandInput | SendTaskSuccessCommandInput | StartExecutionCommandInput | StartSyncExecutionCommandInput | StopExecutionCommandInput | TagResourceCommandInput | TestStateCommandInput | UntagResourceCommandInput | UpdateMapRunCommandInput | UpdateStateMachineAliasCommandInput | UpdateStateMachineCommandInput;
53
54
  /**
54
55
  * @public
55
56
  */
56
- export type ServiceOutputTypes = CreateActivityCommandOutput | CreateStateMachineAliasCommandOutput | CreateStateMachineCommandOutput | DeleteActivityCommandOutput | DeleteStateMachineAliasCommandOutput | DeleteStateMachineCommandOutput | DeleteStateMachineVersionCommandOutput | DescribeActivityCommandOutput | DescribeExecutionCommandOutput | DescribeMapRunCommandOutput | DescribeStateMachineAliasCommandOutput | DescribeStateMachineCommandOutput | DescribeStateMachineForExecutionCommandOutput | GetActivityTaskCommandOutput | GetExecutionHistoryCommandOutput | ListActivitiesCommandOutput | ListExecutionsCommandOutput | ListMapRunsCommandOutput | ListStateMachineAliasesCommandOutput | ListStateMachineVersionsCommandOutput | ListStateMachinesCommandOutput | ListTagsForResourceCommandOutput | PublishStateMachineVersionCommandOutput | RedriveExecutionCommandOutput | SendTaskFailureCommandOutput | SendTaskHeartbeatCommandOutput | SendTaskSuccessCommandOutput | StartExecutionCommandOutput | StartSyncExecutionCommandOutput | StopExecutionCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateMapRunCommandOutput | UpdateStateMachineAliasCommandOutput | UpdateStateMachineCommandOutput;
57
+ export type ServiceOutputTypes = CreateActivityCommandOutput | CreateStateMachineAliasCommandOutput | CreateStateMachineCommandOutput | DeleteActivityCommandOutput | DeleteStateMachineAliasCommandOutput | DeleteStateMachineCommandOutput | DeleteStateMachineVersionCommandOutput | DescribeActivityCommandOutput | DescribeExecutionCommandOutput | DescribeMapRunCommandOutput | DescribeStateMachineAliasCommandOutput | DescribeStateMachineCommandOutput | DescribeStateMachineForExecutionCommandOutput | GetActivityTaskCommandOutput | GetExecutionHistoryCommandOutput | ListActivitiesCommandOutput | ListExecutionsCommandOutput | ListMapRunsCommandOutput | ListStateMachineAliasesCommandOutput | ListStateMachineVersionsCommandOutput | ListStateMachinesCommandOutput | ListTagsForResourceCommandOutput | PublishStateMachineVersionCommandOutput | RedriveExecutionCommandOutput | SendTaskFailureCommandOutput | SendTaskHeartbeatCommandOutput | SendTaskSuccessCommandOutput | StartExecutionCommandOutput | StartSyncExecutionCommandOutput | StopExecutionCommandOutput | TagResourceCommandOutput | TestStateCommandOutput | UntagResourceCommandOutput | UpdateMapRunCommandOutput | UpdateStateMachineAliasCommandOutput | UpdateStateMachineCommandOutput;
57
58
  /**
58
59
  * @public
59
60
  */
@@ -25,7 +25,7 @@ export interface RedriveExecutionCommandOutput extends RedriveExecutionOutput, _
25
25
  * @public
26
26
  * <p>Restarts unsuccessful executions of Standard workflows that didn't complete successfully in the last 14 days. These include failed, aborted, or timed out executions. When you <a href="https://docs.aws.amazon.com/step-functions/latest/dg/redrive-executions.html">redrive</a> an execution, it continues the failed execution from the unsuccessful step and uses the same input. Step Functions preserves the results and execution history of the successful steps, and doesn't rerun these steps when you redrive an execution. Redriven executions use the same state machine definition and execution ARN as the original execution attempt.</p>
27
27
  * <p>For workflows that include an <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-map-state.html">Inline Map</a> or <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-parallel-state.html">Parallel</a> state, <code>RedriveExecution</code> API action reschedules and redrives only the iterations and branches that failed or aborted.</p>
28
- * <p>To redrive a workflow that includes a Distributed Map state with failed child workflow executions, you must redrive the <a href="https://docs.aws.amazon.com/step-functions/latest/dg/use-dist-map-orchestrate-large-scale-parallel-workloads.html#dist-map-orchestrate-parallel-workloads-key-terms">parent workflow</a>. The parent workflow redrives all the unsuccessful states, including Distributed Map.</p>
28
+ * <p>To redrive a workflow that includes a Distributed Map state whose Map Run failed, you must redrive the <a href="https://docs.aws.amazon.com/step-functions/latest/dg/use-dist-map-orchestrate-large-scale-parallel-workloads.html#dist-map-orchestrate-parallel-workloads-key-terms">parent workflow</a>. The parent workflow redrives all the unsuccessful states, including a failed Map Run. If a Map Run was not started in the original execution attempt, the redriven parent workflow starts the Map Run.</p>
29
29
  * <note>
30
30
  * <p>This API action is not supported by <code>EXPRESS</code> state machines.</p>
31
31
  * <p>However, you can restart the unsuccessful executions of Express child workflows in a Distributed Map by redriving its Map Run. When you redrive a Map Run, the Express child workflows are rerun using the <a>StartExecution</a> API action. For more information, see <a href="https://docs.aws.amazon.com/step-functions/latest/dg/redrive-map-run.html">Redriving Map Runs</a>.</p>
@@ -0,0 +1,164 @@
1
+ import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
2
+ import { Command as $Command } from "@smithy/smithy-client";
3
+ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
4
+ import { TestStateInput, TestStateOutput } from "../models/models_0";
5
+ import { ServiceInputTypes, ServiceOutputTypes, SFNClientResolvedConfig } from "../SFNClient";
6
+ /**
7
+ * @public
8
+ */
9
+ export { __MetadataBearer, $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link TestStateCommand}.
14
+ */
15
+ export interface TestStateCommandInput extends TestStateInput {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link TestStateCommand}.
21
+ */
22
+ export interface TestStateCommandOutput extends TestStateOutput, __MetadataBearer {
23
+ }
24
+ /**
25
+ * @public
26
+ * <p>Accepts the definition of a single state and executes it. You can test a state without creating a state machine or updating an existing state machine. Using this API, you can test the following:</p>
27
+ * <ul>
28
+ * <li>
29
+ * <p>A state's <a href="https://docs.aws.amazon.com/step-functions/latest/dg/test-state-isolation.html#test-state-input-output-dataflow">input and output processing</a> data flow</p>
30
+ * </li>
31
+ * <li>
32
+ * <p>An <a href="https://docs.aws.amazon.com/step-functions/latest/dg/connect-to-services.html">Amazon Web Services service integration</a> request and response</p>
33
+ * </li>
34
+ * <li>
35
+ * <p>An <a href="https://docs.aws.amazon.com/step-functions/latest/dg/connect-third-party-apis.html">HTTP Task</a> request and response</p>
36
+ * </li>
37
+ * </ul>
38
+ * <p>You can call this API on only one state at a time. The states that you can test include the following:</p>
39
+ * <ul>
40
+ * <li>
41
+ * <p>
42
+ * <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-task-state.html#task-types">All Task types</a> except <a href="https://docs.aws.amazon.com/step-functions/latest/dg/concepts-activities.html">Activity</a>
43
+ * </p>
44
+ * </li>
45
+ * <li>
46
+ * <p>
47
+ * <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-pass-state.html">Pass</a>
48
+ * </p>
49
+ * </li>
50
+ * <li>
51
+ * <p>
52
+ * <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-wait-state.html">Wait</a>
53
+ * </p>
54
+ * </li>
55
+ * <li>
56
+ * <p>
57
+ * <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-choice-state.html">Choice</a>
58
+ * </p>
59
+ * </li>
60
+ * <li>
61
+ * <p>
62
+ * <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-succeed-state.html">Succeed</a>
63
+ * </p>
64
+ * </li>
65
+ * <li>
66
+ * <p>
67
+ * <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-fail-state.html">Fail</a>
68
+ * </p>
69
+ * </li>
70
+ * </ul>
71
+ * <p>The <code>TestState</code> API assumes an IAM role which must contain the required IAM permissions for the resources your state is accessing. For information about the permissions a state might need, see <a href="https://docs.aws.amazon.com/step-functions/latest/dg/test-state-isolation.html#test-state-permissions">IAM permissions to test a state</a>.</p>
72
+ * <p>The <code>TestState</code> API can run for up to five minutes. If the execution of a state exceeds this duration, it fails with the <code>States.Timeout</code> error.</p>
73
+ * <p>
74
+ * <code>TestState</code> doesn't support <a href="https://docs.aws.amazon.com/step-functions/latest/dg/concepts-activities.html">Activity tasks</a>, <code>.sync</code> or <code>.waitForTaskToken</code>
75
+ * <a href="https://docs.aws.amazon.com/step-functions/latest/dg/connect-to-resource.html">service integration patterns</a>, <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-parallel-state.html">Parallel</a>, or <a href="https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-map-state.html">Map</a> states.</p>
76
+ * @example
77
+ * Use a bare-bones client and the command you need to make an API call.
78
+ * ```javascript
79
+ * import { SFNClient, TestStateCommand } from "@aws-sdk/client-sfn"; // ES Modules import
80
+ * // const { SFNClient, TestStateCommand } = require("@aws-sdk/client-sfn"); // CommonJS import
81
+ * const client = new SFNClient(config);
82
+ * const input = { // TestStateInput
83
+ * definition: "STRING_VALUE", // required
84
+ * roleArn: "STRING_VALUE", // required
85
+ * input: "STRING_VALUE",
86
+ * inspectionLevel: "INFO" || "DEBUG" || "TRACE",
87
+ * revealSecrets: true || false,
88
+ * };
89
+ * const command = new TestStateCommand(input);
90
+ * const response = await client.send(command);
91
+ * // { // TestStateOutput
92
+ * // output: "STRING_VALUE",
93
+ * // error: "STRING_VALUE",
94
+ * // cause: "STRING_VALUE",
95
+ * // inspectionData: { // InspectionData
96
+ * // input: "STRING_VALUE",
97
+ * // afterInputPath: "STRING_VALUE",
98
+ * // afterParameters: "STRING_VALUE",
99
+ * // result: "STRING_VALUE",
100
+ * // afterResultSelector: "STRING_VALUE",
101
+ * // afterResultPath: "STRING_VALUE",
102
+ * // request: { // InspectionDataRequest
103
+ * // protocol: "STRING_VALUE",
104
+ * // method: "STRING_VALUE",
105
+ * // url: "STRING_VALUE",
106
+ * // headers: "STRING_VALUE",
107
+ * // body: "STRING_VALUE",
108
+ * // },
109
+ * // response: { // InspectionDataResponse
110
+ * // protocol: "STRING_VALUE",
111
+ * // statusCode: "STRING_VALUE",
112
+ * // statusMessage: "STRING_VALUE",
113
+ * // headers: "STRING_VALUE",
114
+ * // body: "STRING_VALUE",
115
+ * // },
116
+ * // },
117
+ * // nextState: "STRING_VALUE",
118
+ * // status: "SUCCEEDED" || "FAILED" || "RETRIABLE" || "CAUGHT_ERROR",
119
+ * // };
120
+ *
121
+ * ```
122
+ *
123
+ * @param TestStateCommandInput - {@link TestStateCommandInput}
124
+ * @returns {@link TestStateCommandOutput}
125
+ * @see {@link TestStateCommandInput} for command's `input` shape.
126
+ * @see {@link TestStateCommandOutput} for command's `response` shape.
127
+ * @see {@link SFNClientResolvedConfig | config} for SFNClient's `config` shape.
128
+ *
129
+ * @throws {@link InvalidArn} (client fault)
130
+ * <p>The provided Amazon Resource Name (ARN) is not valid.</p>
131
+ *
132
+ * @throws {@link InvalidDefinition} (client fault)
133
+ * <p>The provided Amazon States Language definition is not valid.</p>
134
+ *
135
+ * @throws {@link InvalidExecutionInput} (client fault)
136
+ * <p>The provided JSON input data is not valid.</p>
137
+ *
138
+ * @throws {@link ValidationException} (client fault)
139
+ * <p>The input does not satisfy the constraints specified by an Amazon Web Services service.</p>
140
+ *
141
+ * @throws {@link SFNServiceException}
142
+ * <p>Base exception class for all service exceptions from SFN service.</p>
143
+ *
144
+ */
145
+ export declare class TestStateCommand extends $Command<TestStateCommandInput, TestStateCommandOutput, SFNClientResolvedConfig> {
146
+ readonly input: TestStateCommandInput;
147
+ static getEndpointParameterInstructions(): EndpointParameterInstructions;
148
+ /**
149
+ * @public
150
+ */
151
+ constructor(input: TestStateCommandInput);
152
+ /**
153
+ * @internal
154
+ */
155
+ resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SFNClientResolvedConfig, options?: __HttpHandlerOptions): Handler<TestStateCommandInput, TestStateCommandOutput>;
156
+ /**
157
+ * @internal
158
+ */
159
+ private serialize;
160
+ /**
161
+ * @internal
162
+ */
163
+ private deserialize;
164
+ }
@@ -103,6 +103,9 @@ export interface UpdateStateMachineAliasCommandOutput extends UpdateStateMachine
103
103
  * @throws {@link ResourceNotFound} (client fault)
104
104
  * <p>Could not find the referenced resource.</p>
105
105
  *
106
+ * @throws {@link StateMachineDeleting} (client fault)
107
+ * <p>The specified state machine is being deleted.</p>
108
+ *
106
109
  * @throws {@link ValidationException} (client fault)
107
110
  * <p>The input does not satisfy the constraints specified by an Amazon Web Services service.</p>
108
111
  *
@@ -29,6 +29,7 @@ export * from "./StartExecutionCommand";
29
29
  export * from "./StartSyncExecutionCommand";
30
30
  export * from "./StopExecutionCommand";
31
31
  export * from "./TagResourceCommand";
32
+ export * from "./TestStateCommand";
32
33
  export * from "./UntagResourceCommand";
33
34
  export * from "./UpdateMapRunCommand";
34
35
  export * from "./UpdateStateMachineAliasCommand";