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

# 的协议支持变更 Amazon 服务客户
<a name="service-protocol-updates"></a>

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

## 协议支持变更的服务客户端
<a name="service-protocol-updates-clients"></a>

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

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

### 已发布的客户
<a name="service-protocol-updates-released-clients"></a>

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


| 服务 | 发行日期 | 更改 | Amazon CLI v2 | C\+\+ | Go v2 | Java v2 | JavaScript v3 | Kotlin | .NET v4 | PHP v3 | Python-boto3 | Python-botocore | Ruby v3 | Rust | Swift | 
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | 
| [亚马逊 CloudWatch 应用程序洞察 ](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/appinsights-what-is.html) | 2026 年 7 月 24 日 | 优先选择 RPC v2 CBOR 而不是 JSON 1.0 Amazon  | [2.36.8 ](https://github.com/aws/aws-cli/releases/tag/2.36.8) | [1.11.855 ](https://github.com/aws/aws-sdk-cpp/releases/tag/1.11.855) | [1.38.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fapplicationinsights%2Fv1.38.0) | [2.49.3 ](https://github.com/aws/aws-sdk-java-v2/releases/tag/2.49.3) | [3.1095.0 ](https://github.com/aws/aws-sdk-js-v3/releases/tag/v3.1095.0) | [1.8.14 ](https://github.com/aws/aws-sdk-kotlin/releases/tag/v1.8.14) | [4.0.101.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.296.0) | [3.389.0 ](https://github.com/aws/aws-sdk-php/releases/tag/3.389.0) | [1.43.56 ](https://github.com/boto/boto3/releases/tag/1.43.56) | [1.43.56 ](https://github.com/boto/botocore/releases/tag/1.43.56) | [1.83.0 ](https://github.com/aws/aws-sdk-ruby/commit/6c2627d6090ae71c324b6b477f4120f1a44f313d) | [1.107.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-07-24) | [1.7.46 ](https://github.com/awslabs/aws-sdk-swift/releases/tag/1.7.46) | 
|  + [Amazon Kendra Intelligent Ranking](https://docs.amazonaws.cn/kendra/latest/dg/cbor-faq.html)<br />+ [亚马逊 WorkSpaces 应用程序 ](https://docs.amazonaws.cn/appstream2/latest/developerguide/cbor-faq.html)<br />+ [Amazon 备份网关 ](https://docs.amazonaws.cn/aws-backup/latest/devguide/cbor-faq.html)<br />+ [亚马逊 WorkSpaces 实例 ](https://docs.amazonaws.cn/workspaces-core/latest/pg/cbor-faq.html)  | 2026 年 7 月 23 日 | 优先选择 RPC v2 CBOR 而不是 JSON 1.0 Amazon  | [2.36.7 ](https://github.com/aws/aws-cli/releases/tag/2.36.7) | [1.11.854 ](https://github.com/aws/aws-sdk-cpp/releases/tag/1.11.854) |  + 亚马逊 Kendra 智能排名：1.19.0 [https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fkendraranking%2Fv1.19.0](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fkendraranking%2Fv1.19.0)<br />+ 亚马逊 WorkSpaces 应用程序：[1.64.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fappstream%2Fv1.64.0)<br />+ Amazon 备份网关：[1.30.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fbackupgateway%2Fv1.30.0)<br />+ 亚马逊 WorkSpaces 实例：[1.9.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fworkspacesinstances%2Fv1.9.0)  | [2.49.2 ](https://github.com/aws/aws-sdk-java-v2/releases/tag/2.49.2) | [3.1094.0 ](https://github.com/aws/aws-sdk-js-v3/releases/tag/v3.1094.0) | [1.8.13 ](https://github.com/aws/aws-sdk-kotlin/releases/tag/v1.8.13) |  + 亚马逊 Kendra 智能排名：[4.0.101.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.295.0)<br />+ 亚马逊 WorkSpaces 应用程序：[4.0.101.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.295.0)<br />+ Amazon 备份网关：[4.0.101.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.295.0)<br />+ 亚马逊 WorkSpaces 实例：[4.0.101.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.295.0)  | [3.388.13 ](https://github.com/aws/aws-sdk-php/releases/tag/3.388.13) | [1.43.55 ](https://github.com/boto/boto3/releases/tag/1.43.55) | [1.43.55 ](https://github.com/boto/botocore/releases/tag/1.43.55) |  + 亚马逊 Kendra 智能排名：1.48.0 [https://github.com/aws/aws-sdk-ruby/commit/ba79e19b071aab023ea46147a568dc913f53b187](https://github.com/aws/aws-sdk-ruby/commit/ba79e19b071aab023ea46147a568dc913f53b187)<br />+ 亚马逊 WorkSpaces 应用程序：[1.140.0 ](https://github.com/aws/aws-sdk-ruby/commit/ba79e19b071aab023ea46147a568dc913f53b187)<br />+ Amazon 备份网关：[1.56.0 ](https://github.com/aws/aws-sdk-ruby/commit/ba79e19b071aab023ea46147a568dc913f53b187)<br />+ 亚马逊 WorkSpaces 实例：[1.19.0 ](https://github.com/aws/aws-sdk-ruby/commit/ba79e19b071aab023ea46147a568dc913f53b187)  |  + 亚马逊 Kendra 智能排名：1.104.0 [https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-07-23](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-07-23)<br />+ 亚马逊 WorkSpaces 应用程序：[1.120.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-07-23)<br />+ Amazon 备份网关：[1.107.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-07-23)<br />+ 亚马逊 WorkSpaces 实例：[1.34.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-07-23)  | [1.7.45 ](https://github.com/awslabs/aws-sdk-swift/releases/tag/1.7.45) | 
| [亚马逊 SES 邮件管理器 ](https://docs.amazonaws.cn/ses/latest/dg/cbor-faq.html) | 2026 年 7 月 6 日 | 优先选择 RPC v2 CBOR 而不是 JSON 1.0 Amazon  | [2.35.16 ](https://github.com/aws/aws-cli/releases/tag/2.35.16) | [1.11.840 ](https://github.com/aws/aws-sdk-cpp/releases/tag/1.11.840) | [1.20.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fmailmanager%2Fv1.20.0) | [2.47.0 ](https://github.com/aws/aws-sdk-java-v2/releases/tag/2.47.0) | [3.1080.0 ](https://github.com/aws/aws-sdk-js-v3/releases/tag/v3.1080.0) | [1.6.107 ](https://github.com/aws/aws-sdk-kotlin/releases/tag/v1.6.107) | [4.0.101.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.281.0) | [3.387.3 ](https://github.com/aws/aws-sdk-php/releases/tag/3.387.3) | [1.43.41 ](https://github.com/boto/boto3/releases/tag/1.43.41) | [1.43.41 ](https://github.com/boto/botocore/releases/tag/1.43.41) | [1.46.0 ](https://rubygems.org/gems/aws-sdk-mailmanager/versions/1.46.0) | [1.89.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-07-06) | [1.7.31 ](https://github.com/awslabs/aws-sdk-swift/releases/tag/1.7.31) | 
|  + [Amazon Compute Optimizer](https://docs.amazonaws.cn/compute-optimizer/latest/ug/cbor-faq.html)<br />+ [Amazon Compute Optimizer Automation](https://docs.amazonaws.cn/compute-optimizer/latest/ug/cbor-faq.html)<br />+ [Amazon Comprehend Medical](https://docs.amazonaws.cn/comprehend-medical/latest/dev/cbor-faq.html)<br />+ [亚马逊 GameLift 服务器 ](https://docs.amazonaws.cn/gameliftservers/latest/developerguide/cbor-faq.html)<br />+ [Amazon Marketplace Entitlement Service](https://docs.amazonaws.cn/marketplace/latest/userguide/cbor-faq.html)<br />+ [Amazon Snowball](https://docs.amazonaws.cn/snowball/latest/developer-guide/cbor-faq.html)  | 2026 年 4 月 21 日 | 优先选择 RPC v2 CBOR 而不是 JSON 1.0 Amazon  | [2.34.34 ](https://github.com/aws/aws-cli/releases/tag/2.34.34) | [1.11.794 ](https://github.com/aws/aws-sdk-cpp/releases/tag/1.11.794) |  + Amazon Compute Optimizer: [ 1.50.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fcomputeoptimizer%2Fv1.50.0)<br />+ Amazon Compute Optimizer Automation: [ 1.1.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fcomputeoptimizerautomation%2Fv1.1.0)<br />+ 亚马逊 Comprehend Medical：1.32.0 [https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fcomprehendmedical%2Fv1.32.0](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fcomprehendmedical%2Fv1.32.0)<br />+ 亚马逊 GameLift 服务器：[1.53.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fgamelift%2Fv1.53.0)<br />+ Amazon Marketplace Entitlement Service: [ 1.37.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fmarketplaceentitlementservice%2Fv1.37.0)<br />+ Amazon Snowball: [ 1.36.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fsnowball%2Fv1.36.0)  | [2.42.38 ](https://github.com/aws/aws-sdk-java-v2/releases/tag/2.42.38) | [3.1034.0 ](https://github.com/aws/aws-sdk-js-v3/releases/tag/v3.1034.0) | [1.6.61 ](https://github.com/aws/aws-sdk-kotlin/releases/tag/v1.6.61) |  + Amazon Compute Optimizer: [ 4.0.5.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.235.0)<br />+ Amazon Compute Optimizer Automation: [ 4.0.1.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.235.0)<br />+ 亚马逊 Comprehend Medical：4.0.3.0 [https://github.com/aws/aws-sdk-net/releases/tag/4.0.235.0](https://github.com/aws/aws-sdk-net/releases/tag/4.0.235.0)<br />+ 亚马逊 GameLift 服务器：[4.0.9.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.235.0)<br />+ Amazon Marketplace Entitlement Service: [ 4.0.5.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.235.0)<br />+ Amazon Snowball: [ 4.0.2.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.235.0)  | [3.379.4 ](https://github.com/aws/aws-sdk-php/releases/tag/3.379.4) | [1.42.93 ](https://github.com/boto/boto3/releases/tag/1.42.93) | [1.42.93 ](https://github.com/boto/botocore/releases/tag/1.42.93) |  + Amazon Compute Optimizer: [ 1.92.0 ](https://github.com/aws/aws-sdk-ruby/commit/4fe455b1f19f6ed53b5ae85f9d37a395a8918477)<br />+ Amazon Compute Optimizer Automation: [ 1.5.0 ](https://github.com/aws/aws-sdk-ruby/commit/4fe455b1f19f6ed53b5ae85f9d37a395a8918477)<br />+ 亚马逊 Comprehend Medical：1.82.0 [https://github.com/aws/aws-sdk-ruby/commit/4fe455b1f19f6ed53b5ae85f9d37a395a8918477](https://github.com/aws/aws-sdk-ruby/commit/4fe455b1f19f6ed53b5ae85f9d37a395a8918477)<br />+ 亚马逊 GameLift 服务器：[1.125.0 ](https://github.com/aws/aws-sdk-ruby/commit/4fe455b1f19f6ed53b5ae85f9d37a395a8918477)<br />+ Amazon Marketplace Entitlement Service: [ 1.86.0 ](https://github.com/aws/aws-sdk-ruby/commit/4fe455b1f19f6ed53b5ae85f9d37a395a8918477)<br />+ Amazon Snowball: [ 1.100.0 ](https://github.com/aws/aws-sdk-ruby/commit/4fe455b1f19f6ed53b5ae85f9d37a395a8918477)  |  + Amazon Compute Optimizer: [ 1.104.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-04-21)<br />+ Amazon Compute Optimizer Automation: [ 1.9.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-04-21)<br />+ 亚马逊 Comprehend Medical：1.99.0 [https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-04-21](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-04-21)<br />+ 亚马逊 GameLift 服务器：[1.109.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-04-21)<br />+ Amazon Marketplace Entitlement Service: [ 1.105.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-04-21)<br />+ Amazon Snowball: [ 1.98.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2026-04-21)  | [1.6.99 ](https://github.com/awslabs/aws-sdk-swift/releases/tag/1.6.99) | 
| [CloudWatch](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/cloudwatch-protocols-faq.html#getting-started) | 2025 年 12 月 10 日 | 优先选择 Amazon JSON 1.0 或 RPC v2 CBOR 而不是查询 Amazon  | [2.32.14 ](https://github.com/aws/aws-cli/releases/tag/2.32.14) | [1.11.708 ](https://github.com/aws/aws-sdk-cpp/releases/tag/1.11.708) | [1.53.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fcloudwatch%2Fv1.53.0) | [2.40.6 ](https://github.com/aws/aws-sdk-java-v2/releases/tag/2.40.6) | [3.949.0 ](https://github.com/aws/aws-sdk-js-v3/releases/tag/v3.949.0) | [1.5.100 ](https://github.com/aws/aws-sdk-kotlin/releases/tag/v1.5.100) | [4.0.150.0 ](https://github.com/aws/aws-sdk-net/releases/tag/4.0.150.0) | [3.367.0 ](https://github.com/aws/aws-sdk-php/releases/tag/3.367.0) | [1.42.7 ](https://github.com/boto/boto3/releases/tag/1.42.7) | [1.42.7 ](https://github.com/boto/botocore/releases/tag/1.42.7) | [1.126.0 ](https://github.com/aws/aws-sdk-ruby/commit/3b09588cf49079453ef372cdcd51eaab8d8114a9) | [1.100.0 ](https://github.com/awslabs/aws-sdk-rust/releases/tag/release-2025-12-10) | [1.6.14 ](https://github.com/awslabs/aws-sdk-swift/releases/tag/1.6.14) | 
| [Amazon SQS](https://docs.amazonaws.cn/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-json-faqs.html) | 2023 年 11 月 8 日 | 优先选择 Amazon JSON 1.0 而不是 Amazon 查询 | 不适用 | [1.11.198 ](https://github.com/aws/aws-sdk-cpp/releases/tag/1.11.198) | [1.27.0 ](https://github.com/aws/aws-sdk-go-v2/releases/tag/service%2Fsqs%2Fv1.27.0) | [2.21.18 ](https://github.com/aws/aws-sdk-java-v2/releases/tag/2.21.18) | [3.446.0 ](https://github.com/aws/aws-sdk-js-v3/releases/tag/v3.446.0) | [0.34.2-测试版 ](https://github.com/aws/aws-sdk-kotlin/releases/tag/v0.34.2-beta) | 不适用 | [3.285.1 ](https://github.com/aws/aws-sdk-php/releases/tag/3.285.1) | [1.28.81 ](https://github.com/boto/boto3/releases/tag/1.28.81) | [1.31.81 ](https://github.com/boto/botocore/releases/tag/1.31.81) | [1.66.0 ](https://rubygems.org/gems/aws-sdk-sqs/versions/1.66.0) | 不适用 | 不适用 | 

## 常见问题
<a name="service-protocol-updates-faq"></a>

### 一般问题
<a name="service-protocol-updates-general-questions"></a>

#### 什么是协议支持变更？
<a name="service-protocol-updates-overview"></a>

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

#### 我需要更改我的申请吗？
<a name="service-protocol-updates-action"></a>

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

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

#### 在哪里可以更改协议支持？
<a name="service-protocol-updates-availability"></a>

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

#### 现有协议会怎样？
<a name="service-protocol-updates-existing-protocols"></a>

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

### Smithy RPC v2 CBOR 问题
<a name="service-protocol-updates-cbor-questions"></a>

#### 什么是 Smithy RPC v2 CBOR？
<a name="service-protocol-updates-cbor-overview"></a>

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

#### 如果我的应用程序无法使用 Smithy RPC v2 CBOR 怎么办？
<a name="service-protocol-updates-fallback"></a>

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