Redriving Step Functions 執行中的映射執行

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

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

您可以在由redriving父工作流程執行的映射中重新啟動失敗的子工作流程執行。 重要用語redriven 父工作流程redrives所有失敗狀態，包括分散式映射。如果父工作流程完成其執行時，沒有事件<stateType>Exited對應至狀態<stateType>Entered的事件，則父工作流程會重新驅動失敗狀態。例如，如果事件歷史記錄不包含MapStateEntered事件MapStateExited的事件，您可以在 Map Run redrive 中將父工作流程傳送至redrive所有失敗的子工作流程執行。

當狀態機器沒有存取 ItemReader （地圖）、 或兩者所需的許可時ResultWriter （地圖），未啟動映射執行，或在原始執行嘗試中失敗。如果未在父工作流程的原始執行嘗試中啟動 Map Run，redriving父工作流程會首次啟動 Map Run。若要解決此問題，請將必要的許可新增至您的狀態機器角色，然後redrive是父工作流程。如果您redrive父工作流程未新增必要的許可，它會嘗試啟動新的 Map Run Run，這會再次失敗。如需您可能需要之許可的相關資訊，請參閱 使用分散式地圖狀態的 IAM 政策。

Redrive Map Run 中子工作流程的資格

如果符合下列條件redrive，您可以在 Map Run 中執行失敗的子工作流程：

新的 Map Run 已啟動，且現有的 Map Run 不在下列情況下redriven，即使 Map Run 在原始執行嘗試中失敗：

即使父工作流程停止或逾時，Map Run 仍可繼續執行。在這些情況下， redrive不會立即發生：

在這些情況下，執行中的 Map Run 會在嘗試 之前完成其操作redrive。

子工作流程執行redrive行為

Map Run 中的redriven子工作流程執行會示範如下表所述的行為。

如果您有 redriven Map Run，且已達到其並行限制，則該 Map Run 中的子工作流程執行會轉換為待定狀態。Map Run 的執行狀態也會轉換為待定redrive狀態。在指定的並行限制允許執行更多子工作流程執行之前，執行會保持在待redrive定狀態。

例如，假設工作流程中分散式映射的並行限制為 3000，而要重新執行的子工作流程數量為 6000。這會導致 3000 個子工作流程平行執行，而剩餘的 3000 個工作流程仍處於待重新驅動狀態。第一批 3000 個子工作流程完成執行後，剩餘的 3000 個子工作流程就會執行。

當 Map Run 已完成其執行或中止時，處於待redrive定狀態的子工作流程執行計數會重設為 0。

Map Run 使用的輸入案例 redrive

根據您在原始執行嘗試中向分散式映射提供輸入的方式，redriven映射執行將使用輸入，如下表所述。

Map Run redrive的 IAM 許可

Step Functions redrive 需要 Map Run 的適當許可。下列 IAM 政策範例會將 redriving Map Run 所需的最低權限授予您的狀態機器。請記得將斜體文字取代為您的資源特定資訊。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:RedriveExecution"
      ],
      "Resource": "arn:aws:states:us-east-2:123456789012:execution:myStateMachine/myMapRunLabel:*"
    }
  ]
}

Redriving 主控台中的映射執行

下圖顯示包含分散式映射之狀態機器的執行圖。此執行失敗，因為 Map Run 失敗。若要執行redrive映射，您必須redrive父工作流程。

在 redriven Map Run 之後，您可以在 主控台或使用 GetExecutionHistory 和 DescribeExecution API 動作來檢查其redrive詳細資訊。如需檢查redriven執行的詳細資訊，請參閱 檢查redriven執行。

Redriving 使用 API 的映射執行

您可以在父工作流程上使用 RedriveExecution API redrive進行合格的 Map Run。此 API 會在 Map Run 中重新啟動失敗的子工作流程執行。

在 AWS Command Line Interface (AWS CLI) 中redrive，對失敗的狀態機器執行執行執行下列命令。請記得將斜體文字取代為您的資源特定資訊。

aws stepfunctions redrive-execution --execution-arn arn:aws:states:us-east-2:123456789012:execution:myStateMachine:foo

redriven 完成 Map Run 之後，您可以在 主控台或使用 DescribeMapRun API 動作來檢查其redrive詳細資訊。若要檢查 Map Run 中標準工作流程執行redrive的詳細資訊，您可以使用 GetExecutionHistory 或 DescribeExecution API 動作。如需檢查redriven執行的詳細資訊，請參閱 檢查redriven執行。

如果您已在父工作流程上啟用記錄功能，則可以在 Step Functions 主控台的 Map Run 中檢查快速工作流程執行redrive的詳細資訊。如需詳細資訊，請參閱使用 CloudWatch Logs 記錄 Step Functions 中的執行歷史記錄。