D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub . 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. # CloudWatch Exemples de surveillance réseau à l'aide de AWS CLI Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide de la surveillance du CloudWatch réseau. Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés. Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte. **Topics** + [Actions](#actions) ## Actions ### `create-monitor` L'exemple de code suivant montre comment utiliser`create-monitor`. **AWS CLI** **Exemple 1 : pour créer un moniteur réseau avec une période d’agrégation** L’exemple `create-monitor` suivant crée un moniteur nommé `Example_NetworkMonitor` avec une `aggregationPeriod` de `30` secondes. L’`state` initial du moniteur sera `INACTIVE`, car aucune sonde n’y est associée. L’état passe à `ACTIVE` uniquement lorsque des sondes sont ajoutées. Vous pouvez utiliser les commandes [update-monitor](https://docs.aws.amazon.com/cli/latest/reference/networkmonitor/update-monitor.html) ou [create-probe](https://docs.aws.amazon.com/cli/latest/reference/networkmonitor/create-probe.html) pour ajouter des sondes à ce moniteur. ``` aws networkmonitor create-monitor \ --monitor-name Example_NetworkMonitor \ --aggregation-period 30 ``` Sortie : ``` { "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "INACTIVE", "aggregationPeriod": 30, "tags": {} } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. **Exemple 2 : pour créer un moniteur réseau avec une sonde utilisant le protocole TCP et incluant également des balises** L’exemple `create-monitor` suivant crée un moniteur nommé `Example_NetworkMonitor`. La commande crée également une sonde qui utilise le protocole `ICMP` et inclut des balises. Puisque aucune `aggregationPeriod` n’est transmise dans la demande, `60` secondes est la valeur par défaut. L’`state` du moniteur avec la sonde sera `PENDING` jusqu’à ce que le moniteur soit `ACTIVE`. Cela peut prendre plusieurs minutes. À ce moment-là, ils `state` deviendront`ACTIVE`, et vous pourrez commencer à consulter CloudWatch les statistiques. ``` aws networkmonitor create-monitor \ --monitor-name Example_NetworkMonitor \ --probes sourceArn=arn:aws:ec2:region:111122223333:subnet/subnet-id,destination=10.0.0.100,destinationPort=80,protocol=TCP,packetSize=56,probeTags={Name=Probe1} \ --tags Monitor=Monitor1 ``` Sortie : ``` { "monitorArn": "arn:aws:networkmonitor:region111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "PENDING", "aggregationPeriod": 60, "tags": { "Monitor": "Monitor1" } } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. **Exemple 3 : pour créer un moniteur réseau avec une sonde utilisant ICMP et incluant également des balises** L’exemple `create-monitor` suivant crée un moniteur nommé `Example_NetworkMonitor` avec une `aggregationPeriod` de `30` secondes. La commande crée également une sonde qui utilise le protocole `ICMP` et inclut des balises. Puisque aucune `aggregationPeriod` n’est transmise dans la demande, `60` secondes est la valeur par défaut. L’`state` du moniteur avec la sonde sera `PENDING` jusqu’à ce que le moniteur soit `ACTIVE`. Cela peut prendre plusieurs minutes. À ce moment-là, ils `state` deviendront`ACTIVE`, et vous pourrez commencer à consulter CloudWatch les statistiques. ``` aws networkmonitor create-monitor \ --monitor-name Example_NetworkMonitor \ --aggregation-period 30 \ --probes sourceArn=arn:aws:ec2:region111122223333:subnet/subnet-id,destination=10.0.0.100,protocol=ICMP,packetSize=56,probeTags={Name=Probe1} \ --tags Monitor=Monitor1 ``` Sortie : ``` { "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "PENDING", "aggregationPeriod": 30, "tags": { "Monitor": "Monitor1" } } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [CreateMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/create-monitor.html)à la section *Référence des AWS CLI commandes*. ### `create-probe` L'exemple de code suivant montre comment utiliser`create-probe`. **AWS CLI** **Exemple 1 : pour créer une sonde utilisant le protocole TCP et l’ajouter à un moniteur réseau** L’exemple `create-probe` suivant crée une sonde qui utilise le `protocol` `TCP` et ajoute la sonde à un moniteur nommé `Example_NetworkMonitor`. Une fois créé, l’`state` du moniteur avec la sonde sera `PENDING` jusqu’à ce que le moniteur soit `ACTIVE`. Cela peut prendre plusieurs minutes, puis l'état passera à l'état`ACTIVE`, et vous pourrez commencer à consulter CloudWatch les statistiques. ``` aws networkmonitor create-probe \ --monitor-name Example_NetworkMonitor \ --probe sourceArn=arn:aws:ec2:region:111122223333:subnet/subnet-id,destination=10.0.0.100,destinationPort=80,protocol=TCP,packetSize=56,tags={Name=Probe1} ``` Sortie : ``` { "probeId": "probe-12345", "probeArn": "arn:aws:networkmonitor:region:111122223333:probe/probe-12345", "destination": "10.0.0.100", "destinationPort": 80, "packetSize": 56, "addressFamily": "IPV4", "vpcId": "vpc-12345", "state": "PENDING", "createdAt": "2024-03-29T12:41:57.314000-04:00", "modifiedAt": "2024-03-29T12:41:57.314000-04:00", "tags": { "Name": "Probe1" } } ``` **Exemple 2 : pour créer une sonde utilisant ICMP et l’ajouter à un moniteur réseau** L’exemple `create-probe` suivant crée une sonde qui utilise le `protocol` `ICMP` et ajoute la sonde à un moniteur nommé `Example_NetworkMonitor`. Une fois créé, l’`state` du moniteur avec la sonde sera `PENDING` jusqu’à ce que le moniteur soit `ACTIVE`. Cela peut prendre plusieurs minutes, puis l'état passera à l'état`ACTIVE`, et vous pourrez commencer à consulter CloudWatch les statistiques. ``` aws networkmonitor create-probe \ --monitor-name Example_NetworkMonitor \ --probe sourceArn=arn:aws:ec2:region:012345678910:subnet/subnet-id,destination=10.0.0.100,protocol=ICMP,packetSize=56,tags={Name=Probe1} ``` Sortie : ``` { "probeId": "probe-12345", "probeArn": "arn:aws:networkmonitor:region:111122223333:probe/probe-12345", "destination": "10.0.0.100", "packetSize": 56, "addressFamily": "IPV4", "vpcId": "vpc-12345", "state": "PENDING", "createdAt": "2024-03-29T12:44:02.452000-04:00", "modifiedAt": "2024-03-29T12:44:02.452000-04:00", "tags": { "Name": "Probe1" } } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [CreateProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/create-probe.html)à la section *Référence des AWS CLI commandes*. ### `delete-monitor` L'exemple de code suivant montre comment utiliser`delete-monitor`. **AWS CLI** **Pour supprimer un moniteur** L’exemple `delete-monitor` suivant supprime un moniteur nommé `Example_NetworkMonitor`. ``` aws networkmonitor delete-monitor \ --monitor-name Example_NetworkMonitor ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [DeleteMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/delete-monitor.html)à la section *Référence des AWS CLI commandes*. ### `delete-probe` L'exemple de code suivant montre comment utiliser`delete-probe`. **AWS CLI** **Pour supprimer une sonde** L’exemple `delete-probe` suivant supprime une sonde portant l’ID `probe-12345` d’un moniteur réseau nommé `Example_NetworkMonitor`. ``` aws networkmonitor delete-probe \ --monitor-name Example_NetworkMonitor \ --probe-id probe-12345 ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [DeleteProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/delete-probe.html)à la section *Référence des AWS CLI commandes*. ### `get-monitor` L'exemple de code suivant montre comment utiliser`get-monitor`. **AWS CLI** **Pour obtenir les informations sur le moniteur** L’exemple `get-monitor` suivant obtient des informations sur un moniteur nommé `Example_NetworkMonitor`. ``` aws networkmonitor get-monitor \ --monitor-name Example_NetworkMonitor ``` Sortie : ``` { "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "ACTIVE", "aggregationPeriod": 60, "tags": {}, "probes": [], "createdAt": "2024-04-01T17:58:07.211000-04:00", "modifiedAt": "2024-04-01T17:58:07.211000-04:00" } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [GetMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/get-monitor.html)à la section *Référence des AWS CLI commandes*. ### `get-probe` L'exemple de code suivant montre comment utiliser`get-probe`. **AWS CLI** **Pour afficher des informations sur la sonde** L’exemple `get-probe` suivant renvoie des informations sur une sonde avec l’`probeID` `probe-12345` associée à un moniteur nommé `Example_NetworkMonitor`. ``` aws networkmonitor get-probe \ --monitor-name Example_NetworkMonitor \ --probe-id probe-12345 ``` Sortie : ``` { "probeId": "probe-12345", "probeArn": "arn:aws:networkmonitor:region:012345678910:probe/probe-12345", "sourceArn": "arn:aws:ec2:region:012345678910:subnet/subnet-12345", "destination": "10.0.0.100", "destinationPort": 80, "protocol": "TCP", "packetSize": 56, "addressFamily": "IPV4", "vpcId": "vpc-12345", "state": "ACTIVE", "createdAt": "2024-03-29T12:41:57.314000-04:00", "modifiedAt": "2024-03-29T12:42:28.610000-04:00", "tags": { "Name": "Probe1" } } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [GetProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/get-probe.html)à la section *Référence des AWS CLI commandes*. ### `list-monitors` L'exemple de code suivant montre comment utiliser`list-monitors`. **AWS CLI** **Exemple 1 : pour répertorier tous les moniteurs (moniteur unique)** L’exemple `list-monitors` suivant renvoie une liste d’un seul moniteur. L’`state` du moniteur est `ACTIVE` avec une `aggregationPeriod` de 60 secondes. ``` aws networkmonitor list-monitors ``` Sortie : ``` { "monitors": [{ "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "ACTIVE", "aggregationPeriod": 60, "tags": { "Monitor": "Monitor1" } } ] } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. **Exemple 2 : pour répertorier tous les moniteurs (plusieurs moniteurs)** L’exemple `list-monitors` suivant renvoie une liste de trois moniteurs. Le `state` d'un moniteur est `ACTIVE` et génère des CloudWatch métriques. Les états des deux autres moniteurs ne `INACTIVE` génèrent pas de CloudWatch métriques. Les trois moniteurs ont une `aggregationPeriod` de 60 secondes. ``` aws networkmonitor list-monitors ``` Sortie : ``` { "monitors": [ { "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "INACTIVE", "aggregationPeriod": 60, "tags": {} }, { "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/Example_NetworkMonitor2", "monitorName": "Example_NetworkMonitor2", "state": "ACTIVE", "aggregationPeriod": 60, "tags": { "Monitor": "Monitor1" } }, { "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/TestNetworkMonitor_CLI", "monitorName": "TestNetworkMonitor_CLI", "state": "INACTIVE", "aggregationPeriod": 60, "tags": {} } ] } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [ListMonitors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/list-monitors.html)à la section *Référence des AWS CLI commandes*. ### `list-tags-for-resource` L'exemple de code suivant montre comment utiliser`list-tags-for-resource`. **AWS CLI** **Pour répertorier les balises d’une ressource** L’exemple `list-tags-for-resource` suivant renvoie une liste des balises d’un moniteur nommé `Example_NetworkMonitor`. ``` aws networkmonitor list-tags-for-resource \ --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor ``` Sortie : ``` { "tags": { "Environment": "Dev", "Application": "PetStore" } } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*. ### `tag-resource` L'exemple de code suivant montre comment utiliser`tag-resource`. **AWS CLI** **Pour baliser une ressource** L’exemple `tag-resource` suivant ajoute des balises `Environment=Dev` et `Application=PetStore` à un moniteur nommé `Example_NetworkMonitor`. ``` aws networkmonitor tag-resource \ --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \ --tags Environment=Dev,Application=PetStore ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/tag-resource.html)à la section *Référence des AWS CLI commandes*. ### `untag-resource` L'exemple de code suivant montre comment utiliser`untag-resource`. **AWS CLI** **Pour supprimer les balises d’une ressource** L’exemple `untag-resource` suivant supprime un paramètre `tag-keys` avec la paire clé-valeur de l’`Environment Application` de son association avec un moniteur nommé `Example_NetworkMonitor`. ``` aws networkmonitor untag-resource \ --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \ --tag-keys Environment Application ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/untag-resource.html)à la section *Référence des AWS CLI commandes*. ### `update-monitor` L'exemple de code suivant montre comment utiliser`update-monitor`. **AWS CLI** **Pour mettre à jour un moniteur** L’exemple `update-monitor` suivant fait passer la `aggregationPeriod` d’un moniteur de `60` secondes à `30` secondes. ``` aws networkmonitor update-monitor \ --monitor-name Example_NetworkMonitor \ --aggregation-period 30 ``` Sortie : ``` { "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "PENDING", "aggregationPeriod": 30, "tags": { "Monitor": "Monitor1" } } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [UpdateMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/update-monitor.html)à la section *Référence des AWS CLI commandes*. ### `update-probe` L'exemple de code suivant montre comment utiliser`update-probe`. **AWS CLI** **Pour mettre à jour une sonde** L’exemple `update-probe` suivant met à jour l’adresse IP `destination` d’origine d’une sonde et met également à jour la `packetSize` sur `60`. ``` aws networkmonitor update-probe \ --monitor-name Example_NetworkMonitor \ --probe-id probe-12345 \ --destination 10.0.0.150 \ --packet-size 60 ``` Sortie : ``` { "probeId": "probe-12345", "probeArn": "arn:aws:networkmonitor:region:012345678910:probe/probe-12345", "sourceArn": "arn:aws:ec2:region:012345678910:subnet/subnet-12345", "destination": "10.0.0.150", "destinationPort": 80, "protocol": "TCP", "packetSize": 60, "addressFamily": "IPV4", "vpcId": "vpc-12345", "state": "PENDING", "createdAt": "2024-03-29T12:41:57.314000-04:00", "modifiedAt": "2024-03-29T13:52:23.115000-04:00", "tags": { "Name": "Probe1" } } ``` Pour plus d'informations, consultez [Comment fonctionne Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) dans le *guide de CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [UpdateProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/update-probe.html)à la section *Référence des AWS CLI commandes*.