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 le 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 les plus acceptés pour la communication entre systèmes hétérogènes. CloudWatch utilise le JSON comme moyen de communication 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 sous forme de 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 format JSON est plus efficace pour transporter les données entre le client et le serveur.
-
CloudWatch AWS Le protocole JSON agit comme un 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 ?
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 avec le codage JSON est que le JSON utilise du texte lisible par l'homme (comme « name » : « John »), tandis que 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 voyagent 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 RPC v2 CBOR agit comme un 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 vers une 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 v3 | 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 lié à la façon dont null les valeurs sont traitées dans les listes : les appels d' CloudWatch API avec des entrées de liste susceptibles de contenir des null valeurs seront traités différemment dans les protocoles AWS JSON et Smithy RPC v2 CBOR 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.
De plus, si vous utilisez une implémentation personnalisée du AWS SDK ou une combinaison de clients personnalisés et de AWS SDK avec lesquels vous interagissez et CloudWatch qui génère des réponses basées sur des AWS requêtes (alias XML-based), cela peut être incompatible avec le protocole AWS JSON ou CBOR. Si vous rencontrez des problèmes, contactez le AWS Support.
Et si je suis déjà sur le dernier AWS Version du SDK, mais ma solution open source ne supporte pas JSON ou 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 remplacez votre AWS SDK par la version précédente, 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 Des versions du SDK pour CloudWatch utiliser les nouveaux protocoles ?
JSON et 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 du réseau.
Est-ce que le AWS Le protocole de requête serait-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 avant 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 trouverez plus d'informations sur le protocole JSON sur le protocole AWS JSON 1.0
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.