本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

任務工作流程狀態

Task 狀態 ("Type": "Task") 代表狀態機器執行的一個工作單位。任務透過使用 活動或 AWS Lambda 函數、與其他支援的 AWS 服務 整合，或叫用 HTTPS API 來執行工作，例如 Stripe。

Amazon States Language 代表任務，方法是將狀態的類型設定為 Task，並提供任務活動、Lambda 函數或 HTTPS API 端點的 Amazon Resource Name (ARN)。

使用 JSONata 引數叫用函數

下列任務狀態定義 (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>:123456789012:function:priceWatcher:$LATEST"
  },
  "Assign": {
    "currentPrice": "{% $states.result.Payload.current_price %}"
  }
}

使用 JSONPath 參數叫用 函數

下列任務狀態定義 (JSONPath) 會叫用名為 的 Lambda 函數HelloFunction。

"Lambda Invoke": {
  "Type": "Task",
  "Resource": "arn:aws:states:::lambda:invoke",
  "Parameters": {
    "Payload.$": "$",
    "FunctionName": "arn:aws:lambda:us-east-2:123456789012:function:HelloFunction:$LATEST"
  },
  "End": true
}

任務類型

Step Functions 支援下列任務類型，您可以在任務狀態定義中指定：

您可以透過在任務狀態定義的 Resource 欄位中提供其 ARN 來指定任務類型。下列範例顯示 Resource 欄位的語法。除了呼叫 HTTPS API 的任務類型之外，所有任務類型都使用下列語法。如需有關 HTTP 任務語法的資訊，請參閱 在 Step Functions 工作流程中呼叫 HTTPS APIs 。

在您的任務狀態定義中，將下列語法中的斜體文字取代為 AWS 資源特定資訊。

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

下列清單說明此語法中的個別元件：

下列各節會提供每個任務類型的詳細資訊。

活動

活動代表由您實作和託管並可執行特定任務的工作者 (程序或執行緒)。活動僅受到標準工作流程支援，不受快速工作流程支持。

活動 Resource ARN 會使用以下語法。

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

如需建立活動及實作工作者的詳細資訊，請參閱活動。

Lambda 函數

Lambda 任務使用 執行函數 AWS Lambda。若要指定 Lambda 函數，請在 Resource 欄位中使用 Lambda 函數的 ARN。

根據您用於指定 Lambda 函數的整合類型 (最佳化整合或 AWS SDK 整合)，Lambda 函數Resource欄位的語法會有所不同。

下列Resource欄位語法是與 Lambda 函數最佳化整合的範例。

"arn:aws:states:::lambda:invoke"

下列Resource欄位語法是 AWS SDK 與 Lambda 函數整合的範例。

"arn:aws:states:::aws-sdk:lambda:invoke"

下列Task狀態定義顯示與名為 的 Lambda 函數進行最佳化整合的範例HelloWorld。

"LambdaState": {
  "Type": "Task",
  "Resource": "arn:aws:states:::lambda:invoke",
  "OutputPath": "$.Payload",
  "Parameters": {
    "Payload.$": "$",
    "FunctionName": "arn:aws:lambda:us-east-1:function:HelloWorld:$LATEST"
  },
  "Next": "NextState"
}

在 Resource 欄位指定的 Lambda 函數完成後，其輸出會傳送至 Next 欄位 ("NextState") 中識別的狀態。

支援的 AWS 服務

當您參考連線的資源時，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
    }
  }
}

任務狀態欄位

除了常見狀態欄位以外，Task 狀態還有下列欄位。

如果狀態結束執行，則 Task 狀態必須將 End 欄位設定為 true，或必須在 Task 狀態完成時於 Next 欄位中提供執行的狀態。

任務狀態定義範例

下列範例示範如何根據您的需求指定任務狀態定義。

任務狀態逾時和活動訊號間隔

這是針對長時間執行的活動設定逾時值和活動訊號間隔的最佳實務。這可以透過指定逾時和活動訊號值，或動態設定它們來完成。

靜態逾時和活動訊號通知範例

當 HelloWorld 完成時，將會執行下一個狀態 (這裡稱為 NextState)。

如果這個任務無法在 300 秒內完成，或者未在 60 秒的間隔內傳送活動訊號通知，則任務會被標示為 failed。

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

動態任務逾時和活動訊號通知範例

在此範例中，當 AWS Glue 任務完成時，將執行下一個狀態。

如果此任務無法在任務動態 AWS Glue 設定的間隔內完成，任務會標記為 failed。

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

任務狀態的登入資料欄位範例

指定硬式編碼的 IAM 角色 ARN

下列範例指定 狀態機器執行角色必須擔任的目標 IAM 角色，才能存取名為 的跨帳戶 Lambda 函數Echo。在此範例中，目標角色 ARN 指定為硬式編碼值。

{
  "StartAt": "Cross-account call",
  "States": {
    "Cross-account call": {
      "Type": "Task",
      "Resource": "arn:aws:states:::lambda:invoke",
      "Credentials": {
        "RoleArn": "arn:aws:iam::111122223333:role/LambdaRole"
      },
      "Parameters": {
        "FunctionName": "arn:aws:lambda:us-east-2:111122223333:function:Echo"
      },
      "End": true
    }
  }
}

將 JSONPath 指定為 IAM 角色 ARN

下列範例指定 JSONPath 值，該值將在執行時間解析為 IAM 角色 ARN。

{
  "StartAt": "Lambda",
  "States": {
    "Lambda": {
      "Type": "Task",
      "Resource": "arn:aws:states:::lambda:invoke",
      "Credentials": {
        "RoleArn.$": "$.roleArn"
      },
      ...
    }
  }
}

將內部函數指定為 IAM 角色 ARN

下列範例使用States.Format內部 函數，在執行時間解析為 IAM 角色 ARN。

{
  "StartAt": "Lambda",
  "States": {
    "Lambda": {
      "Type": "Task",
      "Resource": "arn:aws:states:::lambda:invoke",
      "Credentials": {
        "RoleArn.$": "States.Format('arn:aws:iam::{}:role/ROLENAME', $.accountId)"
      },
      ...
    }
  }
}