エラー処理 - AWS Step Functions

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

エラー処理

デフォルトでは、ステートでエラーが報告されると、Step Functions の実行全体が失敗します。アクションといくつかのフロー状態については、Step Functions のエラー処理方法を設定できます。エラー処理を設定した場合でも、一部のエラーによってワークフロー実行が失敗する可能性があります。詳細については、「Step Functions のエラー処理」を参照してください。Workflow Studio で、エラー処理を Inspector パネルの [エラー処理] タブで設定します。


        エラー処理オプション

エラーを再試行

1 つ以上のルールをアクション状態と 並行 フロー状態に追加し、エラーが発生したときにタスクを再試行できます。これらのルールは retriers と呼ばれます。retrier を追加するには、[Retrier #1] ボックスで編集アイコンを選択し、そのオプションを設定します。

  • (オプション) [コメント] フィールドで、コメントを追加します。ワークフローには影響しませんが、ワークフローに注釈を付けるために使用できます。

  • [エラー] フィールドにカーソルを置き、retrier をトリガーするエラーを選択するか、カスタムエラー名を入力します。複数のエラーを選択または追加できます。

  • (オプション) [Interval] (間隔) を設定します。これは、Step Functions が最初の再試行を行うまでの秒単位の時間です。追加の再試行は、[Max attempts] (最大試行回数) と [Backoff rate] (バックオフ率) で設定できる間隔の後で行われます。

  • (オプション) [Max attempts] (最大試行回数) を設定します。これは、Step Functions の実行が失敗するまでの最大再試行回数です。

  • (オプション) [Backoff rate] (バックオフ率) を設定します。これは、試行ごとに再試行間隔がどのくらい増加するかを決定する乗数です。

注記

どんなエラー処理オプションでも、あらゆる状態で利用できるわけではありません。Lambda Invoke には、デフォルトで retrier が 1 つが設定されています。

エラーの捕捉

1 つ以上のルールをアクション状態に追加し、エラーをキャッチするため、並行マッピング フロー状態に追加できます。これらのルールは catchers と呼ばれます。キャッチャーを追加するには、[Add new catcher] (新しいキャッチャーの追加) を選択し、そのオプションを設定します。

  • (オプション) [コメント] フィールドで、コメントを追加します。ワークフローには影響しませんが、ワークフローに注釈を付けるために使用できます。

  • [エラー] フィールドにカーソルを置き、catcher をトリガーするエラーを選択するか、カスタムエラー名を入力します。複数のエラーを選択または追加できます。

  • [フォールバック状態] フィールドで、フォールバック状態を選択します。これは、エラーがキャッチされた後にワークフローが次へと移動する状態です。

  • (オプション) ResultPathフィールドに、ResultPath元の状態入力にエラーを追加するフィルターを追加します。ResultPathは有効でなければなりませんJsonPath。これはフォールバック状態に送信されます。

タイムアウト

アクション状態のタイムアウトを設定して、失敗する前に状態を実行できる最大秒数を設定できます。タイムアウトを使用して実行のスタックを回避する タイムアウトを設定するには、実行が失敗するまでの状態の待機秒数を入力します。タイムアウトの詳細については、タスク ステートの「TimeoutSeconds」を参照してください。

HeartbeatSeconds

ハートビートまたは、タスクから定期的に送信される通知を設定できます。ハートビート間隔を設定し、設定された間隔で状態がハートビート通知を送信しない場合、タスクは失敗としてマークされます。ハートビートを設定するには、0 以外の正の整数の秒数を設定します。詳細については、タスク ステートの「HeartBeatSeconds」を参照してください。