Network Manager-Beispiele mit AWS CLI - AWS Command Line Interface
Aktionen

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

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.

Network Manager-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Network Manager Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface

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 Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie Sieassociate-customer-gateway.

AWS CLI

So ordnen Sie ein Kunden-Gateway zu

Im folgenden Beispiel für associate-customer-gateway wird das Kunden-Gateway cgw-11223344556677889 im angegebenen globalen Netzwerk dem Gerät device-07f6fd08867abc123 zugeordnet.

aws networkmanager associate-customer-gateway \
    --customer-gateway-arn arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889  \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --region us-west-2

Ausgabe:

{
    "CustomerGatewayAssociation": {
        "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "State": "PENDING"
    }
}

Weitere Informationen finden Sie unter Kunden-Gateway-Zuordnungen im Handbuch zu Transit Gateway Network Manager.

Das folgende Codebeispiel zeigt die Verwendungassociate-link.

AWS CLI

So ordnen Sie einen Link zu

Im folgenden Beispiel für associate-link wird der Link link-11112222aaaabbbb1 dem Gerät device-07f6fd08867abc123 zugeordnet. Der Link und das Gerät befinden sich im angegebenen globalen Netzwerk.

aws networkmanager associate-link \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --link-id link-11112222aaaabbbb1 \
    --region us-west-2

Ausgabe:

{
    "LinkAssociation": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "LinkId": "link-11112222aaaabbbb1",
        "LinkAssociationState": "PENDING"
    }
}

Weitere Informationen finden Sie unter Geräte- und Link-Zuordnungen im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie AssociateLinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-core-network.

AWS CLI

So erstellen Sie ein Kernnetzwerk

Das folgende create-core-network Beispiel erstellt ein Kernnetzwerk mithilfe einer optionalen Beschreibung und Tags innerhalb eines globalen AWS Cloud-WAN-Netzwerks.

aws networkmanager create-core-network \
    --global-network-id global-network-cdef-EXAMPLE22222 \
    --description "Main headquarters location" \
    --tags Key=Name,Value="New York City office"

Ausgabe:

{
    "CoreNetwork": {
        "GlobalNetworkId": "global-network-cdef-EXAMPLE22222",
        "CoreNetworkId": "core-network-cdef-EXAMPLE33333",
        "CoreNetworkArn": "arn:aws:networkmanager::987654321012:core-network/core-network-cdef-EXAMPLE33333",
        "Description": "Main headquarters location",
        "CreatedAt": "2022-01-10T19:53:59+00:00",
        "State": "AVAILABLE",
        "Tags": [
            {
                "Key": "Name",
                "Value": "New York City office"
            }
        ]
    }
}

Weitere Informationen finden Sie unter Globale Netzwerke und Kernnetzwerke im Benutzerhandbuch zu AWS -Cloud-WAN.

Das folgende Codebeispiel zeigt die Verwendungcreate-device.

AWS CLI

So erstellen Sie ein Gerät

Im folgenden Beispiel für create-device wird ein Gerät in einem globalen Netzwerk erstellt. Zu den Gerätedetails gehören eine Beschreibung, der Typ, der Hersteller, das Modell und die Seriennummer.

aws networkmanager create-device
    --global-network-id global-network-01231231231231231 \
    --description "New York office device" \
    --type "office device" \
    --vendor "anycompany" \
    --model "abcabc" \
    --serial-number "1234" \
    --region us-west-2

Ausgabe:

{
    "Device": {
        "DeviceId": "device-07f6fd08867abc123",
        "DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York office device",
        "Type": "office device",
        "Vendor": "anycompany",
        "Model": "abcabc",
        "SerialNumber": "1234",
        "CreatedAt": 1575554005.0,
        "State": "PENDING"
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Geräten im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie CreateDevicein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-global-network.

AWS CLI

Um ein globales Netzwerk zu erstellen

Mit dem folgenden Beispiel für create-global-network wird ein globales Netzwerk erstellt. Der Ausgangszustand bei der Erstellung lautet PENDING.

aws networkmanager create-global-network

Ausgabe:

{
    "GlobalNetwork": {
        "GlobalNetworkId": "global-network-00a77fc0f722dae74",
        "GlobalNetworkArn": "arn:aws:networkmanager::987654321012:global-network/global-network-00a77fc0f722dae74",
        "CreatedAt": "2022-03-14T20:31:56+00:00",
        "State": "PENDING"
    }
}

Das folgende Codebeispiel zeigt die Verwendungcreate-link.

AWS CLI

Um einen Link zu erstellen

Im folgenden Beispiel für create-link wird ein Gerät in einem globalen Netzwerk erstellt. Der Link enthält eine Beschreibung und Details zu Linktyp, Bandbreite und Anbieter. Die Standort-ID gibt den Standort an, dem der Link zugeordnet ist.

aws networkmanager create-link \
    --global-network-id global-network-01231231231231231 \
    --description "VPN Link" \
    --type "broadband" \
    --bandwidth UploadSpeed=10,DownloadSpeed=20 \
    --provider "AnyCompany" \
    --site-id site-444555aaabbb11223 \
    --region us-west-2

Ausgabe:

{
    "Link": {
        "LinkId": "link-11112222aaaabbbb1",
        "LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
        "GlobalNetworkId": "global-network-01231231231231231",
        "SiteId": "site-444555aaabbb11223",
        "Description": "VPN Link",
        "Type": "broadband",
        "Bandwidth": {
            "UploadSpeed": 10,
            "DownloadSpeed": 20
        },
        "Provider": "AnyCompany",
        "CreatedAt": 1575555811.0,
        "State": "PENDING"
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Links im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie CreateLinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-site.

AWS CLI

Um eine Site zu erstellen

Im folgenden Beispiel für create-site wird ein Gerät in einem globalen Netzwerk erstellt. Die Standortdetails umfassen eine Beschreibung und Standortinformationen.

aws networkmanager create-site \
    --global-network-id global-network-01231231231231231 \
    --description  "New York head office" \
    --location Latitude=40.7128,Longitude=-74.0060 \
    --region us-west-2

Ausgabe:

{
    "Site": {
        "SiteId": "site-444555aaabbb11223",
        "SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York head office",
        "Location": {
            "Latitude": "40.7128",
            "Longitude": "-74.0060"
        },
        "CreatedAt": 1575554300.0,
        "State": "PENDING"
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Standorten im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie CreateSitein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-vpc-attachment.

AWS CLI

So erstellen Sie einen VPC-Anhang

Im folgenden create-vpc-attachment Beispiel wird ein VPC-Anhang mit IPv6 Unterstützung in einem Kernnetzwerk erstellt.

aws networkmanager create-vpc-attachment \
    --core-network-id core-network-0fab62fe438d94db6 \
    --vpc-arn arn:aws:ec2:us-east-1:987654321012:vpc/vpc-09f37f69e2786eeb8  \
    --subnet-arns arn:aws:ec2:us-east-1:987654321012:subnet/subnet-04ca4e010857e7bb7 \
    --Ipv6Support=true

Ausgabe:

{
    "VpcAttachment": {
        "Attachment": {
            "CoreNetworkId": "core-network-0fab62fe438d94db6",
            "AttachmentId": "attachment-05e1da6eba87a06e6",
            "OwnerAccountId": "987654321012",
            "AttachmentType": "VPC",
            "State": "CREATING",
            "EdgeLocation": "us-east-1",
            "ResourceArn": "arn:aws:ec2:us-east-1:987654321012:vpc/vpc-09f37f69e2786eeb8",
            "Tags": [],
            "CreatedAt": "2022-03-10T20:59:14+00:00",
            "UpdatedAt": "2022-03-10T20:59:14+00:00"
        },
        "SubnetArns": [
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-04ca4e010857e7bb7"
        ],
        "Options": {
            "Ipv6Support": true
        }
    }
}

Weitere Informationen finden Sie unter Erstellen eines Anhangs im Benutzerhandbuch zu Cloud WAN.

Das folgende Codebeispiel zeigt die Verwendungdelete-attachment.

AWS CLI

So löschen Sie einen Anhang

Im folgenden Beispiel für delete-attachment wird ein Connect-Anhang gelöscht.

aws networkmanager delete-attachment \
    --attachment-id attachment-01feddaeae26ab68c

Ausgabe:

{
    "Attachment": {
        "CoreNetworkId": "core-network-0f4b0a9d5ee7761d1",
        "AttachmentId": "attachment-01feddaeae26ab68c",
        "OwnerAccountId": "987654321012",
        "AttachmentType": "CONNECT",
        "State": "DELETING",
        "EdgeLocation": "us-east-1",
        "ResourceArn": "arn:aws:networkmanager::987654321012:attachment/attachment-02c3964448fedf5aa",
        "CreatedAt": "2022-03-15T19:18:41+00:00",
        "UpdatedAt": "2022-03-15T19:28:59+00:00"
    }
}

Weitere Informationen finden Sie unter Löschen von Anhängen im Benutzerhandbuch zu Cloud WAN.

  • Einzelheiten zur API finden Sie DeleteAttachmentin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-bucket-analytics-configuration.

AWS CLI

So löschen Sie eine Analytics-Konfiguration für einen Bucket

Im folgenden Beispiel für delete-bucket-analytics-configuration wird die Analytics-Konfiguration für den angegebenen Bucket und die angegebene ID entfernt.

aws s3api delete-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt die Verwendungdelete-bucket-metrics-configuration.

AWS CLI

So löschen Sie eine Metrik-Konfiguration für einen Bucket

Im folgenden Beispiel für delete-bucket-metrics-configuration wird die Metrik-Konfiguration für den angegebenen Bucket und die angegebene ID entfernt.

aws s3api delete-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt die Verwendungdelete-core-network.

AWS CLI

So löschen Sie ein Kernnetzwerk

Im folgenden Beispiel für delete-core-network wird ein Kernnetzwerk aus einem globalen Cloud WAN-Netzwerk gelöscht.

aws networkmanager delete-core-network \
    --core-network-id core-network-0fab62fe438d94db6

Ausgabe:

{
    "CoreNetwork": {
        "GlobalNetworkId": "global-network-0d59060f16a73bc41",
        "CoreNetworkId": "core-network-0fab62fe438d94db6",
        "Description": "Main headquarters location",
        "CreatedAt": "2021-12-09T18:31:11+00:00",
        "State": "DELETING",
        "Segments": [
            {
                "Name": "dev",
                "EdgeLocations": [
                    "us-east-1"
                ],
                "SharedSegments": []
            }
        ],
        "Edges": [
            {
                "EdgeLocation": "us-east-1",
                "Asn": 64512,
                "InsideCidrBlocks": []
            }
        ]
    }
}

Weitere Informationen finden Sie unter Kernnetzwerke im Benutzerhandbuch zu Cloud WAN.

Das folgende Codebeispiel zeigt die Verwendungdelete-device.

AWS CLI

Um ein Gerät zu löschen

Im folgenden Beispiel für delete-device wird das angegebene Gerät aus dem angegebenen globalen Netzwerk gelöscht.

aws networkmanager delete-device \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --region us-west-2

Ausgabe:

{
    "Device": {
        "DeviceId": "device-07f6fd08867abc123",
        "DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York office device",
        "Type": "office device",
        "Vendor": "anycompany",
        "Model": "abcabc",
        "SerialNumber": "1234",
        "SiteId": "site-444555aaabbb11223",
        "CreatedAt": 1575554005.0,
        "State": "DELETING"
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Geräten im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie DeleteDevicein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-global-network.

AWS CLI

So löschen Sie ein globales Netzwerk

Mit dem folgenden Beispiel für delete-global-network wird ein globales Netzwerk gelöscht.

aws networkmanager delete-global-network \
    --global-network-id global-network-052bedddccb193b6b

Ausgabe:

{
    "GlobalNetwork": {
        "GlobalNetworkId": "global-network-052bedddccb193b6b",
        "GlobalNetworkArn": "arn:aws:networkmanager::987654321012:global-network/global-network-052bedddccb193b6b",
        "CreatedAt": "2021-12-09T18:19:12+00:00",
        "State": "DELETING"
    }
}

Das folgende Codebeispiel zeigt die Verwendungdelete-link.

AWS CLI

Um einen Link zu löschen

Im folgenden Beispiel für delete-link wird der angegebene Link aus dem angegebenen globalen Netzwerk gelöscht.

aws networkmanager delete-link \
    --global-network-id global-network-01231231231231231  \
    --link-id link-11112222aaaabbbb1 \
    --region us-west-2

Ausgabe:

{
    "Link": {
        "LinkId": "link-11112222aaaabbbb1",
        "LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
        "GlobalNetworkId": "global-network-01231231231231231",
        "SiteId": "site-444555aaabbb11223",
        "Description": "VPN Link",
        "Type": "broadband",
        "Bandwidth": {
            "UploadSpeed": 20,
            "DownloadSpeed": 20
        },
        "Provider": "AnyCompany",
        "CreatedAt": 1575555811.0,
        "State": "DELETING"
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Links im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie DeleteLinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-public-access-block.

AWS CLI

So löschen Sie die Konfiguration zum Blockieren des öffentlichen Zugriffs für einen Bucket

Im folgenden Beispiel für delete-public-access-block wird die Konfiguration zum Blockieren des öffentlichen Zugriffs für den angegebenen Bucket entfernt.

aws s3api delete-public-access-block \
    --bucket amzn-s3-demo-bucket

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt die Verwendungdelete-site.

AWS CLI

So löschen Sie einen Standort

Im folgenden Beispiel für delete-site wird der angegebene Standort (site-444555aaabbb11223) aus dem angegebenen globalen Netzwerk gelöscht.

aws networkmanager delete-site \
    --global-network-id global-network-01231231231231231  \
    --site-id site-444555aaabbb11223 \
    --region us-west-2

Ausgabe:

{
    "Site": {
        "SiteId": "site-444555aaabbb11223",
        "SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York head office",
        "Location": {
            "Latitude": "40.7128",
            "Longitude": "-74.0060"
        },
        "CreatedAt": 1575554300.0,
        "State": "DELETING"
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Standorten im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie DeleteSitein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungderegister-transit-gateway.

AWS CLI

So heben Sie die Registrierung eines Transit-Gateways in einem globalen Netzwerk auf

Im folgenden Beispiel für deregister-transit-gateway wird die Registrierung des angegebenen Transit-Gateways im angegebenen globalen Netzwerk aufgehoben.

aws networkmanager deregister-transit-gateway \
    --global-network-id global-network-01231231231231231 \
    --transit-gateway-arn arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc \
    --region us-west-2

Ausgabe:

{
    "TransitGatewayRegistration": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
        "State": {
            "Code": "DELETING"
        }
    }
}

Weitere Informationen finden Sie unter Transit-Gateway-Zuordnungen im Handbuch zu Transit Gateway Network Manager.

Das folgende Codebeispiel zeigt die Verwendungdescribe-global-networks.

AWS CLI

So beschreiben Sie globale Netzwerke

Im folgenden Beispiel für describe-global-networks werden alle globalen Netzwerke im Konto beschrieben.

aws networkmanager describe-global-networks \
    --region us-west-2

Ausgabe:

{
    "GlobalNetworks": [
        {
            "GlobalNetworkId": "global-network-01231231231231231",
            "GlobalNetworkArn": "arn:aws:networkmanager::123456789012:global-network/global-network-01231231231231231",
            "Description": "Company 1 global network",
            "CreatedAt": 1575553525.0,
            "State": "AVAILABLE"
        }
    ]
}

Das folgende Codebeispiel zeigt die Verwendungdisassociate-customer-gateway.

AWS CLI

So heben Sie die Zuordnung zu einem Kunden-Gateway auf

Im folgenden Beispiel für disassociate-customer-gateway wird die Zuordnung zwischen dem angegebenen Kunden-Gateway (cgw-11223344556677889) und dem angegebenen globalen Netzwerk aufgehoben.

aws networkmanager disassociate-customer-gateway \
    --global-network-id global-network-01231231231231231 \
    --customer-gateway-arn arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889 \
    --region us-west-2

Ausgabe:

{
    "CustomerGatewayAssociation": {
        "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "State": "DELETING"
    }
}

Weitere Informationen finden Sie unter Kunden-Gateway-Zuordnungen im Handbuch zu Transit Gateway Network Manager.

Das folgende Codebeispiel zeigt die Verwendungdisassociate-link.

AWS CLI

So heben Sie die Zuordnung eines Links auf

Im folgenden Beispiel für disassociate-link wird die Zuordnung des angegebenen Links vom Gerät device-07f6fd08867abc123 im angegebenen globalen Netzwerk aufgehoben.

aws networkmanager disassociate-link \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --link-id link-11112222aaaabbbb1 \
    --region us-west-2

Ausgabe:

{
    "LinkAssociation": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "LinkId": "link-11112222aaaabbbb1",
        "LinkAssociationState": "DELETING"
    }
}

Weitere Informationen finden Sie unter Geräte- und Link-Zuordnungen im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie DisassociateLinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-bucket-analytics-configuration.

AWS CLI

So rufen Sie die Analytics-Konfiguration für einen Bucket mit einer bestimmten ID ab

Im folgenden Beispiel für get-bucket-analytics-configuration wird die Analytics-Konfiguration für den angegebenen Bucket und die angegebene ID angezeigt.

aws s3api get-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1

Ausgabe:

{
    "AnalyticsConfiguration": {
        "StorageClassAnalysis": {},
        "Id": "1"
    }
}

Das folgende Codebeispiel zeigt die Verwendungget-bucket-metrics-configuration.

AWS CLI

So rufen Sie die Metrik-Konfiguration für einen Bucket mit einer bestimmten ID ab

Im folgenden Beispiel für get-bucket-metrics-configuration wird die Metrik-Konfiguration für den angegebenen Bucket und die angegebene ID angezeigt.

aws s3api get-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123

Ausgabe:

{
    "MetricsConfiguration": {
        "Filter": {
            "Prefix": "logs"
        },
        "Id": "123"
    }
}

Das folgende Codebeispiel zeigt die Verwendungget-customer-gateway-associations.

AWS CLI

So rufen Sie die Kunden-Gateway-Zuordnungen ab

Im folgenden Beispiel für get-customer-gateway-associations werden die Kunden-Gateway-Zuordnungen für das angegebene globale Netzwerk abgerufen.

aws networkmanager get-customer-gateway-associations \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

Ausgabe:

{
    "CustomerGatewayAssociations": [
        {
            "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
            "GlobalNetworkId": "global-network-01231231231231231",
            "DeviceId": "device-07f6fd08867abc123",
            "State": "AVAILABLE"
        }
    ]
}

Das folgende Codebeispiel zeigt die Verwendungget-devices.

AWS CLI

So rufen Sie die Geräte ab

Im folgenden Beispiel für get-devices werden die Geräte im angegebenen globalen Netzwerk abgerufen.

aws networkmanager get-devices \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

Ausgabe:

{
    "Devices": [
        {
            "DeviceId": "device-07f6fd08867abc123",
            "DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
            "GlobalNetworkId": "global-network-01231231231231231",
            "Description": "NY office device",
            "Type": "office device",
            "Vendor": "anycompany",
            "Model": "abcabc",
            "SerialNumber": "1234",
            "CreatedAt": 1575554005.0,
            "State": "AVAILABLE"
        }
    ]
}

  • Einzelheiten zur API finden Sie GetDevicesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-link-associations.

AWS CLI

So rufen Sie Link-Zuordnungen ab

Im folgenden Beispiel für get-link-associations werden die Link-Zuordnungen im angegebenen globalen Netzwerk abgerufen.

aws networkmanager get-link-associations \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

Ausgabe:

{
    "LinkAssociations": [
        {
            "GlobalNetworkId": "global-network-01231231231231231",
            "DeviceId": "device-07f6fd08867abc123",
            "LinkId": "link-11112222aaaabbbb1",
            "LinkAssociationState": "AVAILABLE"
        }
    ]
}

Das folgende Codebeispiel zeigt die Verwendungget-links.

AWS CLI

So rufen Sie Links ab

Im folgenden Beispiel für get-links werden die Links im angegebenen globalen Netzwerk abgerufen.

aws networkmanager get-links \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

Ausgabe:

{
    "Links": [
        {
            "LinkId": "link-11112222aaaabbbb1",
            "LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
            "GlobalNetworkId": "global-network-01231231231231231",
            "SiteId": "site-444555aaabbb11223",
            "Description": "VPN Link",
            "Type": "broadband",
            "Bandwidth": {
                "UploadSpeed": 10,
                "DownloadSpeed": 20
            },
            "Provider": "AnyCompany",
            "CreatedAt": 1575555811.0,
            "State": "AVAILABLE"
        }
    ]
}

  • Einzelheiten zur API finden Sie GetLinksin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-object-retention.

AWS CLI

So rufen Sie die Konfiguration für die Aufbewahrung eines Objekts ab

Im folgenden Beispiel für get-object-retention wird die Konfiguration für die Aufbewahrung des angegebenen Objekts abgerufen.

aws s3api get-object-retention \
    --bucket amzn-s3-demo-bucket-with-object-lock \
    --key doc1.rtf

Ausgabe:

{
    "Retention": {
        "Mode": "GOVERNANCE",
        "RetainUntilDate": "2025-01-01T00:00:00.000Z"
    }
}

Das folgende Codebeispiel zeigt die Verwendungget-public-access-block.

AWS CLI

So richten Sie die Konfiguration zum Blockieren des öffentlichen Zugriffs für einen Bucket ein oder ändern sie

Im folgenden Beispiel für get-public-access-block wird die Konfiguration zum Blockieren des öffentlichen Zugriff für den angegebenen Bucket angezeigt.

aws s3api get-public-access-block --bucket amzn-s3-demo-bucket

Ausgabe:

{
    "PublicAccessBlockConfiguration": {
        "IgnorePublicAcls": true,
        "BlockPublicPolicy": true,
        "BlockPublicAcls": true,
        "RestrictPublicBuckets": true
    }
}

Das folgende Codebeispiel zeigt die Verwendungget-sites.

AWS CLI

So rufen Sie die Standorte ab

Im folgenden Beispiel für get-sites werden die Standorte im angegebenen globalen Netzwerk abgerufen.

aws networkmanager get-sites \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

Ausgabe:

{
    "Sites": [
        {
            "SiteId": "site-444555aaabbb11223",
            "SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
            "GlobalNetworkId": "global-network-01231231231231231",
            "Description": "NY head office",
            "Location": {
                "Latitude": "40.7128",
                "Longitude": "-74.0060"
            },
            "CreatedAt": 1575554528.0,
            "State": "AVAILABLE"
        }
    ]
}

  • Einzelheiten zur API finden Sie GetSitesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-transit-gateway-registrations.

AWS CLI

So rufen Sie die registrierten Transit-Gateways ab

Im folgenden Beispiel für get-transit-gateway-registrations werden Transit-Gateways abgerufen, die in einem globalen Netzwerk registriert sind.

aws networkmanager get-transit-gateway-registrations \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2

Ausgabe:

{
    "TransitGatewayRegistrations": [
        {
            "GlobalNetworkId": "global-network-01231231231231231",
            "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
            "State": {
                "Code": "AVAILABLE"
            }
        }
    ]
}

Das folgende Codebeispiel zeigt die Verwendungget-vpc-attachment.

AWS CLI

So rufen Sie einen VPC-Anhang ab

Im folgenden Beispiel für get-vpc-attachment werden Informationen zu einem VPC-Anhang zurückgegeben.

aws networkmanager get-vpc-attachment \
    --attachment-id  attachment-03b7ea450134787da

Ausgabe:

{
    "VpcAttachment": {
        "Attachment": {
            "CoreNetworkId": "core-network-0522de1b226a5d7b3",
            "AttachmentId": "attachment-03b7ea450134787da",
            "OwnerAccountId": "987654321012",
            "AttachmentType": "VPC",
            "State": "CREATING",
            "EdgeLocation": "us-east-1",
            "ResourceArn": "arn:aws:ec2:us-east-1:987654321012:vpc/vpc-a7c4bbda",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "DevVPC"
                }
            ],
            "CreatedAt": "2022-03-11T17:48:58+00:00",
            "UpdatedAt": "2022-03-11T17:48:58+00:00"
        },
        "SubnetArns": [
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-202cde6c",
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-e5022dba",
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-2387ae02",
            "arn:aws:ec2:us-east-1:987654321012:subnet/subnet-cda9dffc"
        ],
        "Options": {
            "Ipv6Support": false
        }
    }
}

Weitere Informationen finden Sie unter Anhänge im Benutzerhandbuch zu Cloud WAN.

  • Einzelheiten zur API finden Sie GetVpcAttachmentin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-bucket-analytics-configurations.

AWS CLI

So rufen Sie eine Liste der Analytics-Konfigurationen für einen Bucket ab

Im folgenden Beispiel für list-bucket-analytics-configurations wird eine Liste mit Analytics-Konfigurationen für den angegebenen Bucket abgerufen.

aws s3api list-bucket-analytics-configurations \
    --bucket amzn-s3-demo-bucket

Ausgabe:

{
    "AnalyticsConfigurationList": [
        {
            "StorageClassAnalysis": {},
            "Id": "1"
        }
    ],
    "IsTruncated": false
}

Das folgende Codebeispiel zeigt die Verwendunglist-bucket-metrics-configurations.

AWS CLI

So rufen Sie eine Liste der Metrik-Konfigurationen für einen Bucket ab

Im folgenden Beispiel für list-bucket-metrics-configurations wird eine Liste mit Metrik-Konfigurationen für den angegebenen Bucket abgerufen.

aws s3api list-bucket-metrics-configurations \
    --bucket amzn-s3-demo-bucket

Ausgabe:

{
    "IsTruncated": false,
    "MetricsConfigurationList": [
        {
            "Filter": {
                "Prefix": "logs"
            },
            "Id": "123"
        },
        {
            "Filter": {
                "Prefix": "tmp"
            },
            "Id": "234"
        }
    ]
}

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

So listen Sie die Tags für eine Ressource auf

Im folgenden Beispiel für list-tags-for-resource werden die Tags für die angegebene Geräteressource (device-07f6fd08867abc123) aufgelistet.

aws networkmanager list-tags-for-resource \
    --resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 \
    --region us-west-2

Ausgabe:

{
    "TagList": [
        {
            "Key": "Network",
            "Value": "Northeast"
        }
    ]
}

Das folgende Codebeispiel zeigt die Verwendungput-bucket-metrics-configuration.

AWS CLI

So legen Sie eine Metrik-Konfiguration für einen Bucket fest

Im folgenden Beispiel für put-bucket-metrics-configuration wird eine Metrik-Konfiguration mit der ID 123 für den angegebenen Bucket festgelegt.

aws s3api put-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123 \
    --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt die Verwendungput-object-retention.

AWS CLI

So legen Sie die Konfiguration für die Aufbewahrung eines Objekts fest

Im folgenden Beispiel für put-object-retention wird eine Konfiguration für die Aufbewahrung des angegebenen Objekts bis zum 01.01.2025 festgelegt.

aws s3api put-object-retention \
    --bucket amzn-s3-demo-bucket-with-object-lock \
    --key doc1.rtf \
    --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt die Verwendungput-public-access-block.

AWS CLI

So richten Sie die Konfiguration zum Blockieren des öffentlichen Zugriffs für einen Bucket ein

Im folgenden Beispiel für put-public-access-block wird die Konfiguration zum Blockieren des öffentlichen Zugriff für den angegebenen Bucket eingerichtet.

aws s3api put-public-access-block \
    --bucket amzn-s3-demo-bucket \
    --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt die Verwendungregister-transit-gateway.

AWS CLI

So registrieren Sie ein Transit-Gateway bei einem globalen Netzwerk

Im folgenden Beispiel für register-transit-gateway wird das Transit-Gateway tgw-123abc05e04123abc in einem globalen Netzwerk registriert.

aws networkmanager register-transit-gateway \
    --global-network-id global-network-01231231231231231 \
    --transit-gateway-arn arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc \
    --region us-west-2

Ausgabe:

{
    "TransitGatewayRegistration": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
        "State": {
            "Code": "PENDING"
        }
    }
}

Weitere Informationen finden Sie unter Transit-Gateway-Zuordnungen im Handbuch zu Transit Gateway Network Manager.

Das folgende Codebeispiel zeigt die Verwendungreject-attachment.

AWS CLI

So lehnen Sie einen Anhang ab

Im folgenden Beispiel für reject-attachment wird die Anforderung eines VPC-Anhangs abgelehnt.

aws networkmanager reject-attachment \
    --attachment-id  attachment-03b7ea450134787da

Ausgabe:

{
    "Attachment": {
        "CoreNetworkId": "core-network-0522de1b226a5d7b3",
        "AttachmentId": "attachment-03b7ea450134787da",
        "OwnerAccountId": "987654321012",
        "AttachmentType": "VPC",
        "State": "AVAILABLE",
        "EdgeLocation": "us-east-1",
        "ResourceArn": "arn:aws:ec2:us-east-1:987654321012:vpc/vpc-a7c4bbda",
        "CreatedAt": "2022-03-11T17:48:58+00:00",
        "UpdatedAt": "2022-03-11T17:51:25+00:00"
    }
}

Weitere Informationen finden Sie unter Annahme von Anhängen im Benutzerhandbuch zu Cloud WAN.

  • Einzelheiten zur API finden Sie RejectAttachmentin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-route-analysis.

AWS CLI

So starten Sie die Routenanalyse

Im folgenden Beispiel für start-route-analysis wird die Analyse zwischen einer Quelle und einem Ziel gestartet, einschließlich des optionalen include-return-path.

aws networkmanager start-route-analysis \
    --global-network-id global-network-00aa0aaa0b0aaa000 \
    --source TransitGatewayAttachmentArn=arn:aws:ec2:us-east-1:503089527312:transit-gateway-attachment/tgw-attach-0d4a2d491bf68c093,IpAddress=10.0.0.0 \
    --destination TransitGatewayAttachmentArn=arn:aws:ec2:us-west-1:503089527312:transit-gateway-attachment/tgw-attach-002577f30bb181742,IpAddress=11.0.0.0 \
    --include-return-path

Ausgabe:

{
    "RouteAnalysis": {
        "GlobalNetworkId": "global-network-00aa0aaa0b0aaa000
        "OwnerAccountId": "1111222233333",
        "RouteAnalysisId": "a1873de1-273c-470c-1a2bc2345678",
        "StartTimestamp": 1695760154.0,
        "Status": "RUNNING",
        "Source": {
            "TransitGatewayAttachmentArn": "arn:aws:ec2:us-east-1:111122223333:transit-gateway-attachment/tgw-attach-1234567890abcdef0,
            "TransitGatewayArn": "arn:aws:ec2:us-east-1:111122223333:transit-gateway/tgw-abcdef01234567890",
            "IpAddress": "10.0.0.0"
        },
        "Destination": {
            "TransitGatewayAttachmentArn": "arn:aws:ec2:us-west-1:555555555555:transit-gateway-attachment/tgw-attach-021345abcdef6789",
            "TransitGatewayArn": "arn:aws:ec2:us-west-1:111122223333:transit-gateway/tgw-09876543210fedcba0",
            "IpAddress": "11.0.0.0"
        },
        "IncludeReturnPath": true,
        "UseMiddleboxes": false
    }
}

Weitere Informationen finden Sie unter Routenanalyse im Benutzerhandbuch zu globalen AWS -Netzwerken für Transit-Gateways.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

So fügen Sie einer Ressource Tags hinzu

Im folgenden Beispiel für tag-resource wird das Tag Network=Northeast auf das Gerät device-07f6fd08867abc123 angewendet.

aws networkmanager tag-resource \
    --resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 \
    --tags Key=Network,Value=Northeast \
    --region us-west-2

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

  • Einzelheiten zur API finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

So entfernen Sie Tags aus einer Ressource

Im folgenden Beispiel für untag-resource wird das Tag mit dem Schlüsselnamen Network aus dem Gerät device-07f6fd08867abc123 entfernt.

aws networkmanager untag-resource \
    --resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 ]
    --tag-keys Network \
    --region us-west-2

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

  • Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-device.

AWS CLI

Um ein Gerät zu aktualisieren

Im folgenden Beispiel für update-device wird das Gerät device-07f6fd08867abc123 durch Angabe einer Standort-ID aktualisiert.

aws networkmanager update-device \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --site-id site-444555aaabbb11223 \
    --region us-west-2

Ausgabe:

{
    "Device": {
        "DeviceId": "device-07f6fd08867abc123",
        "DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "NY office device",
        "Type": "Office device",
        "Vendor": "anycompany",
        "Model": "abcabc",
        "SerialNumber": "1234",
        "SiteId": "site-444555aaabbb11223",
        "CreatedAt": 1575554005.0,
        "State": "UPDATING"
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Geräten im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie UpdateDevicein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-global-network.

AWS CLI

So aktualisieren Sie ein globales Netzwerk

Im folgenden Beispiel für update-global-network wird die Beschreibung für das globale Netzwerk global-network-01231231231231231aktualisiert.

aws networkmanager update-global-network \
    --global-network-id global-network-01231231231231231 \
    --description "Head offices" \
    --region us-west-2

Ausgabe:

{
    "GlobalNetwork": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "GlobalNetworkArn": "arn:aws:networkmanager::123456789012:global-network/global-network-01231231231231231",
        "Description": "Head offices",
        "CreatedAt": 1575553525.0,
        "State": "UPDATING"
    }
}

Weitere Informationen finden Sie unter Globale Netzwerke im Handbuch zu Transit Gateway Network Manager.

Das folgende Codebeispiel zeigt die Verwendungupdate-link.

AWS CLI

Um einen Link zu aktualisieren

Im folgenden Beispiel für update-link werden die Bandbreiteninformationen für den Link link-11112222aaaabbbb1 aktualisiert.

aws networkmanager update-link \
    --global-network-id global-network-01231231231231231 \
    --link-id link-11112222aaaabbbb1 \
    --bandwidth  UploadSpeed=20,DownloadSpeed=20 \
    --region us-west-2

Ausgabe:

{
    "Link": {
        "LinkId": "link-11112222aaaabbbb1",
        "LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1",
        "GlobalNetworkId": "global-network-01231231231231231",
        "SiteId": "site-444555aaabbb11223",
        "Description": "VPN Link",
        "Type": "broadband",
        "Bandwidth": {
            "UploadSpeed": 20,
            "DownloadSpeed": 20
        },
        "Provider": "AnyCompany",
        "CreatedAt": 1575555811.0,
        "State": "UPDATING"
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Links im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie UpdateLinkin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-site.

AWS CLI

So aktualisieren Sie einen Standort

Im folgenden Beispiel für update-site wird die Beschreibung für den Standort site-444555aaabbb11223 im angegebenen globalen Netzwerk aktualisiert.

aws networkmanager update-site \
    --global-network-id global-network-01231231231231231 \
    --site-id site-444555aaabbb11223 \
    --description "New York Office site" \
    --region us-west-2

Ausgabe:

{
    "Site": {
        "SiteId": "site-444555aaabbb11223",
        "SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223",
        "GlobalNetworkId": "global-network-01231231231231231",
        "Description": "New York Office site",
        "Location": {
            "Latitude": "40.7128",
            "Longitude": "-74.0060"
        },
        "CreatedAt": 1575554528.0,
        "State": "UPDATING"
    }
}

Weitere Informationen finden Sie unter Arbeiten mit Standorten im Handbuch zu Transit Gateway Network Manager.

  • Einzelheiten zur API finden Sie UpdateSitein der AWS CLI Befehlsreferenz.