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

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

重试行为

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

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

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

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

重试模式实现细节

以下是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 客户端可配置为快速失败请求或在令牌可用之前进行阻止。

客户端速率限制是一种算法，它最初允许以不超过令牌限额的任何速率发出请求。但是，在检测到受限的响应后，客户端就会 rate-of-request 受到相应的限制。如果收到成功的响应，令牌限额也会相应增加。

通过自适应速率限制，SDK 可以降低请求的发送速率，以便更好地容纳的 Amazon Web Services容量。

SendHTTPRequest:

大多数 Amazon SDK 使用使用连接池的 HTTP 库，这样您就可以在发出 HTTP 请求时重复使用现有连接。通常，由于节流错误，在重试请求时会重复使用连接。由于瞬时错误，在重试时不会重复使用请求。

RequestBookkeeping:

如果请求成功，则应更新重试配额。仅在adaptive重试模式下，状态变量 maxsendrate 会根据收到的响应类型进行更新。

Retryable:

此步骤根据以下内容确定是否可以重试响应：

瞬时错误（HTTP 状态代码 400、408、500、502、503 和 504）和节流错误（HTTP 状态代码 400、403、429、502、503 和 509）都可能被重试。SDK 重试行为是结合错误代码或服务中的其他数据确定的。

MAX_ATTEMPTS:

由config文件设置或环境变量指定。

HasRetryQuota

此步骤要求在重试配额桶中提供令牌，从而节流重试请求。重试配额桶是一种防止不太可能成功的重试的机制。这些配额依赖于 SDK，通常依赖于客户端，有时甚至依赖于服务端点。当请求由于各种原因失败时，可用的重试配额令牌将被移除，并在请求成功时补充。当没有剩余令牌时，将退出重试循环。

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 支持本主题中所述的功能和设置。所有部分例外情况均已注明。 Amazon SDK for Java 和 Amazon SDK for Kotlin 唯一支持任何 JVM 系统属性设置。