從執行中執行啟動新的 AWS Step Functions 狀態機器

Step Functions 整合了自己的 API 做為服務整合。了解如何使用 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 的參數。將 附加.$至 參數名稱，並使用 參考內容物件中的 ID，以傳遞執行 ID$$.Execution.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
}

巢狀狀態機器會傳回下列內容：

兩者都將等待巢狀狀態機器完成，但它們會傳回不同的 Output 格式。例如，如果您建立傳回物件 的 Lambda 函數{ "MyKey": "MyValue" }，您會得到下列回應：

對於 startExecution.sync：

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

對於 startExecution.sync:2：

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

設定巢狀狀態機器的 IAM 許可

父系狀態機器會判斷子系狀態機器是否使用輪詢和事件完成執行。輪詢需要 的許可events:PutRule，states:DescribeExecution而透過 EventBridge 傳送至 Step Functions 的事件需要 events:PutTargets、 和 的許可events:DescribeRule。如果您的 IAM 角色缺少這些許可，在父系狀態機器得知子系狀態機器的執行完成之前，可能會有延遲。

對於StartExecution呼叫單一巢狀工作流程執行的狀態機器，請使用 IAM 政策來限制對該狀態機器的許可。

用於呼叫巢狀 Step Functions 工作流程的 IAM 政策

對於StartExecution呼叫單一巢狀工作流程執行的狀態機器，請使用 IAM 政策來限制對該狀態機器的許可。

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

如需詳細資訊，請參閱下列內容：

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

如需巢狀工作流程執行的詳細資訊，請參閱從 Step Functions 中的任務狀態啟動工作流程執行。