本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
重试行为
重试行为包括有关软件开发工具包如何尝试从因向其发出的请求而导致的失败中恢复的设置Amazon Web Services。
使用以下方法配置此功能：
max_attempts-共享Amazonconfig文件设置AWS_MAX_ATTEMPTS-环境变量-
指定对请求进行的最大尝试次数。
默认值：如果未指定此值，则其默认值取决于的值
retry_mode设置：-
如果
retry_mode是legacy— 使用特定于你的 SDK 的默认值（请查看你的特定 SDK 指南或 SDK 的代码库以了解max_attempts默认）。 -
如果
retry_mode是standard— 尝试三次。 -
如果
retry_mode是adaptive— 尝试三次。
有效值：大于 0 的数字。
-
retry_mode-共享Amazonconfig文件设置AWS_RETRY_MODE-环境变量-
指定 SDK 或开发者工具如何尝试重试。
默认值：
legacy是默认的重试策略。有效值：
-
legacy— 特定于您的 SDK（请查看您的特定 SDK 指南或 SDK 的代码库）。 -
standard— 跨越的标准重试规则集Amazon软件开发工具包。此模式包括一组标准的重试错误，并支持重试配额。此模式下默认的最大尝试次数为三次，除非max_attempts已显式配置。 -
adaptive— 一种实验性重试模式，包括标准模式的功能，但包括自动客户端限制。由于此模式是实验性的，因此将来可能会改变行为。
-
以下是两者的高级伪代码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软件开发工具包使用使用连接池的 HTTP 库，这样您就可以在发出 HTTP 请求时重复使用现有连接。通常，由于限制错误，在重试请求时会重复使用连接。由于暂时性错误，在重试时不会重复使用请求。
RequestBookkeeping:
如果请求成功，则应更新重试配额。对于adaptive仅限重试模式，状态变量maxsendrate根据收到的响应类型进行更新。
Retryable:
此步骤根据以下内容确定是否可以重试响应：
-
HTTP 状态代码 。
-
从服务返回的错误代码。
-
连接错误，定义为 SDK 收到的任何错误，其中未收到来自服务的 HTTP 响应。
临时错误（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
MAX_BACKOFF = 20 seconds对于大多数 SDK。请参阅您的特定 SDK 指南或源代码进行确认。
兼容AmazonSDKS
以下 SDK 支持本页上描述的功能和设置，但请注意部分例外情况：