View a markdown version of this page

的协议支持变更 AWS 服务客户 - AWS 软件开发工具包和工具
协议支持变更的服务客户端常见问题

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

的协议支持变更 AWS 服务客户

AWS SDK 处理与服务通信时用于序列化请求和反序列化响应的有线协议。 AWS 如果您的 SDK 客户端支持此更改，则您的应用程序会自动使用更新后的协议，无需更改代码。协议支持更改不会更改模型化服务 API。但是，依赖于特定线路表示的应用程序和基础架构可能需要测试或更新。

协议支持变更的服务客户端

下表列出了已发布的 AWS 服务客户端协议支持变更。表中存在服务并不意味着每个 AWS SDK 或服务客户端版本都包含该更改。更新之前，请查看适用的 SDK 发行说明和特定服务文档，了解支持的 SDK、版本、协议和。 AWS 区域

从适用的 SDK 版本说明中确定的 SDK 和服务客户端版本开始，已发布的支持可供生产使用。

已发布的客户

下表中的所有版本链接都指向 GitHub 网站上的发布页面。

服务 发行日期 更改 AWS CLI v2 C++ Go v2 Java v2 JavaScript v3 Kotlin .NET v4 PHP v3 Python-boto3 Python-botocore Ruby v3 Rust Swift
亚马逊 CloudWatch 应用程序洞察 2026 年 7 月 24 日 优先选择 RPC v2 CBOR 而不是 JSON 1.0 AWS 2.36.8 1.11.855 1.38.0 2.49.3 3.1095.0 1.8.14 4.0.101.0 3.389.0 1.43.56 1.43.56 1.83.0 1.107.0 1.7.46
2026 年 7 月 23 日 优先选择 RPC v2 CBOR 而不是 JSON 1.0 AWS 2.36.7 1.11.854
2.49.2 3.1094.0 1.8.13
3.388.13 1.43.55 1.43.55
1.7.45
亚马逊 SES 邮件管理器 2026 年 7 月 6 日 优先选择 RPC v2 CBOR 而不是 JSON 1.0 AWS 2.35.16 1.11.840 1.20.0 2.47.0 3.1080.0 1.6.107 4.0.101.0 3.387.3 1.43.41 1.43.41 1.46.0 1.89.0 1.7.31
2026 年 4 月 21 日 优先选择 RPC v2 CBOR 而不是 JSON 1.0 AWS 2.34.34 1.11.794
2.42.38 3.1034.0 1.6.61
3.379.4 1.42.93 1.42.93
1.6.99
CloudWatch 2025 年 12 月 10 日 优先选择 AWS JSON 1.0 或 RPC v2 CBOR 而不是查询 AWS 2.32.14 1.11.708 1.53.0 2.40.6 3.949.0 1.5.100 4.0.150.0 3.367.0 1.42.7 1.42.7 1.126.0 1.100.0 1.6.14
Amazon SQS 2023 年 11 月 8 日 优先选择 AWS JSON 1.0 而不是 AWS 查询 不适用 1.11.198 1.27.0 2.21.18 3.446.0 0.34.2-测试版 不适用 3.285.1 1.28.81 1.31.81 1.66.0 不适用 不适用

常见问题

一般问题

什么是协议支持变更？

协议支持变更更新了支持的 SDK 客户端在与服务通信时对请求进行编码和解码响应的 AWS 方式。此更改可以添加协议或更改客户端选择的协议。它不会更改通过 SDK 的公共 API 公开的服务操作。

我需要更改我的申请吗？

大多数使用受支持的 AWS SDK 客户端的应用程序不需要更改代码。根据发行说明更新 SDK 客户端，并使用正常的集成和部署流程测试更新。

如果您的应用程序或基础架构依赖于特定的线路表示，请更仔细地查看更新。示例包括检查或修改请求和响应正文的中间件或代理、记录的 HTTP 固定装置以及比较序列化有效负载的测试。

在哪里可以更改协议支持？

可用性可能因服务、SDK AWS 区域、服务客户端版本和协议而异。使用与表格条目相关的服务特定文档和适用的 SDK 发行说明来验证可用性。

现有协议会怎样？

协议支持变更本身并不会宣布现有服务协议的弃用。关注特定服务的公告、SDK 发行说明以及AWS SDK 和工具维护政策获取支持和生命周期信息。

Smithy RPC v2 CBOR 问题

什么是 Smithy RPC v2 CBOR？

Smithy RPC v2 CBOR 使用简明二进制对象表示 (CBOR)（一种紧凑的二进制数据格式）对请求和响应进行编码。与基于文本的 JSON 编码相比，二进制编码可以减少编码的有效负载大小和序列化开销。实际性能因服务操作、负载、SDK、运行时和网络条件而异。在 Smithy 网站上阅读有关 Smithy RPC v2 CBOR 协议的更多信息。

如果我的应用程序无法使用 Smithy RPC v2 CBOR 怎么办？

更新之前，请测试与协议相关的集成，并查看适用的 SDK 发行说明以获取兼容性或备用指导。如果问题无法采用，请在更新受影响的集成时继续使用符合您要求的受支持客户端版本。避免依赖不受支持的 SDK 版本作为长期解决方案。