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

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

重试行为

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

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

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

如果您选择使用adaptive模式，则您的应用程序必须围绕可能受到限制的每种资源构建客户端。在这种情况下，对资源的调整要比仅仅考虑每种资源都要精细 Amazon Web Services 服务. Amazon Web Services 服务 可以有其他维度来限制请求。让我们以亚马逊 DynamoDB 服务为例。DynamoDB 使用 Amazon Web Services 区域 再加上用于限制请求的访问表。这意味着您的代码正在访问的一个表可能比其他表更受限制。如果您的代码使用同一个客户端访问所有表，并且对其中一个表的请求受到限制，则自适应重试模式将降低所有表的请求速率。您的代码应设计为每个 R egion-and-table 对都有一个客户端。如果您在使用adaptive模式时遇到意外延迟，请参阅具体的 Amazon 您正在使用的服务的文档指南。

重试模式实现细节

这些区域有： Amazon 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:

此步骤将请求发送到 Amazon。 大多数 Amazon 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指南或源代码进行确认。

与之兼容 Amazon SDKs

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