从任务状态启动工作流程执行 - AWS Step Functions
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

从任务状态启动工作流程执行

AWS Step Functions 可以直接从状态机的 Task 状态启动工作流程执行。这允许您将工作流程分解为较小的状态机,并开始执行这些其他状态机。通过启动这些新的工作流程执行,您可以:

  • 将更高级别的工作流程与较低级别的特定于任务的工作流程分开。

  • 通过多次调用单独的状态机来避免重复元素。

  • 创建模块化可重用工作流程库以加快开发速度。

  • 降低复杂性并使编辑状态机和排除其故障变得更容易。

Step Functions 可以通过调用自己的 API 以作为集成服务来启动这些工作流程执行。只需从 Task 状态调用 StartExecution API 操作并传递必要的参数即可。您可以使用任何服务集成模式调用 Step Functions API。要启动新的状态机执行,请使用类似于以下内容的 Task 状态。

{ "Type":"Task", "Resource":"arn:aws:states:::states:startExecution", "Parameters":{ "StateMachineArn":"arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld", "Input":{ "Comment":"Hello world!" }, "Retry":[ { "ErrorEquals":[ "StepFunctions.ExecutionLimitExceeded" ] } ], "End":true } }

Task 状态会启动新的 HelloWorld 状态机执行,并传递 JSON 注释作为输入。

注意

StartExecution API 操作配额可以限制您可以启动的执行次数。对 StepFunctions.ExecutionLimitExceeded 使用 Retry 以确保启动您的执行。请参阅以下内容。

关联工作流程执行

要将已启动的工作流程执行与启动它的执行相关联,请将执行 ID 从上下文对象传递到执行输入。您可以在正在运行的执行中从您的 Task 状态访问上下文对象中的 ID。通过将 .$ 附加到参数名称并在上下文对象中通过 $$.Execution.Id 引用 ID 来传递执行 ID。

"AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID.$": "$$.Execution.Id"

在启动执行时,您可以使用名为 AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID 的特殊参数。如果包含,则此关联在 Step Functions 控制台的 Step details (步骤详细信息) 部分中提供链接。当提供后,您可以轻松跟踪工作流程的执行情况(从正在启动的执行到已启动的工作流程执行)。使用前面的示例,将执行 ID 与 HelloWorld 状态机的已启动执行相关联,如下所示。

{ "Type":"Task", "Resource":"arn:aws:states:::states:startExecution", "Parameters":{ "StateMachineArn":"arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld", "Input": { "Comment": "Hello world!", "AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID.$": "$$.Execution.Id" } }, "End":true }

有关更多信息,请参阅下列内容: