View a markdown version of this page

AWS 服務用戶端的通訊協定支援變更 - AWS SDKs和工具
具有通訊協定支援變更的服務用戶端常見問答集

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS 服務用戶端的通訊協定支援變更

AWS SDKs會在與服務通訊時處理用於序列化請求和還原序列化回應的線路通訊協定 AWS 。如果您的 SDK 用戶端支援變更，您的應用程式會自動使用更新的通訊協定，而不會變更程式碼。通訊協定支援變更不會變更模型化服務 API。不過，依賴特定線路表示的應用程式和基礎設施可能需要測試或更新。

具有通訊協定支援變更的服務用戶端

下表識別發行 AWS 的服務用戶端通訊協定支援變更。資料表中存在的服務並不表示每個 AWS SDK 或服務用戶端版本都包含變更。更新之前，請檢閱適用的 SDK 版本備註和服務特定的文件，以取得支援的 SDKs、版本、通訊協定和 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
Amazon CloudWatch Application Insights 2026 年 7 月 24 日 偏好透過 AWS JSON 1.0 的 RPC v2 CBOR 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 日 偏好透過 AWS JSON 1.0 的 RPC v2 CBOR 2.36.7 1.11.854

  • Amazon Kendra Intelligent Ranking：1.19.0

  • Amazon WorkSpaces 應用程式：1.64.0

  • AWS 備份閘道：1.30.0

  • Amazon WorkSpaces 執行個體：1.9.0

 2.49.2 3.1094.0 1.8.13
3.388.13 1.43.55 1.43.55

  • Amazon Kendra Intelligent Ranking：1.48.0

  • Amazon WorkSpaces 應用程式：1.140.0

  • AWS 備份閘道：1.56.0

  • Amazon WorkSpaces 執行個體：1.19.0

  • Amazon Kendra Intelligent Ranking：1.104.0

  • Amazon WorkSpaces 應用程式：1.120.0

  • AWS 備份閘道：1.107.0

  • Amazon WorkSpaces 執行個體：1.34.0

 1.7.45
Amazon SES Mail Manager 2026 年 7 月 6 日 偏好透過 AWS JSON 1.0 的 RPC v2 CBOR 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 日 偏好透過 AWS JSON 1.0 的 RPC v2 CBOR 2.34.34 1.11.794

  • AWS Compute Optimizer：1.50.0

  • AWS Compute Optimizer Automation：1.1.0

  • Amazon Comprehend Medical：1.32.0

  • Amazon GameLift 伺服器：1.53.0

  • AWS Marketplace Entitlement Service：1.37.0

  • AWS Snowball：1.36.0

 2.42.38 3.1034.0 1.6.61

  • AWS Compute Optimizer：4.0.5.0

  • AWS Compute Optimizer Automation：4.0.1.0

  • Amazon Comprehend Medical：4.0.3.0

  • Amazon GameLift 伺服器：4.0.9.0

  • AWS Marketplace Entitlement Service：4.0.5.0

  • AWS Snowball：4.0.2.0

 3.379.4 1.42.93 1.42.93

  • AWS Compute Optimizer：1.92.0

  • AWS Compute Optimizer Automation：1.5.0

  • Amazon Comprehend Medical：1.82.0

  • Amazon GameLift 伺服器：1.125.0

  • AWS Marketplace Entitlement Service：1.86.0

  • AWS Snowball：1.100.0

  • AWS Compute Optimizer：1.104.0

  • AWS Compute Optimizer Automation：1.9.0

  • Amazon Comprehend Medical：1.99.0

  • Amazon GameLift 伺服器：1.109.0

  • AWS Marketplace Entitlement Service：1.105.0

  • AWS Snowball：1.98.0

 1.6.99
CloudWatch 2025 年 12 月 10 日 透過 AWS 查詢偏好 AWS JSON 1.0 或 RPC v2 CBOR 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 查詢，偏好 AWS JSON 1.0 不適用 1.11.198 1.27.0 2.21.18 3.446.0 0.34.2-beta 不適用 3.285.1 1.28.81 1.31.81 1.66.0 不適用 不適用

常見問答集

一般問題

什麼是通訊協定支援變更？

通訊協定支援變更會更新支援的 SDK 用戶端在與服務通訊時編碼請求和解碼回應的方式 AWS 。變更可以新增通訊協定或變更用戶端選取的通訊協定。它不會變更透過 SDK 的公有 API 公開的服務操作。

我需要變更我的應用程式嗎？

大多數使用支援 AWS SDK 用戶端的應用程式不需要變更程式碼。根據 SDK 用戶端的版本備註進行更新，並使用正常整合和部署程序測試更新。

如果您的應用程式或基礎設施取決於特定的線路表示，請更仔細地檢閱更新。範例包括檢查或修改請求和回應內文的中介軟體或代理程式、記錄的 HTTP 固定裝置，以及比較序列化承載的測試。

通訊協定支援變更在何處可用？

可用性可能因服務 AWS 區域、軟體開發套件、服務用戶端版本和通訊協定而有所不同。使用與資料表項目相關聯的服務特定文件和適用的 SDK 版本備註來驗證可用性。

現有通訊協定會發生什麼情況？

通訊協定支援變更本身不會宣告棄用現有的服務通訊協定。遵循服務特定的公告、開發套件版本備註，以及 AWS SDKs和工具維護政策 以取得支援和生命週期資訊。

Smithy RPC v2 CBOR 問題

什麼是 Smithy RPC v2 CBOR？

Smithy RPC v2 CBOR 使用簡潔二進位物件表示法 (CBOR)，這是一種精簡的二進位資料格式，來編碼請求和回應。相較於以文字為基礎的 JSON 編碼，二進位編碼可以減少編碼的承載大小和序列化額外負荷。實際效能會因服務操作、承載、軟體開發套件、執行時間和網路條件而有所不同。在 Smithy 網站上閱讀有關 Smithy RPC v2 CBOR 協定的詳細資訊。

如果我的應用程式無法使用 Smithy RPC v2 CBOR，該怎麼辦？

更新之前，請測試與通訊協定相關的整合，並檢閱適用的 SDK 版本備註以取得相容性或備用指引。如果問題阻止採用，請在更新受影響的整合時繼續使用符合您需求的支援用戶端版本。避免依賴不支援的 SDK 版本做為長期解決方案。