更新亚马逊云科技开发工具包默认值 — 亚马逊云科技 STS 服务终端节点和重试策略

亚马逊云科技软件开发套件 (SDK) 和命令行接口 (CLI) 与默认配置捆绑在一起，该配置经过精心设计，旨在优化可用性和可靠性。两个这样的设置是亚马逊云科技安全令牌服务 (STS) 终端节点和默认重试策略。为了改善亚马逊云科技客户的默认状态，我们将在 2025 年 7 月 31 日更新这两个默认状态。默认亚马逊云科技 STS 服务终端节点将更改为 regional，默认重试策略将更改为 standard。

使用亚马逊云科技 STS 区域终端节点

可以通过区域服务终端节点或全球终端节点访问亚马逊云科技 STS。对全球服务终端节点的请求映射到美国东部（弗吉尼亚北部）区域。虽然大多数亚马逊云科技开发工具包和 CLI 默认为区域服务终端节点，但适用于 Python、PHP、C++、.NET 的亚马逊云科技开发工具包和适用于 PowerShell 的亚马逊云科技工具仍然使用全球服务终端节点。

亚马逊云科技优秀实践是尽可能使用区域终端节点，因为这样就不必进行跨区域调用和区域间依赖关系。2025 年 7 月 31 日，之前列出的软件开发工具包和工具将发布更新，其默认 STS 服务终端节点更改为区域终端节点（regional 设置值）。因此，更新后，客户的行为可能会发生变化。除了亚马逊云科技 CLI v1 之外，其他普遍可用的亚马逊云科技开发工具包和 CLI 已经默认为区域终端节点。您可以在最近的亚马逊云科技 STS 公告中找到有关迁移到区域服务终端节点的详细信息。

对默认重试策略进行现代化改造

2025 年 7 月 31 日，我们将更新适用于 C++、.NET、Java (v2)、PHP、Python、Ruby、亚马逊云科技 PowerShell 工具和亚马逊云科技 CLI (v2) 的亚马逊云科技开发工具包中的默认重试策略为 standard。2020 年 3 月之后发布的亚马逊云科技开发工具包已经默认为 standard 重试策略。

亚马逊云科技开发工具包会重试请求以发现可恢复的故障。2020 年 3 月之前发布的亚马逊云科技开发工具包默认采用 legacy 策略，即使用指数回退。2020 年，亚马逊云科技开发工具包推出了 standard 重试策略，该策略使用代币存储桶限制，为软件开发工具包提供标准化的重试行为。亚马逊的优秀实践是启用客户端重试限制，以提高服务的可用性，同时不影响从间歇性故障中恢复的能力。通过此更改，默认情况下，所有 SDK 客户都将受益于更新后的策略。有关代币存储桶重试的更多信息，请阅读我们关于重试行为的文档。

为变更做准备

我们建议客户在 2025 年 7 月 31 日发布应用程序之前对其应用程序进行测试。客户可以通过选择采用亚马逊云科技 STS 区域终端节点和重试行为中所述的新配置值来实现。我们认识到，适应行为变化需要时间和精力，因此客户可以使用相同的机制先发制人地选择退出变革。为此，可以将每个参数单独设置为 legacy 值。亚马逊云科技建议客户暂时选择退出更改，以便有足够的时间迁移到新的配置值。