Exemples de Network Manager utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exemples de Network Manager utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide de Network Manager.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserassociate-customer-gateway.

AWS CLI

Pour associer une passerelle client

L’exemple associate-customer-gateway suivant associe la passerelle client cgw-11223344556677889 dans le réseau mondial spécifié à l’appareil device-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

Sortie :

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

Pour plus d’informations, consultez Associations de passerelles client dans le Guide de Transit Gateway Network Manager.

L'exemple de code suivant montre comment utiliserassociate-link.

AWS CLI

Pour associer un lien

L’exemple associate-link suivant associe un lien link-11112222aaaabbbb1 à l’appareil device-07f6fd08867abc123. Le lien et l’appareil se trouvent dans le réseau mondial spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Associations d’appareils et de liens dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, voir AssociateLinkla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-core-network.

AWS CLI

Pour créer un réseau principal

L'create-core-networkexemple suivant crée un réseau central à l'aide d'une description facultative et de balises au sein d'un réseau mondial AWS Cloud WAN.

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

Sortie :

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

Pour plus d’informations, consultez Global and core networks dans le Guide de l’utilisateur AWS  Cloud WAN.

  • Pour plus de détails sur l'API, voir CreateCoreNetworkla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-device.

AWS CLI

Pour créer un appareil

L’exemple create-device suivant crée un appareil dans un réseau mondial spécifié. Les détails de l’appareil incluent une description, le type, le fournisseur, le modèle et le numéro de série.

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

Sortie :

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

Pour plus d’informations, consultez Gestion des appareils dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, voir CreateDevicela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-global-network.

AWS CLI

Pour créer un réseau mondial

L’exemple create-global-network suivant crée un nouveau réseau mondial. L’état initial lors de la création est PENDING.

aws networkmanager create-global-network

Sortie :

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

  • Pour plus de détails sur l'API, voir CreateGlobalNetworkla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-link.

AWS CLI

Pour créer un lien

L’exemple create-link suivant crée un lien dans le réseau mondial spécifié. Le lien inclut une description et des détails sur le type de lien, la bande passante et le fournisseur. L’ID du site indique le site auquel le lien est associé.

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

Sortie :

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

Pour plus d’informations, consultez Utilisation des liens dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, voir CreateLinkla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-site.

AWS CLI

Pour créer un site

L’exemple create-site suivant crée un site dans le réseau mondial spécifié. Les détails du site incluent une description et les informations de localisation.

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

Sortie :

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

Pour plus d’informations, consultez Utilisation des sites dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, voir CreateSitela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-vpc-attachment.

AWS CLI

Pour créer un attachement de VPC

L'create-vpc-attachmentexemple suivant crée une attache VPC IPv6 prise en charge par un réseau central.

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

Sortie :

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

Pour plus d’informations, consultez Create an attachment dans le Guide de l’utilisateur Cloud WAN.

  • Pour plus de détails sur l'API, reportez-vous CreateVpcAttachmentà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-attachment.

AWS CLI

Pour supprimer un attachement

L’exemple delete-attachment suivant supprime un attachement Connect.

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

Sortie :

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

Pour plus d’informations, consultez Delete attachments dans le Guide de l’utilisateur Cloud WAN.

  • Pour plus de détails sur l'API, reportez-vous DeleteAttachmentà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-bucket-analytics-configuration.

AWS CLI

Pour supprimer une configuration d’analyse d’un compartiment

L’exemple delete-bucket-analytics-configuration suivant supprime la configuration d’analytique pour le compartiment et l’ID spécifiés.

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

Cette commande ne produit aucune sortie.

L'exemple de code suivant montre comment utiliserdelete-bucket-metrics-configuration.

AWS CLI

Pour supprimer une configuration des métriques d’un compartiment

L’exemple delete-bucket-metrics-configuration suivant supprime la configuration des métriques pour le compartiment et l’ID spécifiés.

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

Cette commande ne produit aucune sortie.

L'exemple de code suivant montre comment utiliserdelete-core-network.

AWS CLI

Pour supprimer un réseau principal

L’exemple delete-core-network suivant supprime un réseau principal d’un réseau mondial Cloud WAN.

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

Sortie :

{
    "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": []
            }
        ]
    }
}

Pour plus d’informations, consultez Core networks dans le Guide de l’utilisateur Cloud WAN.

  • Pour plus de détails sur l'API, reportez-vous DeleteCoreNetworkà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-device.

AWS CLI

Pour supprimer un appareil

L’exemple delete-device suivant supprime l’appareil spécifié du réseau mondial spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Gestion des appareils dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous DeleteDeviceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-global-network.

AWS CLI

Pour supprimer un réseau mondial

L’exemple delete-global-network suivant supprime un réseau mondial.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous DeleteGlobalNetworkà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-link.

AWS CLI

Pour supprimer un lien

L’exemple delete-link suivant supprime le lien spécifié du réseau mondial spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Utilisation des liens dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous DeleteLinkà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-public-access-block.

AWS CLI

Pour supprimer la configuration du blocage de l’accès public d’un compartiment

L’exemple delete-public-access-block suivant supprime la configuration du blocage de l’accès public du compartiment spécifié.

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

Cette commande ne produit aucune sortie.

  • Pour plus de détails sur l'API, reportez-vous DeletePublicAccessBlockà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-site.

AWS CLI

Pour supprimer un site

L’exemple delete-site suivant supprime le site spécifié (site-444555aaabbb11223) dans le réseau mondial spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Utilisation des sites dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous DeleteSiteà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserderegister-transit-gateway.

AWS CLI

Pour annuler l’enregistrement d’une passerelle de transit d’un réseau mondial

L’exemple deregister-transit-gateway suivant annule l’enregistrement de la passerelle de transit spécifiée du réseau mondial spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Enregistrements de passerelles de transit dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous DeregisterTransitGatewayà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-global-networks.

AWS CLI

Pour décrire vos réseaux mondiaux

L’exemple describe-global-networks suivant décrit l’ensemble des réseaux mondiaux dans votre compte.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous DescribeGlobalNetworksà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdisassociate-customer-gateway.

AWS CLI

Pour dissocier une passerelle client

L’exemple disassociate-customer-gateway suivant dissocie la passerelle client spécifiée (cgw-11223344556677889) du réseau mondial spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Associations de passerelles client dans le Guide de Transit Gateway Network Manager.

L'exemple de code suivant montre comment utiliserdisassociate-link.

AWS CLI

Pour dissocier un lien

L’exemple disassociate-link suivant dissocie le lien spécifié de l’appareil device-07f6fd08867abc123 dans le réseau mondial spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Associations d’appareils et de liens dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous DisassociateLinkà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-bucket-analytics-configuration.

AWS CLI

Pour extraire la configuration d’analyse d’un compartiment possédant un ID spécifique

L’exemple get-bucket-analytics-configuration suivant affiche la configuration d’analytique pour le compartiment et l’ID spécifiés.

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

Sortie :

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

L'exemple de code suivant montre comment utiliserget-bucket-metrics-configuration.

AWS CLI

Pour extraire la configuration des métriques d’un compartiment avec un ID spécifique

L’exemple get-bucket-metrics-configuration suivant affiche la configuration des métriques pour le compartiment et l’ID spécifiés.

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

Sortie :

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

L'exemple de code suivant montre comment utiliserget-customer-gateway-associations.

AWS CLI

Pour obtenir vos associations de passerelle client

L’exemple get-customer-gateway-associations suivant fournit les associations de passerelle client pour le réseau mondial spécifié.

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

Sortie :

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

L'exemple de code suivant montre comment utiliserget-devices.

AWS CLI

Pour obtenir vos appareils

L’exemple get-devices suivant fournit les appareils du réseau mondial spécifié.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous GetDevicesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-link-associations.

AWS CLI

Pour obtenir vos associations de liens

L’exemple get-link-associations suivant fournit les associations de liens dans le réseau mondial spécifié.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous GetLinkAssociationsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-links.

AWS CLI

Pour obtenir vos liens

L’exemple get-links suivant fournit les liens du réseau mondial spécifié.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous GetLinksà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-object-retention.

AWS CLI

Pour extraire la configuration de rétention d’un objet

L’exemple get-object-retention suivant extrait la configuration de rétention de l’objet spécifié.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous GetObjectRetentionà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-public-access-block.

AWS CLI

Pour définir ou modifier la configuration du blocage de l’accès public d’un compartiment

L’exemple get-public-access-block suivant affiche la configuration du blocage de l’accès public du compartiment spécifié.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous GetPublicAccessBlockà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-sites.

AWS CLI

Pour obtenir vos sites

L’exemple get-sites suivant fournit les sites du réseau mondial spécifié.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous GetSitesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-transit-gateway-registrations.

AWS CLI

Pour obtenir vos enregistrements de passerelle de transit

L’exemple get-transit-gateway-registrations suivant fournit les passerelles de transit enregistrées sur le réseau mondial spécifié.

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

Sortie :

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

L'exemple de code suivant montre comment utiliserget-vpc-attachment.

AWS CLI

Pour obtenir un attachement de VPC

L’exemple get-vpc-attachment suivant renvoie les informations sur un attachement de VPC.

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

Sortie :

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

Pour plus d’informations, consultez Pièces jointes dans le Guide de l’utilisateur Cloud WAN.

  • Pour plus de détails sur l'API, reportez-vous GetVpcAttachmentà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-bucket-analytics-configurations.

AWS CLI

Pour extraire une liste des configurations d’analyse d’un compartiment

L’exemple list-bucket-analytics-configurations suivant extrait la liste des configurations d’analyse du compartiment spécifié.

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

Sortie :

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

L'exemple de code suivant montre comment utiliserlist-bucket-metrics-configurations.

AWS CLI

Pour extraire une liste des configurations des métriques d’un compartiment

L’exemple list-bucket-metrics-configurations suivant extrait une liste des configurations de métriques du compartiment spécifié.

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

Sortie :

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

L'exemple de code suivant montre comment utiliserlist-tags-for-resource.

AWS CLI

Pour répertorier les balises pour une ressource

L’exemple list-tags-for-resource suivant répertorie les balises de la ressource d’appareil spécifiée (device-07f6fd08867abc123).

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserput-bucket-metrics-configuration.

AWS CLI

Pour définir la configuration des métriques d’un compartiment

L’exemple put-bucket-metrics-configuration suivant définit la configuration des métriques avec l’ID 123 pour le compartiment spécifié.

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

Cette commande ne produit aucune sortie.

L'exemple de code suivant montre comment utiliserput-object-retention.

AWS CLI

Pour définir la configuration de rétention d’un objet pour un objet

L’exemple put-object-retention suivant définit la configuration de rétention de l’objet spécifié jusqu’au 01/01/2025.

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

Cette commande ne produit aucune sortie.

  • Pour plus de détails sur l'API, reportez-vous PutObjectRetentionà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserput-public-access-block.

AWS CLI

Pour définir la configuration du blocage de l’accès public d’un compartiment

L’exemple put-public-access-block suivant définit une configuration de blocage restrictif de l’accès public pour le compartiment spécifié.

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

Cette commande ne produit aucune sortie.

  • Pour plus de détails sur l'API, reportez-vous PutPublicAccessBlockà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserregister-transit-gateway.

AWS CLI

Pour enregistrer une passerelle de transit avec un réseau mondial

L’exemple register-transit-gateway suivant enregistre une passerelle de transit tgw-123abc05e04123abc dans le réseau mondial spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Enregistrements de passerelles de transit dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous RegisterTransitGatewayà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserreject-attachment.

AWS CLI

Pour rejeter un attachement

L’exemple reject-attachment suivant rejette une demande d’attachement de VPC.

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

Sortie :

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

Pour plus d’informations, consultez Attachment acceptance dans le Guide de l’utilisateur Cloud WAN.

  • Pour plus de détails sur l'API, reportez-vous RejectAttachmentà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstart-route-analysis.

AWS CLI

Pour démarrer l’analyse de la route

L’exemple start-route-analysis suivant démarre l’analyse entre une source et une destination, y compris l’option 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

Sortie :

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

Pour plus d’informations, consultez Route Analyzer dans le Guide de l’utilisateur AWS  Global Networks for Transit Gateways.

  • Pour plus de détails sur l'API, reportez-vous StartRouteAnalysisà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertag-resource.

AWS CLI

Pour appliquer des balises à une ressource

L’exemple tag-resource suivant applique la balise Network=Northeast à l’appareil device-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

Cette commande ne produit aucune sortie.

  • Pour plus de détails sur l'API, reportez-vous TagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

Pour supprimer des balises d’une ressource

L’exemple untag-resource suivant supprime la balise avec la clé Network de l’appareil device-07f6fd08867abc123.

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

Cette commande ne produit aucune sortie.

  • Pour plus de détails sur l'API, reportez-vous UntagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-device.

AWS CLI

Pour mettre à jour un appareil

L’exemple update-device suivant met à jour l’appareil device-07f6fd08867abc123 en spécifiant un ID de site pour l’appareil.

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

Sortie :

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

Pour plus d’informations, consultez Gestion des appareils dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous UpdateDeviceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-global-network.

AWS CLI

Pour mettre à jour un réseau mondial

L’exemple update-global-network suivant met à jour la description du réseau mondial global-network-01231231231231231.

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

Sortie :

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

Pour plus d’informations, consultez Réseaux mondiaux dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous UpdateGlobalNetworkà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-link.

AWS CLI

Pour mettre à jour un lien

L’exemple update-link suivant met à jour les informations relatives à la bande passante pour le lien link-11112222aaaabbbb1.

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

Sortie :

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

Pour plus d’informations, consultez Utilisation des liens dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous UpdateLinkà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-site.

AWS CLI

Pour mettre à jour un site

L’exemple update-site suivant met à jour la description du site site-444555aaabbb11223 dans le réseau mondial spécifié.

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

Sortie :

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

Pour plus d’informations, consultez Utilisation des sites dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous UpdateSiteà la section Référence des AWS CLI commandes.