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

重試行為

重試行為包括 SDKs 如何嘗試從對 提出的請求所產生的失敗中復原的設定 AWS 服務。

選擇 standard和 adaptive 重試模式

我們建議您使用standard重試模式，除非您確定您的用量更適合 adaptive。

如果您選擇使用 adaptive 模式，您的應用程式必須建構以每個可能節流的資源為中心的用戶端。在這種情況下，資源的微調比只考慮每個資源更精細 AWS 服務。 AWS 服務 可以具有用於調節請求的其他維度。讓我們使用 Amazon DynamoDB 服務做為範例。DynamoDB 使用 AWS 區域 加上要存取的資料表來調節請求。這表示您的程式碼存取的一個資料表可能會受到比其他資料表更多的調節。如果您的程式碼使用相同的用戶端存取所有資料表，且對其中一個資料表的請求受到調節，則適應性重試模式將降低所有資料表的請求率。您的程式碼應設計成每個Region-and-table對有一個用戶端。如果您在使用 adaptive 模式時遇到意外延遲，請參閱您正在使用服務的特定 AWS 文件指南。

重試模式實作詳細資訊

AWS SDKs 會使用字符儲存貯體來決定是否應重試請求，以及 （在adaptive重試模式下） 應傳送請求的速度。軟體開發套件會使用兩個字符儲存貯體：重試字符儲存貯體和請求速率字符儲存貯體。

以下是 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 SDKs使用 HTTP 程式庫，該程式庫使用連線集區在提出 HTTP 請求時重複使用現有的連線。一般而言，如果請求因限流錯誤而失敗，但請求因暫時性錯誤而失敗，則會重複使用連線。

RequestBookkeeping:

如果請求成功，權杖會新增至權杖儲存貯體。僅針對adaptive重試模式，請求速率字符儲存貯體的填充速率會根據收到的回應類型更新。

Retryable:

此步驟會根據下列項目決定是否可以重試回應：

暫時性錯誤 (HTTP 狀態碼 400、408、500、502、503 和 504) 和限流錯誤 (HTTP 狀態碼 400、403、429、502、503 和 509) 都可以重試。SDK 重試行為是結合錯誤代碼或服務的其他資料來決定。

MAX_ATTEMPTS:

除非由 retry_mode 設定覆寫，否則預設的嘗試次數上限會由 max_attempts設定設定。

HasRetryQuota

此步驟會從重試權杖儲存貯體取得權杖。如果重試權杖儲存貯體是空的，則不會重試請求。

ExponentialBackoff

對於可以重試的錯誤，系統會使用截斷的指數退避來計算重試延遲。SDKs使用截斷的二進位指數退避與抖動。下列演算法顯示如何為請求 的回應定義睡眠時間，以秒為單位i：

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

在上述演算法中，適用下列值：

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

r = 2

MAX_BACKOFF = 20 seconds 適用於大多數 SDKs。請參閱您的特定 SDK 指南或原始程式碼進行確認。

支援 AWS SDKs和工具

下列 SDKs 支援本主題中所述的功能和設定。會記下任何部分例外狀況。 適用於 Java 的 AWS SDK 和 適用於 Kotlin 的 AWS SDK 僅支援任何 JVM 系統屬性設定。