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.
FAQ sur les protocoles CloudWatch pris en charge
CloudWatch Les SDK ont commencé à utiliser deux protocoles supplémentaires : AWS JSON 1.0
Qu'est-ce que AWS Protocole JSON, et en quoi diffère-t-il des demandes et réponses d' CloudWatch API existantes ?
Le JSON est l'un des formats de données les plus utilisés et acceptés pour la communication entre des systèmes hétérogènes. CloudWatch utilise JSON comme support pour communiquer entre un client AWS SDK (par exemple, Java, Python, Golang JavaScript) et CloudWatch un serveur. Une requête HTTP d'une opération d' CloudWatch API accepte une entrée au format JSON. L' CloudWatch opération est exécutée et la réponse d'exécution est partagée avec le client du SDK sous forme de JSON. Comparé à AWS Query, le JSON est plus efficace pour transporter les données entre le client et le serveur.
-
CloudWatch AWS Le protocole JSON joue le rôle de médiateur entre CloudWatch le client et le serveur.
-
Le CloudWatch AWS SDK gère la sérialisation (conversion de l'objet au format JSON) et la désérialisation (conversion du format JSON en objet) entre le client et le CloudWatch serveur.
Qu'est-ce que le protocole CBOR Smithy RPC v2 et en quoi diffère-t-il des demandes et réponses d' CloudWatch API existantes ?
Le Smithy RPC v2 CBOR (Concise Binary Object Representation) est un protocole développé par Amazon pour une transmission de données plus efficace. Il s'agit d'un format de données conçu pour réduire la taille des messages et permettre au format d'évoluer sans nécessiter de négociation de version entre les systèmes. La principale différence par rapport à l'encodage JSON est que le JSON utilise du texte lisible par l'homme (comme « nom » : « John »), tandis que le CBOR utilise un format binaire (séquences de 1 et de 0). Cette approche binaire crée des paquets de données plus petits qui circulent plus rapidement sur le réseau et réduit le temps de sérialisation puisque les ordinateurs traitent directement les données binaires.
-
CloudWatch Le protocole CBOR RPC v2 joue le rôle de médiateur entre le CloudWatch client et le serveur.
-
Le CloudWatch SDK gère la sérialisation (conversion de l'objet au format CBOR) et la désérialisation (conversion du format CBOR en objet) entre le client et le serveur. CloudWatch
Comment puis-je commencer à utiliser les nouveaux protocoles pour CloudWatch ?
Pour commencer, utilisez la dernière AWS SDK/CLI version pour utiliser le dernier protocole pris en charge pour CloudWatch. Mettez à niveau votre AWS SDK vers la version spécifiée ou toute version ultérieure.
| Language | Protocole | Versions SDK |
|---|---|---|
| C++ | RPC v2 CBOR | 1,11,708 |
| Golang 2.x | RPC v2 CBOR | 1,53,0 |
| Java 1.x | RPC v2 CBOR | 1,12,795 |
| Java 2.x | RPC v2 CBOR | 2,40,6 |
| JavaScript v3.x | AWS JSON 1.0 | 3,949,0 |
| .NET version 3 | AWS JSON 1.0 | 3,7,1182,0 |
| .NET version 4 | RPC v2 CBOR | 4,0,150,0 |
| PHP | AWS JSON 1.0 | 3,367,0 |
| Python-boto3 | AWS JSON 1.0 | 1,42,7 |
| Python-botocore | AWS JSON 1.0 | 1,42,7 |
| AWS CLI v1 | AWS JSON 1.0 | 1,43,13 |
| AWS CLI v2 | AWS JSON 1.0 | 2,32,14 |
| Ruby | AWS JSON 1.0 | 1,126,0 |
| Powershell | AWS JSON 1.0 | 5,0,114 |
| Rust | RPC v2 CBOR | 1,100,0 |
| Swift | RPC v2 CBOR | 1.6,14 |
| Kotlin | RPC v2 CBOR | 1,5,100 |
Quels sont les risques liés à l'activation de ces nouveaux protocoles pour mes CloudWatch charges de travail ?
La migration vers ces nouvelles versions du SDK devrait être totalement transparente et sans effort pour les clients. Il existe un changement de comportement connu entre les protocoles concernant la façon dont les null valeurs sont traitées dans les listes : les appels d' CloudWatch API dont les entrées de liste peuvent contenir des null valeurs seront traités différemment dans les protocoles CBOR AWS JSON et Smithy RPC v2 par rapport au protocole AWS Query précédent : dans le protocole AWS Query, les valeurs nulles des listes sont supprimées, tandis que dans les JSON/CBOR protocoles seront propagées via les appels d'API.
En outre, si vous utilisez une implémentation personnalisée du AWS SDK ou une combinaison de clients personnalisés et d'un AWS SDK avec lesquels interagir et CloudWatch qui génère des réponses basées sur des AWS requêtes, cela peut être incompatible avec le protocole AWS JSON ou CBOR. XML-based Si vous rencontrez le moindre problème, contactez AWS le support.
Et si je suis déjà au courant AWS Version SDK, mais ma solution open source ne prend pas en charge le JSON ou le CBOR ?
Vous devez changer votre version du kit SDK pour une version antérieure. Consultez la Comment puis-je commencer à utiliser les nouveaux protocoles pour CloudWatch ? section et sélectionnez une version inférieure à celle répertoriée. Si vous passez à la version précédente de votre AWS SDK, vos CloudWatch API utiliseront le protocole AWS Query.
Pour quelles régions sont prises en charge AWS Protocoles JSON et CBOR utilisés dans les API CloudWatch
CloudWatch prend en charge les protocoles AWS JSON et CBOR dans toutes les AWS régions où il CloudWatch est disponible.
À quelles améliorations de latence puis-je m'attendre lors de la mise à niveau vers la valeur spécifiée AWS Versions du SDK pour CloudWatch utiliser les nouveaux protocoles ?
Le JSON et le CBOR réduisent jusqu'à 80 % la latence et l'utilisation du processeur par rapport à la AWS requête. Les deux protocoles sont jusqu'à 20 % plus efficaces en termes d'utilisation de la bande passante réseau.
Est-ce que AWS Le protocole de requête sera-t-il obsolète ?
AWS Le protocole de requête continuera d'être pris en charge. Vous pouvez continuer à utiliser le protocole AWS Query tant que la version de votre AWS SDK est définie, une version antérieure à celle répertoriée dansComment puis-je commencer à utiliser les nouveaux protocoles pour CloudWatch ?.
Où puis-je trouver plus d'informations sur AWS Protocoles CBOR JSON et Smithy RPC v2 ?
Vous pouvez trouver plus d'informations sur le protocole JSON sur le protocole AWS JSON 1.0 dans la documentation Smithy, et sur le
Pour en savoir plus sur les demandes d' CloudWatch API, consultez la section Création de demandes d' CloudWatch API dans le Guide de référence des API.