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 |
2,49,2 |
3,1094,0 |
1,8,13 |
3,388,13 |
1,43,55 |
1,43,55 |
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 |
2,42,38 |
3,1034,0 |
1,6,61 |
3,379,4 |
1,42,93 |
1,42,93 |
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
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.