本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

重试行为

重试行为包括有关如何尝试从向的 SDKs 请求导致的失败中恢复的设置。 AWS 服务

在standard和adaptive重试模式之间进行选择

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

如果您选择使用adaptive模式，则您的应用程序必须围绕可能受到限制的每种资源构建客户端。在这种情况下，资源要经过精细调整，而不仅仅是考虑每种资源。 AWS 服务 AWS 服务 可以有其他维度来限制请求。让我们以亚马逊 DynamoDB 服务为例。DynamoDB AWS 区域 使用加上正在访问的表来限制请求。这意味着您的代码正在访问的一个表可能比其他表更受限制。如果您的代码使用同一个客户端访问所有表，并且对其中一个表的请求受到限制，则自适应重试模式将降低所有表的请求速率。您的代码应设计为每 Region-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 可能有配置选项可以让请求失败，而不必等待。存储桶中的令牌按照根据客户端收到的限制响应数量动态确定的速率进行充值。

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 指南或源代码进行确认。

Support AWS SDKs by 和工具

以下内容 SDKs 支持本主题中描述的功能和设置。所有部分例外情况均已注明。 适用于 Java 的 AWS SDK 和 AWS SDK for Kotlin 唯一支持任何 JVM 系统属性设置。