本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Task 工作流程状态
Task 状态 ("Type": "Task") 代表状态机执行的一个工作单元。任务使用活动或 Amazon Lambda 功能,通过与其他功能集成 支持的 Amazon Web Services 服务,或者调用 HTTPS API,例如 Stripe。
Amazon States Language 通过将状态类型设置为 Task 并向任务提供活动、Lambda 函数或 HTTPS API 端点的 Amazon 资源名称(ARN)来呈现任务。
使用 JSONata 参数调用函数
以下 Task 状态定义(JSONata)调用名为 的 Lambda 函数。priceWatcher
请注意使用 JSONata 表达式来查询要在参数中使用的输入数据以及赋值字段中的任务结果。
"Get Current Price": {
"Type": "Task",
"QueryLanguage" : "JSONata",
"Resource": "arn:aws:states:::lambda:invoke",
"Next": "Check Price",
"Arguments": {
"Payload": {
"product": "{% $states.context.Execution.Input.product %}"
},
"FunctionName": "arn:aws:lambda:<region>:account-id:function:priceWatcher:$LATEST"
},
"Assign": {
"currentPrice": "{% $states.result.Payload.current_price %}"
}
}使用 JSONPath 参数调用函数
以下 Task 状态定义(JSONPath)调用名为 的 Lambda 函数。HelloFunction
"Lambda Invoke": {
"Type": "Task",
"Resource": "arn:aws:states:::lambda:invoke",
"Parameters": {
"Payload.$": "$",
"FunctionName": "arn:aws:lambda:region:account-id:function:HelloFunction:$LATEST"
},
"End": true
}
任务类型
Step Functions 支持以下任务类型,您可以在 Task 状态定义中指定这些类型:
您可以通过在 Task 状态定义的 Resource 字段中提供其 ARN 来指定任务类型。以下示例显示了 Resource 字段的语法。除调用 HTTPS API 的任务类型外,所有任务类型均使用以下语法。有关 HTTP 任务语法的信息,请参阅在 Step Functions 工作流中调用 HTTPS API。
在任务状态定义中,将以下语法中的斜体文本替换为 Amazon 特定资源的信息。
arn:partition:service:region:account:task_type:name
下面的列表解释了此语法中的各个组件:
-
partition是 Amazon Step Functions 要使用的分区,最常用aws。 -
service表明 Amazon Web Services 服务 用于执行任务,可以是以下值之一: -
region是 Amazon 区域代码 其中 Step Functions 活动或状态机类型、Lambda 函数或任何其他类型 Amazon 资源已创建。 -
account是 Amazon Web Services 账户 您在其中定义资源的 ID。 -
task_type是要运行的任务的类型。它可能为下列值之一:-
activity– 一个活动。 -
function– 一个 Lambda 函数。 -
– 支持的连接服务的名称(请参阅 将服务与 Step Functions 集成)。servicename
-
-
name是已注册的资源名称(活动名称、Lambda 函数名称或服务 API 操作)。
Step Functions 不支持跨分区或区域引用 ARN。例如,aws-cn 无法调用 aws 分区中的任务,反之亦然。
以下各部分提供有关每种类型的更多详细信息。
Activity
活动表示由您实现和托管的、用于执行某个特定任务的工作线程 (进程或线程)。它们只受标准工作流支持,而不受快速工作流支持。
活动 Resource ARN 使用下面的语法。
arn:partition:states:region:account:activity:name
必须使用步骤函数创建活动(使用 CreateActivity、API 操作或 步骤函数控制台
有关创建活动和实现工作线程的更多信息,请参阅活动。
Lambda 函数
Lambda 任务使用执行函数 Amazon Lambda。要指定 Lambda 函数,请在 Resource 字段中使用 Lambda 函数的 ARN。
Lambda 函数 Resource 字段的形式因集成类型而异。
对于标准来说 Amazon SDK 与 Lambda 函数集成, Resource 字段将包含以下值:
"arn:aws:states:::aws-sdk:lambda:invoke"
我们建议对您的 Lambda 函数使用经过优化的集成,对 Resource 字段使用以下值:
"arn:aws:states:::lambda:invoke"
以下 Task 状态定义显示了名为 、使用 JSONata 的 Lambda 函数的优化集成的示例。HelloWorld
"Optimized call to Lambda function (JSONata)": {
"Type": "Task",
"Resource": "arn:aws:states:::lambda:invoke",
"Output": "{% $states.result.Payload %}",
"Arguments": {
"FunctionName": "arn:aws:lambda:region:account-id:function:HelloWorld:$LATEST",
"Payload": {
"key": "{% $states.input.myKey %}"
}
},
"Next": "NextState"
}
支持 A Amazon Web Services 服务
当您引用连接的资源时,Step Functions 直接调用受支持服务的 API 操作。在 Resource 字段中指定服务和操作。
所连接服务 Resource ARN 使用下面的语法。
arn:partition:states:region:account-id:servicename:APIname
要创建与已连接资源的同步连接,请添加 .sync 到 APIname 在 ARN 中输入。有关更多信息,请参阅 集成 服务。
例如:
{
"StartAt": "BATCH_JOB",
"States": {
"BATCH_JOB": {
"Type": "Task",
"Resource": "arn:aws:states:::batch:submitJob.sync",
"Parameters": {
"JobDefinition": "preprocessing",
"JobName": "PreprocessingBatchJob",
"JobQueue": "SecondaryQueue",
"Parameters.$": "$.batchjob.parameters",
"RetryStrategy": {
"attempts": 5
}
},
"End": true
}
}
}
Task 状态字段
除了常见状态字段之外,Task 状态还具有以下字段。
-
Resource(必填) -
一个 URI,尤其是唯一标识要执行的特定任务的 ARN。
Arguments(可选,仅限 JSONata)-
用于将信息传递给所连接资源的 API 操作。值可以包括 JSONata 表达式。有关更多信息,请参阅 在 Step Functions 中使用 JSONata 转换数据。
Output(可选,仅限 JSONata)-
用于指定和转换状态的输出。指定后,该值将覆盖状态输出默认值。
输出字段接受任何 JSON 值(对象、数组、字符串、数字、布尔值、null)。任何字符串值(包括对象或数组内的字符串),若被 {% %} 字符包裹,都会被解析为 JSONata 表达式。
输出还直接接受 JSONata 表达式,例如:"Output": "{% jsonata expression %}"
有关更多信息,请参阅输入和输出处理。
Parameters(可选,仅限 JSONPath)-
用于将信息传递给所连接资源的 API 操作。参数可以混合使用静态 JSON 和 JsonPath
。有关更多信息,请参阅在 Step Functions 中将参数传递给服务 API。 Credentials(可选)-
指定状态机的执行角色在调用指定
Resource前必须承担的目标角色。或者,您也可以指定 JSONPath 值或内置函数,在运行时根据执行输入解析为 IAM 角色 ARN。如果指定 JSONPath 值,则必须在其前缀加上$.表示法。有关在
Task状态内使用此字段的示例,请参阅 。有关使用此字段访问跨账户的示例 Amazon 来自您的状态机的资源,请参阅 在 Step Functi Amazon ons 中访问跨账户资源。注意支持此字段 任务类型 那个用 Lambda 函数 和 a 支持的 Amazon 服务。
-
ResultPath(可选,仅限 JSONPath) -
指定(输入中)用于放置
Resource中所指定任务的执行结果的位置。接下来,输入将按照OutputPath字段(如果存在)指定的内容进行筛选,然后再用作状态输出。有关更多信息,请参阅输入和输出处理。 -
ResultSelector(可选,仅限 JSONPath) -
传递键值对集合,其中,值为静态值或从结果中选择的值。有关更多信息,请参阅ResultSelector。
-
Retry(可选) -
一个称为重试器的对象的数组,定义在状态遇到运行时错误时的重试策略。有关更多信息,请参阅使用 Retry 和 Catch 的状态机示例。
-
Catch(可选) -
一个称为捕获器的对象数组,用于定义回退状态。如果状态遇到运行时错误并且其重试策略已耗尽或者未定义,则执行该状态。有关更多信息,请参阅回退状态。
-
TimeoutSeconds(可选) -
指定活动或任务在因 States.Timeout 错误而超时并失败之前可以运行的最长时间。超时值必须是正的非零整数。如果你没有设置
TimeoutSeconds,默认值取决于任务类型。有关请求响应服务集成,请参阅 请求响应任务的超时。活动,以及等待.sync工作或.waitForTaskToken回调,没有默认超时。它们可以持续到执行达到其最大持续时间为止。超时计数从启动事件执行时开始,例如,从
TaskStarted、ActivityStarted或LambdaFunctionStarted事件开始在执行事件历史中记录时开始。对于活动,当GetActivityTask收到令牌并且ActivityStarted记录在执行事件历史记录中时开始计数。Step Functions 会在指定的
TimeoutSeconds时长内等待任务或活动工作线程的成功或失败响应。如果任务或活动工作线程未能在这段时间内做出响应,Step Functions 会将工作流执行标记为失败。注意HTTP 任务超时的最大值为 60 秒,即使
TimeoutSeconds超过该限制也是如此。请参阅 与 HTTP 任务相关的配额。 -
TimeoutSecondsPath(可选,仅限 JSONPath) -
如果要使用参考路径从状态输入中动态提供超时值,请使用
TimeoutSecondsPath。解析后,参考路径必须选择值为正整数的字段。注意一个
Task状态不能同时包含TimeoutSeconds和TimeoutSecondsPath。HTTP 任务超时的最大值为 60 秒,即使TimeoutSecondsPath值超过该限制也是如此。 -
HeartbeatSeconds(可选) -
确定活动工作线程在任务执行期间发送的检测信号的频率。检测信号表示任务仍在运行,需要更多时间才能完成。检测信号可防止活动或任务在
TimeoutSeconds持续时间内超时。HeartbeatSeconds必须是小于TimeoutSeconds字段值的正非零整数值。默认值为 99,999,999。如果任务检测信号之间的时间超过了指定秒数,则 Task 状态将失败,并返回 States.Timeout 错误。对于活动,当
GetActivityTask收到令牌并且ActivityStarted记录在执行事件历史记录中时开始计数。 -
HeartbeatSecondsPath(可选,仅限 JSONPath) -
如果要使用参考路径从状态输入中动态提供检测信号值,请使用
HeartbeatSecondsPath。解析后,参考路径必须选择值为正整数的字段。注意一个
Task状态不能同时包含HeartbeatSeconds和HeartbeatSecondsPath。
Task 状态必须将 End 字段设置为 true(如果状态结束执行),或者必须在 Next 字段中提供一个状态(该状态将在 Task 状态完成时运行)。
Task 状态定义示例
以下示例说明如何根据要求指定 Task 状态定义。
Task 状态超时和检测信号间隔
为长时间运行的活动设置超时值和检测信号间隔是一个好的做法。这可以通过指定超时和检测信号值或通过动态设置来完成。
静态超时和检测信号通知示例
当 HelloWorld 完成后,将运行下一个状态(此处名为 NextState)。
如果此任务在 300 秒内未能完成,或者未在 60 秒的间隔内发送检测信号通知,则任务会被标记为 failed。
"ActivityState": {
"Type": "Task",
"Resource": "arn:aws:states:region:123456789012:activity:HelloWorld",
"TimeoutSeconds": 300,
"HeartbeatSeconds": 60,
"Next": "NextState"
}
动态任务超时和检测信号通知示例
在这个例子中,当 Amazon Glue 作业完成,下一个状态将运行。
如果此任务未能在 Amazon Glue
作业动态设置的时间间隔内完成,则该任务将被标记为 failed。
"GlueJobTask": {
"Type": "Task",
"Resource": "arn:aws:states:::glue:startJobRun.sync",
"Parameters": {
"JobName": "myGlueJob"
},
"TimeoutSecondsPath": "$.params.maxTime",
"Next": "NextState"
}