Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

重试行为

重试行为包括有关 SDK 如何尝试从向 Amazon Web Services 服务 发出的请求而导致的失败中恢复的设置。

可选择 standard 和 adaptive 重试模式

除非您确定自己的使用情况更适合 adaptive，否则我们建议您使用 standard 重试模式。

如果选择使用 adaptive 模式，则应用程序构建的客户端必须围绕每种可能被节流的资源设计。在这种情况下，资源须经精细调整，而非仅仅是考虑每个 Amazon Web Services 服务。Amazon Web Services 服务 可能存在用来对请求节流的其他维度。下面以 Amazon DynamoDB 服务为例说明。DynamoDB 使用 Amazon Web Services 区域 和正在访问的表来进行请求节流。这意味着代码正在访问的一个表受到的节流可能比其他表更大。如果代码使用同一客户端来访问所有表，并且对其中一个表的请求受到节流，则自适应重试模式将降低所有表的请求速率。代码的设计应确保每个区域表对都有一个客户端。如果在使用 adaptive 模式时遇到预料之外的延迟，请参阅所用服务的具体 Amazon 文档指南。

重试模式实现详情

Amazon SDK 使用令牌存储桶来决定是否应重试请求以及（对于 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 可能会提供让请求失败，而不必等待的选项。该存储桶中的令牌将根据客户端收到的节流响应数，以动态确定的速率补充。

SendHTTPRequest:

此步骤会将请求发送到 Amazon。大多数 Amazon SDK 使用一个使用连接池的 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

对于可以重试的错误，使用截断的指数回退来计算重试延迟。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 指南或源代码进行确认。

Amazon SDK 和工具支持

以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。任何 JVM 系统属性设置都仅支持 适用于 Java 的 Amazon SDK 和 适用于 Kotlin 的 Amazon SDK。