Beispiele für Network Manager mit AWS CLI - AWS SDK-Codebeispiele
Aktionen

Weitere AWS SDK-Beispiele sind im Repo AWS Doc SDK Examples GitHub 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.

Beispiele für Network Manager 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 Szenarios anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungassociate-customer-gateway.

AWS CLI

Um ein Kunden-Gateway zuzuordnen

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

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 Customer Gateway Associations im Transit Gateway Network Manager Guide.

Das folgende Codebeispiel zeigt die Verwendungassociate-link.

AWS CLI

Um einen Link zuzuordnen

Das folgende associate-link Beispiel verknüpft einen Link link-11112222aaaabbbb1 mit einem Gerätdevice-07f6fd08867abc123. 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 Verbindungszuordnungen im Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie AssociateLinkunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-core-network.

AWS CLI

Um ein Kernnetzwerk zu erstellen

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

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 AWS Cloud WAN-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungcreate-device.

AWS CLI

Um ein Gerät zu erstellen

Im folgenden create-device Beispiel wird ein Gerät im angegebenen 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 Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie CreateDeviceunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-global-network.

AWS CLI

Um ein globales Netzwerk zu erstellen

Mit den folgenden create-global-network Beispielen wird ein neues globales Netzwerk erstellt. Der Anfangszustand bei der Erstellung istPENDING.

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 create-link Beispiel wird ein Link im angegebenen globalen Netzwerk erstellt. Der Link enthält eine Beschreibung und Details zu Linktyp, Bandbreite und Anbieter. Die Site-ID gibt die Site an, der 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 Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie CreateLinkunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-site.

AWS CLI

Um eine Site zu erstellen

Im folgenden create-site Beispiel wird eine Site im angegebenen globalen Netzwerk erstellt. Die Standortdetails umfassen eine Beschreibung und die 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 im Transit Gateway Network Manager-Handbuch unter Working with Sites.

  • Einzelheiten zur API finden Sie CreateSiteunter 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 Cloud WAN-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-attachment.

AWS CLI

Um einen Anhang zu löschen

Im folgenden delete-attachment Beispiel wird eine Connect-Anlage 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 Cloud WAN-Benutzerhandbuch.

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

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

AWS CLI

Um eine Analytics-Konfiguration für einen Bucket zu löschen

Im folgenden delete-bucket-analytics-configuration Beispiel 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

Um eine Metrikkonfiguration für einen Bucket zu löschen

Im folgenden delete-bucket-metrics-configuration Beispiel wird die Metrikkonfiguration 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

Um ein Kernnetzwerk zu löschen

Das folgende delete-core-network Beispiel löscht ein Kernnetzwerk aus einem globalen Cloud WAN-Netzwerk.

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 Cloud WAN-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-device.

AWS CLI

Um ein Gerät zu löschen

Im folgenden delete-device Beispiel 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 Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie DeleteDeviceunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-global-network.

AWS CLI

Um ein globales Netzwerk zu löschen

Im folgenden delete-global-network Beispiel 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 delete-link Beispiel 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 Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie DeleteLinkunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um die Konfiguration „Öffentlichen Zugriff blockieren“ für einen Bucket zu löschen

Im folgenden delete-public-access-block Beispiel wird die Konfiguration „Öffentlicher Zugriff blockieren“ 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

Um eine Site zu löschen

Im folgenden delete-site Beispiel wird die angegebene Site (site-444555aaabbb11223) im 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 Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie DeleteSiteunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungderegister-transit-gateway.

AWS CLI

Um ein Transit-Gateway von einem globalen Netzwerk abzumelden

Im folgenden deregister-transit-gateway Beispiel wird das angegebene Transit-Gateway vom angegebenen globalen Netzwerk abgemeldet.

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-Registrierungen im Transit Gateway Network Manager-Handbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-global-networks.

AWS CLI

Um Ihre globalen Netzwerke zu beschreiben

Das folgende describe-global-networks Beispiel beschreibt alle Ihre globalen Netzwerke in Ihrem Konto.

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

Um die Zuordnung eines Kunden-Gateways aufzuheben

Im folgenden disassociate-customer-gateway Beispiel wird die Verbindung zwischen dem angegebenen Kunden-Gateway (cgw-11223344556677889) und dem angegebenen globalen Netzwerk getrennt.

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 Customer Gateway Associations im Transit Gateway Network Manager Guide.

Das folgende Codebeispiel zeigt die Verwendungdisassociate-link.

AWS CLI

Um die Verknüpfung eines Links aufzuheben

Im folgenden disassociate-link Beispiel wird die Verbindung zwischen dem angegebenen Link und dem Gerät device-07f6fd08867abc123 im angegebenen globalen Netzwerk getrennt.

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 Verbindungszuordnungen im Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie DisassociateLinkunter AWS CLI Befehlsreferenz.

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

AWS CLI

Um die Analytics-Konfiguration für einen Bucket mit einer bestimmten ID abzurufen

Im folgenden get-bucket-analytics-configuration Beispiel 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

Um die Metrikkonfiguration für einen Bucket mit einer bestimmten ID abzurufen

Im folgenden get-bucket-metrics-configuration Beispiel wird die Metrikkonfiguration 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

Um die Gateway-Verknüpfungen Ihrer Kunden zu erhalten

Im folgenden get-customer-gateway-associations Beispiel werden die Kunden-Gateway-Verknüpfungen 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

Um deine Geräte zu bekommen

Im folgenden get-devices Beispiel 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

Um Ihre Linkzuordnungen zu erhalten

Im folgenden get-link-associations Beispiel werden die Linkzuordnungen 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

Um deine Links zu bekommen

Im folgenden get-links Beispiel 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

Um die Objektaufbewahrungskonfiguration für ein Objekt abzurufen

Im folgenden get-object-retention Beispiel wird die Objektaufbewahrungskonfiguration für das angegebene Objekt 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

Um die Konfiguration für den öffentlichen Zugriff blockieren für einen Bucket festzulegen oder zu ändern

Das folgende get-public-access-block Beispiel zeigt die Konfiguration für den blockierten öffentlichen Zugriff für den angegebenen Bucket.

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

Um deine Websites zu bekommen

Im folgenden get-sites Beispiel werden die Websites 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

Um Ihre Transit-Gateway-Registrierungen zu erhalten

Im folgenden get-transit-gateway-registrations Beispiel werden die Transit-Gateways abgerufen, die im angegebenen 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

Um einen VPC-Anhang zu erhalten

Das folgende get-vpc-attachment Beispiel gibt Informationen über einen VPC-Anhang zurück.

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 Anlagen im Cloud WAN-Benutzerhandbuch.

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

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

AWS CLI

Um eine Liste von Analytics-Konfigurationen für einen Bucket abzurufen

Im Folgenden wird eine Liste der Analytics-Konfigurationen für den angegebenen Bucket list-bucket-analytics-configurations 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

Um eine Liste von Metrikkonfigurationen für einen Bucket abzurufen

Im folgenden list-bucket-metrics-configurations Beispiel wird eine Liste von Metrikkonfigurationen 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

Um die Tags für eine Ressource aufzulisten

Das folgende list-tags-for-resource Beispiel listet die Tags für die angegebene Geräteressource (device-07f6fd08867abc123) auf.

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

Um eine Metrikkonfiguration für einen Bucket festzulegen

Im folgenden put-bucket-metrics-configuration Beispiel wird eine Metrikkonfiguration 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

Um eine Objektaufbewahrungskonfiguration für ein Objekt festzulegen

Im folgenden put-object-retention Beispiel wird eine Objektaufbewahrungskonfiguration für das angegebene Objekt 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 legen Sie die Konfiguration für den blockierten öffentlichen Zugriff für einen Bucket fest

Im folgenden put-public-access-block Beispiel wird eine restriktive Konfiguration für den öffentlichen Blockzugriff für den angegebenen Bucket festgelegt.

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

Um ein Transit-Gateway in einem globalen Netzwerk zu registrieren

Im folgenden register-transit-gateway Beispiel wird ein Transit-Gateway tgw-123abc05e04123abc im angegebenen 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-Registrierungen im Transit Gateway Network Manager-Handbuch.

Das folgende Codebeispiel zeigt die Verwendungreject-attachment.

AWS CLI

Um einen Anhang abzulehnen

Das folgende reject-attachment Beispiel lehnt eine VPC-Anhangsanforderung ab.

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 Cloud WAN-Benutzerhandbuch.

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

Das folgende Codebeispiel zeigt die Verwendungstart-route-analysis.

AWS CLI

Um die Routenanalyse zu starten

Im folgenden start-route-analysis Beispiel wird die Analyse zwischen einer Quelle und einem Ziel gestartet, einschließlich der optionaleninclude-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 Route Analyzer im Benutzerhandbuch für AWS globale Netzwerke für Transit Gateways.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

Um Tags auf eine Ressource anzuwenden

Im folgenden tag-resource Beispiel wird das Tag Network=Northeast auf das Gerät angewendetdevice-07f6fd08867abc123.

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

Um Tags aus einer Ressource zu entfernen

Im folgenden untag-resource Beispiel wird das Tag mit dem Schlüssel Network vom Gerät entferntdevice-07f6fd08867abc123.

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 update-device Beispiel device-07f6fd08867abc123 wird das Gerät aktualisiert, indem eine Site-ID für das Gerät angegeben wird.

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 Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie UpdateDeviceunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-global-network.

AWS CLI

Um ein globales Netzwerk zu aktualisieren

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

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 Global Networks im Transit Gateway Network Manager Guide.

Das folgende Codebeispiel zeigt die Verwendungupdate-link.

AWS CLI

Um einen Link zu aktualisieren

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

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 Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie UpdateLinkunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-site.

AWS CLI

Um eine Site zu aktualisieren

Im folgenden update-site Beispiel wird die Beschreibung der Site 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 Transit Gateway Network Manager-Handbuch.

  • Einzelheiten zur API finden Sie UpdateSiteunter AWS CLI Befehlsreferenz.