本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
支援的通訊協定FAQs
除了現有的 AWS JSON
什麼是 AWS JSON 和 Smithy RPC v2 CBOR 通訊協定,它們有何不同?
線路通訊協定可做為用戶端和 服務之間的中介裝置。 AWS 開發套件會透明地處理兩個通訊協定的用戶端和伺服器之間的序列化 (將物件轉換為線路格式) 和還原序列化 (將線路格式轉換為物件)。
AWS JSON - JSON 是系統之間最廣泛使用和接受的通訊資料格式之一。此服務使用 AWS JSON 做為媒體,在 AWS SDK 用戶端和伺服器之間進行通訊。服務 API 操作的 HTTP 請求接受 JSON 格式的輸入、執行操作,並以 JSON 格式將回應傳回至 SDK 用戶端。
Smithy RPC v2 CBOR - Smithy RPC v2 CBOR (簡潔二進位物件表示法) 是由 Amazon 為更有效率的資料傳輸而開發的通訊協定。它是一種資料格式,旨在保持訊息大小精簡,並允許格式演進,而無需在系統之間進行版本交涉。與 AWS JSON 的主要區別在於 AWS ,JSON 使用人類可讀文字 (如 {"name": "John"}),而 Smithy RPC v2 CBOR 使用二進位格式 (1 和 0 的序列)。這種二進位方法會建立較小的資料套件,以更快的速度通過網路,並縮短序列化時間,因為電腦會直接處理二進位資料。
如何開始使用 Smithy RPC v2 CBOR 通訊協定?
若要開始使用,請使用最新的 AWS SDK/CLI 版本來使用此服務的 Smithy RPC v2 CBOR 通訊協定。開發套件將在可用時自動使用 Smithy RPC v2 CBOR 通訊協定。將您的 AWS SDK 升級至指定的版本或任何後續版本。
從 2026-04-16 開始,下列 AWS SDKs將使用 Smithy RPC v2 CBOR 通訊協定,而其他 SDKs 將繼續使用 AWS JSON 通訊協定:
AWS 適用於 C++ 的 SDK
AWS 適用於 Go V2 的 SDK
AWS 適用於 Java 的 SDK 2.x
AWS 適用於 .NET v4 的 SDK
AWS PowerShell v5 的工具
AWS 適用於 Swift 的 SDK
AWS 適用於 Kotlin 的 SDK
啟用 Smithy RPC v2 CBOR 通訊協定有哪些風險?
在 SDKs 中新增對 Smithy RPC v2 CBOR 的支援,預期對客戶而言是完全透明且輕鬆的。不過,如果您使用 AWS SDK 的自訂實作,或自訂用戶端和 SDK AWS 的組合,取決於 AWS JSON 特定的序列化行為,則可能與 Smithy RPC v2 CBOR 通訊協定不相容。
如果我的解決方案不支援 Smithy RPC v2 CBOR,該怎麼辦?
若要使用 AWS JSON 通訊協定,請將 SDK 降級至 2026-04-16 之前發行的版本。
哪些 AWS 區域支援 Smithy RPC v2 CBOR 通訊協定?
提供此服務的所有AWS 區域都支援 Smithy RPC v2 CBOR 通訊協定。
升級至支援 Smithy RPC v2 CBOR 的 SDK 版本時,可以預期哪些延遲改善?
與 AWS JSON 相比,Smithy RPC v2 CBOR 的延遲降低高達 13%,承載大小降低高達 15%。二進位編碼可消除 JSON 文字剖析和字串逸出的額外負荷,進而降低網路傳輸時間和序列化成本。
AWS JSON 通訊協定是否會棄用?
AWS 舊版 SDKs 將繼續支援 JSON 通訊協定。此外,某些語言特定的 SDKs 將繼續使用 AWS JSON,因為它比 Smithy RPC v2 CBOR 更高效能,因為語言可用的 JSON 實作比其 CBOR 實作更快。
哪裡可以找到有關 Smithy RPC v2 CBOR 的詳細資訊?
您可以在 Smithy 文件中找到 AWS JSON 通訊協定在 AWS JSON 1.0 通訊協定