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

重試行為

重試行為包括有關SDKs嘗試從失敗中復原的設定 AWS 服務.

選擇standard和adaptive重試模式

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

如果您選擇使用adaptive模式，您的應用程式必須建構圍繞可能限制的每個資源所設計的用戶端。在這種情況下，資源比只是思考每個資源更精細地調整 AWS 服務. AWS 服務 可以有額外的維度，它們用來限制請求。讓我們以 Amazon DynamoDB 服務為例。DynamoDB 使用 AWS 區域 加上被訪問的表以節流請求。這意味著您的代碼正在訪問的一個表可能比其他表進行限制。如果您的程式碼使用相同的用戶端來存取所有資料表，且對其中一個資料表的要求會受到限制，則調適性重試模式會降低所有資料表的要求率。您的代碼應該設計為每個 R egion-and-table 對有一個客戶端。如果您在使用adaptive模式時遇到意外延遲，請參閱具體內容 AWS 您所使用之服務的文件指南。

重試模式實施細節

所以此 AWS SDKs利用令牌桶來決定是否應該重試請求以及（在adaptive重試模式的情況下）應該多快地發送請求。兩個令牌存儲桶由使用SDK：重試令牌存儲桶和請求率令牌存儲桶。

以下是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可能有配置選項可以使請求失敗，而不是等待。值區中的 Token 會根據用戶端收到的節流回應數量，以動態決定的速率重新填入。

SendHTTPRequest:

此步驟會將要求傳送至 AWS。 最多 AWS SDKs使用使用連線集區的程式HTTP庫，在提出HTTP要求時重複使用現有連線。一般而言，如果要求因為節流錯誤而失敗，但如果要求因暫時性錯誤而失敗，則會重複使用連線。

RequestBookkeeping:

如果請求成功，令牌將添加到令牌存儲桶中。僅對於adaptive重試模式，請求率 Token 存儲桶的填充率會根據收到的響應類型更新。

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支援本主題中描述的功能與設定。注意到任何部分例外情況。任何JVM系統屬性設定都受到 AWS SDK for Java 和 適用於 Kotlin 的 AWS SDK 只有。