View a markdown version of this page

Modifications apportées au support du protocole pour AWS clients du service - AWS SDK et outils

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Modifications apportées au support du protocole pour AWS clients du service

AWS Les SDK gèrent les protocoles filaires utilisés pour sérialiser les demandes et désérialiser les réponses lors de la communication avec AWS services. Si votre client SDK accepte cette modification, votre application utilise automatiquement le protocole mis à jour sans modification de code. Une modification de la prise en charge du protocole ne modifie pas l'API du service modélisé. Cependant, les applications et l'infrastructure qui dépendent d'une représentation filaire spécifique peuvent nécessiter des tests ou des mises à jour.

Clients de service avec des modifications de prise en charge du protocole

Les tableaux suivants identifient AWS clients de service dont les modifications de prise en charge du protocole sont en version préliminaire ou publiées. La présence d'un service dans un tableau ne signifie pas que tous AWS La version du SDK ou du client de service inclut la modification. Avant de procéder à la mise à jour, consultez les notes de version du SDK applicables et la documentation spécifique au service pour les SDK, les versions, les protocoles et Régions AWS.

Le Smithy RPC v2 CBOR est un protocole d'appel de procédure à distance (RPC). Il utilise le codage CBOR (Concise Binary Object Representation). AWS JSON 1.0 et AWS JSON 1.1 sont AWS protocoles de service. Ils utilisent le codage JSON.

Le support de prévisualisation est uniquement destiné aux tests et à l'évaluation. Ne l'utilisez pas pour les charges de travail de production. Suivez la documentation d'aperçu et les conditions associées au service répertorié. Le support publié est disponible pour une utilisation en production, en commençant par les versions du SDK et du client de service identifiées dans les notes de version du SDK applicables.

Aperçu des clients

Le tableau suivant identifie AWS clients de service dont les modifications de protocole prennent en charge les modifications qui sont en cours d'aperçu. Le Changement la colonne compare le CBOR de Smithy RPC v2 au CBOR applicable AWS Protocole JSON.

Services Modifier AWS CLI v2 C++ Go v2 Java v2 JavaScript v3 Kotlin .NET v4 PHP v3 Python-boto3 Python-botocore Ruby v3 Rust Swift
PCA ACM Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Athéna Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
CloudHSM V2 Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
CloudTrail Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
CodeBuild Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
CodeDeploy Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
CodePipeline Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Identité Cognito Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Comprehend Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Service de configuration Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
DataSync Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Direct Connect Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Service d'annuaire Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
EMR Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
EventBridge Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Firehose Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
KMS Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
MemoryDB Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Network Firewall Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.0
Rekognition Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
API de balisage des groupes de ressources Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Domaines de la Route 53 Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Secrets Manager Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Service Catalog Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Service Quotas Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
ServiceDiscovery Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
SFN Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.0
Shield Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
SWF Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.0
Extrait Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
Transcribe Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1
WorkSpaces Préférez Smithy RPC v2 CBOR au CBOR AWS JSON 1.1

Clients libérés

Tous les liens de version figurant dans le tableau suivant pointent vers les pages de publication du GitHub site web.

Services Date de publication Modifier 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 Informations sur les applications 24 juillet 2026 Préférez RPC v2 CBOR au CBOR AWS JSON 1.0 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
23 juillet 2026 Préférez RPC v2 CBOR au CBOR AWS JSON 1.0 2,36,7 1,11,854
  • Classement intelligent d'Amazon Kendra : 1,19,0

  • Amazon WorkSpaces Candidatures : 1,64,0

  • AWS Passerelle de sauvegarde : 1,30,0

  • Amazon WorkSpaces Instances : 1,9.0

2,49,2 3,1094,0 1,8,13
3,388,13 1,43,55 1,43,55
  • Classement intelligent d'Amazon Kendra : 1,48,0

  • Amazon WorkSpaces Candidatures : 1,140,0

  • AWS Passerelle de sauvegarde : 1,56,0

  • Amazon WorkSpaces Instances : 1,19,0

  • Classement intelligent d'Amazon Kendra : 1,104,0

  • Amazon WorkSpaces Candidatures : 1,120,0

  • AWS Passerelle de sauvegarde : 1,107,0

  • Amazon WorkSpaces Instances : 1,34,0

1,7,45
Gestionnaire de messagerie Amazon SES 6 juillet 2026 Préférez RPC v2 CBOR au CBOR AWS JSON 1.0 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
21 avril 2026 Préférez RPC v2 CBOR au CBOR AWS JSON 1.0 2,34,34 1,11,794
  • Optimiseur de calcul AWS: 1,50,0

  • Automatisation Optimiseur de calcul AWS: 1,1,0

  • Amazon Comprehend Medical : 1,32,0

  • Amazon GameLift Serveurs : 1,53,0

  • AWS Marketplace Entitlement Service: 1,37,0

  • AWS Snowball: 1,36,0

2,42,38 3,1034,0 1,6,61
  • Optimiseur de calcul AWS: 4.0.5.0

  • Automatisation Optimiseur de calcul AWS: 4.0.1.0

  • Amazon Comprehend Medical : 4.0.3.0

  • Amazon GameLift Serveurs : 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
  • Optimiseur de calcul AWS: 1,92,0

  • Automatisation Optimiseur de calcul AWS: 1,5,0

  • Amazon Comprehend Medical : 1,82,0

  • Amazon GameLift Serveurs : 1,125,0

  • AWS Marketplace Entitlement Service: 1,86,0

  • AWS Snowball: 1,100,0

  • Optimiseur de calcul AWS: 1,104,0

  • Automatisation Optimiseur de calcul AWS: 1,9.0

  • Amazon Comprehend Medical : 1,99,0

  • Amazon GameLift Serveurs : 1,109,0

  • AWS Marketplace Entitlement Service: 1,105,0

  • AWS Snowball: 1,98,0

1,6,99
CloudWatch 10 décembre 2025 Préférez AWS JSON 1.0 ou RPC v2 CBOR over AWS Requête 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 8 novembre 2023 Préférez AWS JSON 1.0 over AWS Requête Non applicable 1,11,198 1,27,0 2,21,18 3,446,0 0.34.2-bêta Non applicable 3,285,1 1,28,81 1,31,81 1,66,0 Non applicable Non applicable

Questions fréquentes (FAQ)

Questions générales

Qu'est-ce qu'un changement de support de protocole ?

Une modification de la prise en charge du protocole met à jour la façon dont un client SDK pris en charge code les demandes et décode les réponses lorsqu'il communique avec un AWS service. La modification peut ajouter un protocole ou modifier le protocole sélectionné par un client. Cela ne modifie pas les opérations de service exposées via l'API publique du SDK.

Dois-je modifier ma candidature ?

La plupart des applications qui utilisent un AWS Les clients du SDK ne nécessitent aucune modification de code. Mettez à jour le client SDK conformément à ses notes de version et testez la mise à jour en suivant votre processus d'intégration et de déploiement habituel.

Examinez la mise à jour de plus près si votre application ou votre infrastructure dépend d'une représentation filaire spécifique. Les exemples incluent des intergiciels ou des proxys qui inspectent ou modifient les corps des requêtes et des réponses, les appareils HTTP enregistrés et les tests qui comparent les charges utiles sérialisées.

Où une modification de la prise en charge du protocole est-elle disponible ?

La disponibilité peut varier selon le service, Région AWS, SDK, version du client de service et protocole. Utilisez la documentation spécifique au service associée à une entrée de table et les notes de version du SDK applicables pour vérifier la disponibilité.

Qu'advient-il des protocoles existants ?

Un changement de support de protocole n'annonce pas en soi la dépréciation d'un protocole de service existant. Suivez les annonces spécifiques aux services, les notes de mise à jour du SDK et les AWS Politique de maintenance des SDK et des outils pour obtenir des informations sur le support et le cycle de vie.

Questions sur le CBOR sur le Smithy RPC v2

Qu'est-ce que Smithy RPC v2 CBOR ?

Le CBOR de Smithy RPC v2 utilise la représentation d'objets binaires concis (CBOR), un format de données binaires compact, pour coder les demandes et les réponses. Comparé à un codage JSON basé sur du texte, un codage binaire peut réduire la taille de la charge utile codée et la charge de sérialisation. Les performances réelles varient en fonction du fonctionnement du service, de la charge utile, du SDK, de l'exécution et des conditions du réseau. En savoir plus sur Protocole CBOR Smithy RPC v2 sur le site Web de Smithy.

Que faire si mon application ne peut pas utiliser le CBOR Smithy RPC v2 ?

Avant la mise à jour, testez les intégrations dépendantes du protocole et consultez les notes de mise à jour du SDK applicables pour obtenir des conseils de compatibilité ou de solution de secours. Si un problème empêche l'adoption, continuez à utiliser une version client prise en charge qui répond à vos besoins pendant que vous mettez à jour l'intégration concernée. Évitez de vous fier à une version du SDK non prise en charge comme solution à long terme.