

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

# 有关支持的协议的常见问题解答
<a name="cbor-faq"></a>

 [除了现有的 JSON 协议外，亚马逊 Comprehend Medical 服务还增加了对 S [mithy RPC v2](https://smithy.io/2.0/additional-specs/protocols/smithy-rpc-v2.html) CBOR 协议的 SDK 支持。AWS](https://smithy.io/2.0/aws/protocols/aws-json-1_0-protocol.html)对于大多数工作负载，Smithy RPC v2 CBOR 协议的性能比 AWS JSON 更高。 AWS SDK 将优先考虑每种语言中性能最高的协议。

## 那是什么 AWS JSON 和 Smithy RPC v2 CBOR 协议，它们有什么区别？
<a name="cbor-faq-what-are-protocols"></a>

 有线协议充当客户端和服务之间的中介。对于这两种协议， AWS SDK 透明地处理客户端和服务器之间的序列化（将对象转换为有线格式）和反序列化（将线路格式转换回对象）。

AWS JSO@@ **N**-JSON 是系统间通信中最广泛使用和接受的数据格式之一。该服务使用 AWS JSON 作为介质在 S AWS DK 客户端和服务器之间进行通信。服务 API 操作的 HTTP 请求接受 JSON 形式的输入，该操作被执行，然后以 JSON 的形式将响应返回到 SDK 客户端。

 **Smithy RPC v2 CBOR**-Smithy RPC v2 CBOR（简明二进制对象表示法）是亚马逊为提高数据传输效率而开发的一种协议。它是一种数据格式，旨在保持消息大小紧凑，并允许格式不断演变，而无需在系统之间进行版本协商。与 AWS JSON 的主要区别在于 J AWS SON 使用人类可读的文本（比如`{"name": "John"}`），而 Smithy RPC v2 CBOR 使用二进制格式（1 和 0 的序列）。这种二进制方式可生成体积更小的数据包，提升网络传输速度；同时由于计算机可直接处理二进制数据，还能有效减少序列化耗时。

## 如何开始使用 Smithy RPC v2 CBOR 协议？
<a name="cbor-faq-getting-started"></a>

 首先，请使用最新 AWS SDK/CLI 版本为该服务使用 Smithy RPC v2 CBOR 协议。SDK 将在可用时自动使用 Smithy RPC v2 CBOR 协议。将您的 AWS SDK 升级到指定版本或任何后续版本。

 从 2026-04-16 开始，以下 AWS SDK 将使用 Smithy RPC v2 CBOR 协议，而其他 SDK 将继续使用 JSON 协议： AWS 
+ AWS 适用于 C\+\+ 的 SDK
+ AWS 适用于 Go V2 的 SDK
+ AWS 适用于 Java 的 SDK 2.x
+ AWS 适用于.NET 的 SDK v4
+ AWS 适用于 PowerShell v5 的工具
+ AWS 适用于 Swift
+ AWS Kotlin 版 SDK

## 启用 Smithy RPC v2 CBOR 协议有哪些风险？
<a name="cbor-faq-risks"></a>

 预计软件开发工具包中对 Smithy RPC v2 CBOR 的额外支持将对客户来说完全透明且毫不费力。但是，如果您使用的是 SDK 的自定义实现，或者自定义客户端和 AWS SDK 的组合，这取决于 AWS JSON-specific 序列化行为，则它可能与 AWS Smithy RPC v2 CBOR 协议不兼容。

## 如果我的解决方案不支持 Smithy RPC v2 CBOR 怎么办？
<a name="cbor-faq-compatibility-issues"></a>

 要使用 AWS JSON 协议，请将你的 SDK 降级到 2026-04-16 之前发布的版本。

## 内容 AWS 各地区支持 Smithy RPC v2 CBOR 协议？
<a name="cbor-faq-region-support"></a>

 所有提供该服务的[AWS 地区](https://docs.aws.amazon.com/general/latest/gr/rande.html)都支持 Smithy RPC v2 CBOR 协议。

## 升级到支持 Smithy RPC v2 CBOR 的 SDK 版本时，我可以期待哪些延迟改进？
<a name="cbor-faq-performance-improvements"></a>

 与 JSON 相比，Smithy RPC v2 CBOR 的延迟降低了多达 13%，有效载荷大小最多减少了 15%。 AWS 二进制编码消除了 JSON 文本解析和字符串转义的开销，从而减少了网络传输时间和序列化成本。

## 会吗 AWS JSON 协议被弃用了吗？
<a name="cbor-faq-json-deprecation"></a>

 AWS 旧版本的 SDK 将继续支持 JSON 协议。此外，一些特定语言的软件开发工具包将继续使用 AWS JSON，因为它比 Smithy RPC v2 CBOR 更具性能，因为该语言的可用的 JSON 实现速度快于其 CBOR 实现。

## 在哪里可以找到有关 Smithy RPC v2 CBOR 的更多信息？
<a name="cbor-faq-more-information"></a>

 你可以在 Smithy 文档中找到有关 AWS JSON 1.0 协议和 [AWS JSON 1.1 协议](https://smithy.io/2.0/aws/protocols/aws-json-1_0-protocol.html)[的AWS JSON 协议](https://smithy.io/2.0/aws/protocols/aws-json-1_1-protocol.html)的更多信息，也可以在 Smithy 文档中找到有关 Smithy RPC v2 CBOR 协议的 S [mithy RPC v](https://smithy.io/2.0/additional-specs/protocols/smithy-rpc-v2.html) 2 CBOR 的更多信息。