Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar. Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # CloudWatch Beispiele für Netzwerküberwachung mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit CloudWatch Network Monitoring Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-monitor` Das folgende Codebeispiel zeigt, wie Sie`create-monitor`. **AWS CLI** **Beispiel 1: So erstellen Sie einen Netzwerkmonitor mit einem Aggregationszeitraum** Im folgenden Beispiel für `create-monitor` wird ein Monitor namens `Example_NetworkMonitor` mit einem auf `30` Sekunden festgelegten `aggregationPeriod` erstellt. Der ursprüngliche `state` des Monitors wird `INACTIVE` sein, da ihm keine Sonden zugeordnet sind. Der Status ändert sich nur dann in `ACTIVE`, wenn Sonden hinzugefügt werden. Sie können die Befehle [update-monitor](https://docs.aws.amazon.com/cli/latest/reference/networkmonitor/update-monitor.html) oder [create-probe](https://docs.aws.amazon.com/cli/latest/reference/networkmonitor/create-probe.html) verwenden, um diesem Monitor Sonden hinzuzufügen. ``` aws networkmonitor create-monitor \ --monitor-name Example_NetworkMonitor \ --aggregation-period 30 ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "INACTIVE", "aggregationPeriod": 30, "tags": {} } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. **Beispiel 2: So erstellen Sie einen Netzwerkmonitor mit einer Sonde, die TCP verwendet und auch Tags enthält** Im folgenden Beispiel für `create-monitor` wird ein Monitor mit dem Namen `Example_NetworkMonitor` erstellt. Der Befehl erstellt außerdem eine Sonde, die das `ICMP`-Protokoll verwendet und Tags enthält. Da in der Anfrage keine `aggregationPeriod` übergeben wird, ist die Standardeinstellung `60` Sekunden. Der `state` des Monitors mit der Sonde bleibt `PENDING`, bis der Monitor `ACTIVE` ist. Dies kann mehrere Minuten dauern. Ab diesem Zeitpunkt `state` wird der Wert geändert und Sie können mit der Anzeige der CloudWatch Messwerte beginnen. `ACTIVE` ``` 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 ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkmonitor:region111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "PENDING", "aggregationPeriod": 60, "tags": { "Monitor": "Monitor1" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. **Beispiel 3: So erstellen Sie mithilfe von ICMP einen Netzwerkmonitor mit einer Sonde, die auch Tags enthält** Im folgenden Beispiel für `create-monitor` wird ein Monitor namens `Example_NetworkMonitor` und einer `aggregationPeriod` von `30` Sekunden erstellt. Der Befehl erstellt außerdem eine Sonde, die das `ICMP`-Protokoll verwendet und Tags enthält. Da in der Anfrage keine `aggregationPeriod` übergeben wird, ist die Standardeinstellung `60` Sekunden. Der `state` des Monitors mit der Sonde bleibt `PENDING`, bis der Monitor `ACTIVE` ist. Dies kann mehrere Minuten dauern. Ab diesem Zeitpunkt `state` wird der Wert geändert und Sie können mit der Anzeige der CloudWatch Messwerte beginnen. `ACTIVE` ``` 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 ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "PENDING", "aggregationPeriod": 30, "tags": { "Monitor": "Monitor1" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/create-monitor.html)in der *AWS CLI Befehlsreferenz*. ### `create-probe` Das folgende Codebeispiel zeigt die Verwendung`create-probe`. **AWS CLI** **Beispiel 1: So erstellen Sie eine Sonde, die TCP verwendet, und fügen sie einem Netzwerkmonitor hinzu** Im folgenden Beispiel für `create-probe` wird eine Sonde erstellt, die das `TCP`-`protocol` verwendet und die Sonde einem Monitor namens `Example_NetworkMonitor` hinzufügt. Nach der Erstellung bleibt der `state` des Monitors mit der Sonde `PENDING`, bis der Monitor `ACTIVE` ist. Dies kann mehrere Minuten dauern. Zu diesem Zeitpunkt wechselt der Status zu`ACTIVE`, und Sie können mit der Anzeige der CloudWatch Metriken beginnen. ``` 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} ``` Ausgabe: ``` { "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" } } ``` **Beispiel 2: So erstellen Sie eine Sonde, die ICMP verwendet, und fügen sie einem Netzwerkmonitor hinzu** Im folgenden Beispiel für `create-probe` wird eine Sonde erstellt, die das `ICMP`-`protocol` verwendet und die Sonde einem Monitor namens `Example_NetworkMonitor` hinzufügt. Nach der Erstellung bleibt der `state` des Monitors mit der Sonde `PENDING`, bis der Monitor `ACTIVE` ist. Dies kann mehrere Minuten dauern. Zu diesem Zeitpunkt wird der Status geändert`ACTIVE`, und Sie können mit der Anzeige der CloudWatch Metriken beginnen. ``` 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} ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/create-probe.html)in der *AWS CLI Befehlsreferenz*. ### `delete-monitor` Das folgende Codebeispiel zeigt die Verwendung`delete-monitor`. **AWS CLI** **So löschen Sie einen Monitor** Im folgenden `delete-monitor`-Beispiel wird ein Monitor namens `Example_NetworkMonitor` gelöscht. ``` aws networkmonitor delete-monitor \ --monitor-name Example_NetworkMonitor ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/delete-monitor.html)in der *AWS CLI Befehlsreferenz*. ### `delete-probe` Das folgende Codebeispiel zeigt die Verwendung`delete-probe`. **AWS CLI** **So löschen Sie eine Sonde** Im folgenden Beispiel für `delete-probe` wird eine Sonde mit der ID `probe-12345` aus einem Netzwerkmonitor namens `Example_NetworkMonitor` gelöscht. ``` aws networkmonitor delete-probe \ --monitor-name Example_NetworkMonitor \ --probe-id probe-12345 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/delete-probe.html)in der *AWS CLI Befehlsreferenz*. ### `get-monitor` Das folgende Codebeispiel zeigt die Verwendung`get-monitor`. **AWS CLI** **So rufen Sie Monitorinformationen ab** Im folgenden Beispiel für `get-monitor` werden Informationen zu einem Monitor namens `Example_NetworkMonitor` abgerufen. ``` aws networkmonitor get-monitor \ --monitor-name Example_NetworkMonitor ``` Ausgabe: ``` { "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" } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/get-monitor.html)in der *AWS CLI Befehlsreferenz*. ### `get-probe` Das folgende Codebeispiel zeigt die Verwendung`get-probe`. **AWS CLI** **So zeigen Sie Sondendetails an** Im folgenden Beispiel für `get-probe` werden Details zu einer Sonde mit `probeID`-`probe-12345` zurückgegeben, der einem Monitor namens `Example_NetworkMonitor` zugeordnet ist. ``` aws networkmonitor get-probe \ --monitor-name Example_NetworkMonitor \ --probe-id probe-12345 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/get-probe.html)in der *AWS CLI Befehlsreferenz*. ### `list-monitors` Das folgende Codebeispiel zeigt die Verwendung`list-monitors`. **AWS CLI** **Beispiel 1: So listen Sie alle Monitore auf (einzelner Monitor)** Im folgenden Beispiel für `list-monitors` wird eine Liste mit nur einem einzigen Monitor zurückgegeben. Der `state` des Monitors ist `ACTIVE` und er hat eine `aggregationPeriod` von 60 Sekunden. ``` aws networkmonitor list-monitors ``` Ausgabe: ``` { "monitors": [{ "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "ACTIVE", "aggregationPeriod": 60, "tags": { "Monitor": "Monitor1" } } ] } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. **Beispiel 2: So listen Sie alle Monitore auf (mehrere Monitore)** Im folgenden Beispiel für `list-monitors` wird eine Liste mit drei Monitoren zurückgegeben. Das `state` ist ein Monitor `ACTIVE` und das Generieren von CloudWatch Metriken. Die Status der anderen beiden Monitore sind `INACTIVE` und generieren keine CloudWatch Metriken. Alle drei Monitore verwenden einen `aggregationPeriod` von 60 Sekunden. ``` aws networkmonitor list-monitors ``` Ausgabe: ``` { "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": {} } ] } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListMonitors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/list-monitors.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So listen Sie Tags für eine Ressource auf** Im folgenden Beispiel für `list-tags-for-resource` wird eine Liste von Tags für einen Monitor namens `Example_NetworkMonitor` zurückgegeben. ``` aws networkmonitor list-tags-for-resource \ --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor ``` Ausgabe: ``` { "tags": { "Environment": "Dev", "Application": "PetStore" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So taggen Sie eine Ressource** Im folgenden Beispiel für `tag-resource` wird ein Monitor namens `Example_NetworkMonitor` mit den Tags `Environment=Dev` und `Application=PetStore` markiert. ``` aws networkmonitor tag-resource \ --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \ --tags Environment=Dev,Application=PetStore ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie Tags von einer Ressource** Im folgenden Beispiel für `untag-resource` wird ein `tag-keys`-Parameter mit dem Schlüssel-Wert-Paar von `Environment Application` aus seiner Zuordnung zu einem Monitor namens `Example_NetworkMonitor` entfernt. ``` aws networkmonitor untag-resource \ --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \ --tag-keys Environment Application ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-monitor` Das folgende Codebeispiel zeigt die Verwendung`update-monitor`. **AWS CLI** **So aktualisieren Sie einen Monitor** Im folgenden Beispiel für `update-monitor` wird die `aggregationPeriod` eines Monitors von `60` Sekunden auf `30` Sekunden geändert. ``` aws networkmonitor update-monitor \ --monitor-name Example_NetworkMonitor \ --aggregation-period 30 ``` Ausgabe: ``` { "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor", "monitorName": "Example_NetworkMonitor", "state": "PENDING", "aggregationPeriod": 30, "tags": { "Monitor": "Monitor1" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateMonitor](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/update-monitor.html)in der *AWS CLI Befehlsreferenz*. ### `update-probe` Das folgende Codebeispiel zeigt die Verwendung`update-probe`. **AWS CLI** **So aktualisieren Sie eine Sonde** Im folgenden Beispiel für `update-probe` wird die ursprüngliche `destination`-IP-Adresse einer Sonde und auch die `packetSize` auf `60` aktualisiert. ``` aws networkmonitor update-probe \ --monitor-name Example_NetworkMonitor \ --probe-id probe-12345 \ --destination 10.0.0.150 \ --packet-size 60 ``` Ausgabe: ``` { "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" } } ``` Weitere Informationen finden Sie unter [So funktioniert Amazon CloudWatch Network Monitor](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateProbe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/update-probe.html)in der *AWS CLI Befehlsreferenz*.