再試行ポリシー

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：4分

    • ステップでネットワーク障害や要求レート制限などの断続的な問題が発生した際は、失敗した要求を自動で再試行します。ステップを手動で再トリガーする必要がないように、再試行ポリシーを設定します。

    機能

    再試行ポリシーは次のとおりです。
    • ヘッダー、ステータス、応答本文、エラー、および HTTP メソッドに基づいて、接続タイムアウトまたは失敗した要求をサポートするために作成されます。
    • 指定された接続エイリアスを使用するすべてのアクションに適用されます。
    • アクションステップに直接適用されます。
    再試行ポリシーを使用して以下を定義します。
    • ステップを再試行するために満たす必要がある条件。
    • ステップを再試行する前に待機する時間間隔。
    • ステップが停止するまでの最大再試行回数。
    デフォルトの再試行ポリシーを接続および資格情報エイリアスに関連付け、再試行ポリシーをすべての HTTP 接続に適用します。
    注:
    JDBC、REST、SOAP ステップの再試行ポリシーのみ作成できます。

    再試行ポリシーの作成

    ステップでネットワーク障害や要求レート制限などの断続的な問題が発生した際は、失敗した要求を自動で再試行します。ステップを手動で再トリガーする必要がないように、再試行ポリシーを設定します。

    始める前に

    • 必要なロール：connection_admin または credential_admin

    手順

    1. 移動先 すべて > 統合ハブ > 再試行ポリシー > 新規作成.
    2. フォームで、フィールドに入力します。
      表 : 1. 再試行ポリシーフォーム
      フィールド 説明
      名前 再試行ポリシーを一意に識別する名前。
      接続タイプ HTTP
      条件 再試行ポリシーをトリガーするために満たす必要がある条件。再試行ポリシーをトリガーする条件には、is、is not、contains、contains not 演算子があります。
      再試行戦略
      • 指数バックオフ (Exponential Backoff)：後続の再試行の時間間隔を指数関数的に増やすオプション。乗数は 2 です。
      • 固定間隔 (Fixed Interval)：この時間間隔を過ぎると再試行が必要になる固定時間間隔を指定するオプション。
      • 「Retry-After」ヘッダーを優先 (Honor "Retry-After" Header)：HTTP 要求の「Retry After」ヘッダー値で返された日付と時刻の値に基づいて再試行を指定するオプション。ヘッダーの詳細については、「RFC 7231、セクション 7.1.3：Retry-After」を参照してください。
        注:
        「Retry-After」ヘッダーを優先 (Honor "Retry-After" Header)は、REST ステップと SOAP ステップのみをサポートします。
      間隔 (秒) この時間間隔を過ぎると再試行が必要になる時間間隔 (秒)。このフィールドは、[指数バックオフ] および [固定間隔] の再試行戦略にのみ適用されます。
      注:
      [再試行戦略] が [指数バックオフ (Exponential Backoff)] の場合、最大試行回数に達するまで再試行するたびに時間間隔が指数関数的に増加します。
      カウント 再試行の最大回数。このフィールドは、[指数バックオフ] および [固定間隔] の再試行戦略にのみ適用されます。値を指定しない場合、最大再試行回数は glide.fdih.retry.max_count システムのプロパティに指定された値に基づきます。glide.fdih.retry.max_count システムのプロパティのデフォルト値は 0 です。システムのプロパティの詳細については、「利用可能なシステムのプロパティ」を参照してください。
      最大経過時間 (秒) 再試行が停止されるまでの最大累積時間 (秒)。このフィールドは、[Retry-After ヘッダーを優先] が、[再試行戦略] から選択されている場合にのみ表示されます。
      注:
      最大再試行時間が glide.fdih.retry.max_time_in_seconds プロパティに指定されている場合、システムプロパティ値がこのフィールド値よりも優先されます。また、最大経過時間がシステムプロパティ値に等しいか、それを超えていることを確認します。
    3. オプション: 次の属性を持つグローバルシステムプロパティを作成します。
      プロパティの作成方法の詳細については、「システムプロパティを追加する」を参照してください。このシステムプロパティを使用して、再試行ポリシーの最大時間を秒単位で指定できます。
      フィールド 値
      名前 glide.fdih.retry.max_time_in_seconds
      タイプ 整数
      値 デフォルト値：86400 (秒) 最大サポート時間：604800 (秒)
    4. [送信] をクリックします。

    [再試行戦略] が [指数バックオフ (Exponential Backoff)] の再試行ポリシー

    図 : 1. サンプル再試行ポリシー
    [再試行戦略] が [指数バックオフ] のサンプル再試行ポリシー
    この例では、次のいずれかの条件が満たされたときに再試行するようにポリシーが定義されています。
    • [HTTP メソッド] が [GET] で、[エラー] が [接続タイムアウト]
    • [HTTP メソッド] が [GET] で、[ステータスコード] が [429]
    条件が満たされると、最大 3 回の再試行が実行されます。再試行の時間間隔は指数関数的に増加します。この例の時間間隔は 10 秒、20 秒、および 40 秒です。

    次のタスク

    • 必要なエイリアスがない場合は、接続および資格情報エイリアスを作成します。
    • 再試行ポリシーを [デフォルトの再試行ポリシー (Default Retry Policy)] として、必要な接続および資格情報エイリアスにアサインします。
      注:
      デフォルトの再試行ポリシーが提供され、[デフォルトの再試行ポリシー (Default Retry Policy)] として選択されます。再試行ポリシーを作成した場合は、必要なポリシーを [デフォルトの再試行ポリシー (Default Retry Policy)] として選択できます。
    • 接続および資格情報エイリアスの接続関連リストに HTTP(s) 接続を作成します。詳細については、「接続および認証情報」を参照してください。
    • 次に移動して、再試行の詳細を確認および表示します: システムログ > 送信 HTTP 要求.