Step Functions で redrive を使用してステートマシン実行を再開する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

redrive を使用して、過去 14 日間に正常に完了しなかった Standard ワークフローの実行を再開できます。これには、失敗した、中止された、またはタイムアウトした実行が含まれます。

redrive 実行時、Step Functions は失敗したステップから失敗した実行を続行し、同じ入力を使用します。 は成功したステップの結果とredrive実行履歴Step Functionsを保持しますが、実行時に再実行されることはありません。例えば、ワークフローに 2 つの状態、1 つは Pass ワークフロー状態 状態、もう 1 つはそれに続く Task ワークフロー状態 状態です ワークフローの実行が Task 状態で失敗し、実行を redrive すると、実行のスケジュールが再設定され、Task 状態が再実行されます。

再処理された実行では、元の実行試行に使用されたのと同じステートマシン定義と実行 ARN が使用されます。元の実行試行がバージョン、エイリアス、あるいはその両方に関連付けられていた場合、redriven された実行は同じバージョン、エイリアス、または両方に関連付けられます。エイリアスを別のバージョンを指すように更新しても、再処理された実行には元の実行試行に関連付けられたバージョンが使用され続けます。再処理された実行では同じステートマシン定義が使用されるため、ステートマシン定義を更新した場合は新しい実行を開始する必要があります。

実行を再処理すると、ステートマシンレベルのタイムアウト (定義されている場合) は 0 にリセットされます。ステートマシンレベルのタイムアウトの詳細については、「TimeoutSeconds」を参照してください。

実行の再処理は状態遷移と見なされます。状態遷移が課金に及ぼす影響については、‭‬Step Functions コスト‭を参照してください。

失敗した実行の再処理対象

最初に試みた実行が以下の条件を満たしていれば、実行を再処理することができます。

個々の状態の再処理動作

ワークフローで失敗した状態によって、失敗したすべての状態の再処理動作は異なります。次の表では、すべての状態に対する再処理動作について説明します。

実行を再処理する IAM アクセス許可

Step Functions には、実行を再処理するための適切なアクセス許可が必要です。次の IAM ポリシー例では、実行を再処理するためにステートマシンに必要な最小限の権限を付与します。イタリック体のテキストを、リソース固有の情報に必ず置き換えてください。

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

マップ実行の再処理に必要なアクセス許可の例については、「分散マップの IAM redriving ポリシーの例」を参照してください。

コンソールでの実行の再処理

Step Functions コンソールから対象となる redrive の実行を再処理できます。

例えば、ステートマシンを実行し、並列状態が実行に失敗するとします。

次の図は、並列状態内の Do 二乗数 という名前のLambda呼び出しステップが戻り、失敗したことを示しています。このため、[Parallel] ステートも失敗しました。実行が進行中または開始されていないブランチは停止し、ステートマシンの実行は失敗します。

API を使用した実行の再処理

RedriveExecution API を使用して対象の実行をredrive できます。この API は、標準ワークフローの実行に失敗した場合に、失敗、中止、またはタイムアウトになったステップから再開します。

AWS Command Line Interface （AWS CLI) で、次のコマンドを実行してステートマシンの実行redriveが失敗します。イタリック体のテキストを、リソース固有の情報に必ず置き換えてください。

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

再処理された実行内容を調べる

再処理された実行内容はコンソールで調べることも、GetExecutionHistory および DescribeExecution という API を使って調べることもできます。

API を使用して再処理された実行内容を調べる

ステートマシンの実行を再処理した、次の API のいずれかを使用して再処理された実行に関する詳細を表示できます。イタリック体のテキストを、リソース固有の情報に必ず置き換えてください。

再処理された実行の再試行動作

再試行を定義した、Task ワークフロー状態、Parallel ワークフローの状態、または インラインマップステートを redriven で再実行すると、redrive での再試行回数が最大になるように、これらのステートの再試行回数は 0 にリセットされます。redriven 実行では、コンソールを使用してこれらのステートでの再試行を個別に追跡できます。

以下のイメージは、元の実行試行時とその実行の再処理時のステートに対して実行された再試行の例を示しています。この図では、元の試行と実行の再処理試行で 3 回の再試行が行われています。4 回目の再処理試行で成功し、16 という出力が返されます。