开始一个新的 AWS Step Functions 正在运行的执行中的状态机 - AWS Step Functions

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

开始一个新的 AWS Step Functions 正在运行的执行中的状态机

Step Function API s 与自己的即服务集成集成。学习如何使用 Step Functions 直接从正在运行的执行的任务状态开始状态机的新执行。构建新的工作流时,请使用嵌套工作流执行降低主要工作流的复杂性并重用常用流程。

优化的 Step Functions 集成的主要功能

请注意,没有针对 请求响应等待带有任务令牌的回调 集成模式的优化。

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

支持的Step Functions APIs

工作流示例

下面包括一个 Task 状态,此状态开始执行另一个状态机并等待其完成。

{ "Type":"Task", "Resource":"arn:aws:states:::states:startExecution.sync:2", "Parameters":{ "Input":{ "Comment": "Hello world!" }, "StateMachineArn":"arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld", "Name":"ExecutionName" }, "End":true }

下面包括一个 Task 状态,此状态开始执行另一个状态机。

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

以下内容包括实施回调服务集成模式的 Task 状态。

{ "Type":"Task", "Resource":"arn:aws:states:::states:startExecution.waitForTaskToken", "Parameters":{ "Input":{ "Comment": "Hello world!", "token.$": "$$.Task.Token" }, "StateMachineArn":"arn:aws:states:us-east-1:123456789012:stateMachine:HelloWorld", "Name":"ExecutionName" }, "End":true }

要将嵌套的工作流执行与启动它的父执行相关联,请传递一个特殊命名的参数,该参数包括从上下文对象中提取的执行 ID。启动嵌套执行时,使用名为 AWS_STEP_FUNCTIONS_STARTED_BY_EXECUTION_ID 的参数。通过将 .$ 附加到参数名称并在上下文对象中通过 $$.Execution.Id 引用 ID 来传递执行 ID。有关更多信息,请参阅 访问上下文对象

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

嵌套状态机返回以下内容:

资源 输出
startExecution.sync String
startExecution.sync: 2 JSON

两者都将等待嵌套状态机完成,但它们返回不同的 Output 格式。例如,如果您创建一个返回对象 { "MyKey": "MyValue" } 的 Lambda 函数,则会得到以下响应:

对于 startExecution .sync:

{ <other fields> "Output": "{ \"MyKey\": \"MyValue\" }" }

对于 startExecution .sync: 2:

{ <other fields> "Output": { "MyKey": "MyValue" } }

为嵌套状态机配置IAM权限

父状态机使用轮询和事件来确定子状态机是否已完成执行。轮询需要权限,states:DescribeExecution而发送 EventBridge 到 Step Functions 的事件则需要events:PutTargetsevents:PutRule、和的权限events:DescribeRule。如果您的IAM角色中缺少这些权限,则在父状态机意识到子状态机的执行已完成之前,可能会有一段延迟。

StartExecution对于要求执行单个嵌套工作流程的状态机,请使用限制对该状态机的权限的IAM策略。

有关更多信息,请参阅 Ste p Functions 的IAM权限

IAM用于调用嵌套 Step Functions 工作流程的策略

StartExecution对于要求执行单个嵌套工作流程的状态机,请使用限制对该状态机的权限的IAM策略。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "states:StartExecution" ], "Resource": [ "arn:aws:states:[[region]]:[[accountId]]:stateMachine:[[stateMachineName]]" ] } ] }

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

Synchronous
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "states:StartExecution" ], "Resource": [ "arn:aws:states:[[region]]:[[accountId]]:stateMachine:[[stateMachineName]]" ] }, { "Effect": "Allow", "Action": [ "states:DescribeExecution", "states:StopExecution" ], "Resource": [ "arn:aws:states:[[region]]:[[accountId]]:execution:[[stateMachineName]]:*" ] }, { "Effect": "Allow", "Action": [ "events:PutTargets", "events:PutRule", "events:DescribeRule" ], "Resource": [ "arn:aws:events:[[region]]:[[accountId]]:rule/StepFunctionsGetEventsForStepFunctionsExecutionRule" ] } ] }
Asynchronous
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "states:StartExecution" ], "Resource": [ "arn:aws:states:[[region]]:[[accountId]]:stateMachine:[[stateMachineName]]" ] } ] }

有关嵌套工作流执行的更多信息,请参阅在 Step Functions 中从任务状态开始执行工作流程