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

再試行動作

再試行動作には、SDK が AWS のサービス へのリクエストによる障害からの回復を試みるかに関する設定が含まれます。

standard と adaptive の再試行モードを選択する

使用状況が adaptive に適していることが確実でない限り、standard 再試行モードを使用することをお勧めします。

adaptive モードを使用する場合、アプリケーションはスロットルされる可能性のある各リソースを中心に設計されたクライアントを構築する必要があります。この場合、リソースは、各 AWS のサービスだけについて考えるよりも細かく調整されます。AWS のサービス は、リクエストをスロットルするために使用する追加のディメンションを持つことができます。Amazon DynamoDB サービスを例として使用しましょう。DynamoDB は、AWS リージョンとアクセスされるテーブルを使用してリクエストをスロットルします。つまり、コードがアクセスしている 1 つのテーブルは、他のテーブルよりもスロットルされる可能性があります。コードが同じクライアントを使用してすべてのテーブルにアクセスし、それらのテーブルのいずれかへのリクエストがスロットルされた場合、アダプティブ再試行モードでは、すべてのテーブルのリクエストレートが低下します。コードは、リージョンとテーブルのペアごとに 1 つのクライアントを持つように設計する必要があります。adaptive モードの使用時に予期しないレイテンシーが発生した場合は、使用しているサービス固有の AWS ドキュメントガイドを参照してください。

再試行モードの実装の詳細

AWS SDK はトークンバケットを使用して、リクエストを再試行するかどうか、リクエストの送信速度 (adaptive 再試行モードの場合) を決定します。SDK では、再試行トークンバケットとリクエストレートトークンバケットの 2 つのトークンバケットが使用されます。

以下は、standard と adaptive 再試行モードの両方の大まかな擬似コードです。

MakeSDKRequest() {
  attempts = 0
  loop {
    GetSendToken()
    response = SendHTTPRequest()
    RequestBookkeeping(response)
    if not Retryable(response)
      return response
    attempts += 1
    if attempts >= MAX_ATTEMPTS:
      return response
    if not HasRetryQuota(response)
      return response
    delay = ExponentialBackoff(attempts)
    sleep(delay)
  }
}

擬似コードで使用されるコンポーネントの詳細は次のとおりです。

GetSendToken:

このステップは adaptive 再試行モードでのみ使用されます。このステップでは、リクエストレートトークンバケットからトークンを取得します。トークンが使用できない場合、トークンが利用可能になるまで待機します。SDK には、待機する代わりにリクエストを失敗させる設定オプションが用意されている場合があります。バケット内のトークンは、クライアントが受信したスロットリングレスポンスの数に基づいて動的に決定されるレートで補充されます。

SendHTTPRequest:

このステップでは、リクエストを AWS に送信します。ほとんどの AWS SDK は接続プールを使用する HTTP ライブラリを使用し、HTTP リクエストを行う際に既存の接続を再利用します。一般的に、スロットリングエラーが原因でリクエストが失敗した場合、接続は再利用されますが、一時的なエラーが原因でリクエストが失敗した場合は再利用されません。

RequestBookkeeping:

リクエストが成功すると、トークンがトークンバケットに追加されます。adaptive 再試行モードの場合のみ、リクエストレートトークンバケットのフィルレートは、受信したレスポンスのタイプに基づいて更新されます。

Retryable:

このステップでは、以下に基づいて応答を再試行できるかどうかを判断します。

一時的なエラー（HTTP ステータスコード 400、408、500、502、503、504）とスロットリングエラー（HTTP ステータスコード 400、403、429、502、503、509）はすべて再試行される可能性があります。SDK の再試行動作は、エラーコードまたはサービスからのその他のデータと組み合わせて決定されます。

MAX_ATTEMPTS:

デフォルトの最大試行回数は、max_attempts 設定によって上書きされない限り、retry_mode 設定によって設定されます。

HasRetryQuota

このステップでは、再試行トークンバケットからトークンを取得します。再試行トークンバケットが空の場合、リクエストは再試行されません。

ExponentialBackoff

再試行可能なエラーの場合、再試行遅延は台形型エクスポネンシャルバックオフを使用して計算されます。SDK はジッター付きの切り捨て二進エクスポネンシャルバックオフを使用します。次のアルゴリズムは、i リクエストに対する応答の休止時間（秒単位）がどのように定義されているかを示しています。

seconds_to_sleep_i = min(b*r^i, MAX_BACKOFF)

前述のアルゴリズムでは、以下の値が適用されます。

b = random number within the range of: 0 <= b <= 1

r = 2

ほとんどの SDK では MAX_BACKOFF = 20 seconds です。確認のため、特定の SDK ガイドまたはソースコードを参照してください。

AWS SDK とツールによるサポート

以下の SDK は、このトピックで説明する機能と設定をサポートします。部分的な例外があれば、すべて記載されています。JVM システムプロパティ設定は、AWS SDK for Java と AWS SDK for Kotlin でのみサポートされます。