Beispiele für die Verwendung der AWS CLI mit Network Manager - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit Network Manager

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Network Manager nutzen.

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 associate-customer-gateway verwendet wird.

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, wie associate-link verwendet wird.

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.

  • Weitere Details zur API finden Sie unter AssociateLink in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-core-network verwendet wird.

AWS CLI

So erstellen Sie ein Kernnetzwerk

Im folgenden Beispiel für create-core-network wird ein Kernnetzwerk mithilfe einer optionalen Beschreibung und von 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 Benutzerhandbuch zu AWS-Cloud-WAN.

  • Weitere Details zur API finden Sie unter CreateCoreNetwork in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-device verwendet wird.

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.

  • Weitere Details zu API finden Sie unter CreateDevice in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-global-network verwendet wird.

AWS CLI

So erstellen Sie ein globales Netzwerk

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"
    }
}

  • Weitere Details zur API finden Sie unter CreateGlobalNetwork in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-link verwendet wird.

AWS CLI

So erstellen Sie einen Link

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.

  • Weitere Details zur API finden Sie unter CreateLink in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-site verwendet wird.

AWS CLI

So erstellen Sie einen Standort

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.

  • Weitere Details zur API finden Sie unter CreateSite in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-vpc-attachment verwendet wird.

AWS CLI

So erstellen Sie einen VPC-Anhang

Im folgenden Beispiel für create-vpc-attachment 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.

  • Weitere Details zur API finden Sie unter CreateVpcAttachment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-attachment verwendet wird.

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 Delete attachments im Benutzerhandbuch zu Cloud WAN.

  • Weitere Details zur API finden Sie unter DeleteAttachment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-bucket-analytics-configuration verwendet wird.

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, wie delete-bucket-metrics-configuration verwendet wird.

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, wie delete-core-network verwendet wird.

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.

  • Weitere Details zur API finden Sie unter DeleteCoreNetwork in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-device verwendet wird.

AWS CLI

So löschen Sie ein Gerät

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.

  • Weitere Details zur API finden Sie unter DeleteDevice in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-global-network verwendet wird.

AWS CLI

So löschen Sie ein globales Netzwerk

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

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"
    }
}

  • Weitere Details zur API finden Sie unter DeleteGlobalNetwork in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-link verwendet wird.

AWS CLI

So löschen Sie einen Link

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.

  • Weitere Details zur API finden Sie unter DeleteLink in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-public-access-block verwendet wird.

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 Zugriff 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, wie delete-site verwendet wird.

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.

  • Weitere Details zur API finden Sie unter DeleteSite in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie deregister-transit-gateway verwendet wird.

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, wie describe-global-networks verwendet wird.

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, wie disassociate-customer-gateway verwendet wird.

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, wie disassociate-link verwendet wird.

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.

  • Weitere Details zur API finden Sie unter DisassociateLink in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-bucket-analytics-configuration verwendet wird.

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, wie get-bucket-metrics-configuration verwendet wird.

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, wie get-customer-gateway-associations verwendet wird.

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, wie get-devices verwendet wird.

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"
        }
    ]
}

  • Details zur API finden Sie unter GetDevices in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-link-associations verwendet wird.

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, wie get-links verwendet wird.

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"
        }
    ]
}

  • Weitere Details zur API finden Sie unter GetLinks in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-object-retention verwendet wird.

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"
    }
}

  • Weitere Details zur API finden Sie unter GetObjectRetention in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-public-access-block verwendet wird.

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, wie get-sites verwendet wird.

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"
        }
    ]
}

  • Weitere Details zur API finden Sie unter GetSites in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-transit-gateway-registrations verwendet wird.

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, wie get-vpc-attachment verwendet wird.

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.

  • Weitere Details zur API finden Sie unter GetVpcAttachment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-bucket-analytics-configurations verwendet wird.

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 von 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, wie list-bucket-metrics-configurations verwendet wird.

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 von 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, wie list-tags-for-resource verwendet wird.

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, wie put-bucket-metrics-configuration verwendet wird.

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, wie put-object-retention verwendet wird.

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.

  • Weitere Details zur API finden Sie unter PutObjectRetention in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-public-access-block verwendet wird.

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, wie register-transit-gateway verwendet wird.

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, wie reject-attachment verwendet wird.

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 Attachment acceptance im Benutzerhandbuch zu Cloud WAN.

  • Weitere Details zur API finden Sie unter RejectAttachment in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie start-route-analysis verwendet wird.

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.

  • Weitere Details zur API finden Sie unter StartRouteAnalysis in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

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.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie Tags von 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.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-device verwendet wird.

AWS CLI

So aktualisieren Sie ein Gerät

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.

  • Weitere Details zur API finden Sie unter UpdateDevice in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-global-network verwendet wird.

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, wie update-link verwendet wird.

AWS CLI

So aktualisieren Sie einen Link

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.

  • Weitere Details zur API finden Sie unter UpdateLink in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-site verwendet wird.

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.

  • Weitere Details zur API finden Sie unter UpdateSite in der AWS CLI-Befehlsreferenz.