Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

Task

Task 状态 ("Type": "Task") 代表状态机执行的一个工作单元。

您状态机中的所有工作由任务 完成。任务通过使用活动、Amazon Lambda 函数或将参数传递给其他服务的 API 操作来执行工作。

Amazon Step Functions可以直接从任务状态调用 Lambda 函数。Lambda 函数是云原生的任务，运行在Amazon Lambda。您可以使用各种编程语言编写 Lambda 函数，并使用Amazon Web Services Management Console或通过将代码上传到 Lambda。有关更多信息，请参阅 创建 Step Functions 状态Machine使用 Lambda。

活动由程序代码组成，它们等待运算符执行操作或者提供输入。您可以在 Amazon EC2 上、在 Amazon ECS 上甚至在移动设备上托管活动。活动轮询 Step Functions 使用GetActivityTask和SendTaskSuccess、SendTaskFailure, 和SendTaskHeartbeatAPI 操作。

Amazon 状态语言通过将状态的类型设置为来呈现任务。Task并且向任务提供活动或 Lambda 函数的 Amazon 资源名称 (ARN)。

除了常见状态字段之外，Task 状态还具有以下字段。

Task 状态必须将 End 字段设置为 true（如果状态结束执行），或者必须在 Next 字段中提供一个状态（该状态将在 Task 状态完成时运行）。

任务状态超时和检测信号间隔

为长时间运行的活动设置超时值和检测信号间隔是一个好的做法。这可以通过指定超时值和检测信号值或动态设置它们来完成。

静态超时和心跳通知示例

当 HelloWorld 完成后，将运行下一个状态 (此处名为 NextState)。

如果此任务在 300 秒内未能完成，或者未在 60 秒的间隔内发送检测信号通知，则任务会被标记为 failed。

"ActivityState": {
  "Type": "Task",
  "Resource": "arn:aws:states:us-east-1:123456789012:activity:HelloWorld",
  "TimeoutSeconds": 300,
  "HeartbeatSeconds": 60,
  "Next": "NextState"
}

动态任务超时和检测信号通知示例

在此示例中，当Amazon Glue作业完成后，将运行下一个状态。

如果此任务无法在由Amazon Glue作业设置的时间间隔，或者不发送检测信号通知Amazon Glue作业时，将该任务标记为failed。

"ActivityState": {
  "Type": "Task",
  "Resource": "arn:aws:states:::glue:startJobRun.sync",
  "Parameters": {
    "JobName": "myGlueJob"
  },
  "TimeoutSecondsPath":  "$.params.maxTime",
  "HeartbeatSecondsPath": "$.params.heartbeat",
  "Next": "NextState"
}

在任务中指定资源 ARN

Resource 字段的 ARN 是使用以下模式指定的。

arn:partition:service:region:account:task_type:name

在该模式中：

任务类型

支持以下任务类型：

以下各部分提供有关每种类型的更多详细信息。

Activity

活动表示由您实现和托管的、用于执行某个特定任务的工作线程 (进程或线程)。它们只受标准工作流支持，而不受快速工作流支持。

活动 resource ARN 使用下面的语法。

arn:partition:states:region:account:activity:name

有关这些字段的更多信息，请参阅指定任务中的资源 ARN。

有关创建活动和实现工作线程的更多信息，请参阅活动。

Lambda 函数

Lambda 任务使用执行函数Amazon Lambda。要指定 Lambda 函数，请使用 Lambda 函数的 ARN，在Resource字段。

Lambda 函数ResourceARN 使用下面的语法。

arn:partition:lambda:region:account:function:function_name

有关这些字段的更多信息，请参阅指定任务中的资源 ARN。

例如：

"LambdaState": {
  "Type": "Task",
  "Resource": "arn:aws:lambda:us-east-1:123456789012:function:HelloWorld",
  "Next": "NextState"
}

LambdaResource字段完成后，其输出将会发送到在Next字段（“下一个状态”）。

支持的 Amazon 服务

当您引用连接的资源时，Step Functions 直接调用受支持服务的 API 操作。在 Resource 字段中指定服务和操作。

所连接服务 Resource ARN 使用下面的语法。

arn:partition:states:region:account:servicename:APIname

例如：

{
 "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
    }
  }
}