Exemples d’utilisation de l’AWS CLI avec Network Manager - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec Network Manager

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec 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 utiliser associate-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.

  • Pour plus de détails sur l’API, consultez AssociateCustomerGateway dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser associate-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, consultez AssociateLink dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-core-network.

AWS CLI

Pour créer un réseau principal

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

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, consultez CreateCoreNetwork dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-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, consultez CreateDevice dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-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, consultez CreateGlobalNetwork dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-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 Gestion des liens dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l’API, consultez CreateLink dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-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, consultez CreateSite dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-vpc-attachment.

AWS CLI

Pour créer un attachement de VPC

L’exemple create-vpc-attachment suivant crée un attachement de VPC compatible avec IPv6 dans un réseau principal.

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, consultez CreateVpcAttachment dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-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, consultez DeleteAttachment dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-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’analyse 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 utiliser delete-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 utiliser delete-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, consultez DeleteCoreNetwork dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-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, consultez DeleteDevice dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-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, consultez DeleteGlobalNetwork dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-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 Gestion des liens dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l’API, consultez DeleteLink dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-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, consultez DeletePublicAccessBlock dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-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, consultez DeleteSite dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser deregister-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, consultez DeregisterTransitGateway dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-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, consultez DescribeGlobalNetworks dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser disassociate-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 utiliser disassociate-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, consultez DisassociateLink dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-bucket-analytics-configuration.

AWS CLI

Pour récupérer la configuration d’analyse d’un compartiment possédant un ID spécifique

L’exemple get-bucket-analytics-configuration suivant affiche la configuration d’analyse 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 utiliser get-bucket-metrics-configuration.

AWS CLI

Pour récupérer la configuration des métriques d’un compartiment possédant 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 utiliser get-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 utiliser get-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, consultez GetDevices dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-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, consultez GetLinkAssociations dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-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, consultez GetLinks dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-object-retention.

AWS CLI

Pour récupérer la configuration de rétention d’un objet

L’exemple get-object-retention suivant récupère 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, consultez GetObjectRetention dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-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, consultez GetPublicAccessBlock dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-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, consultez GetSites dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-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 utiliser get-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, consultez GetVpcAttachment dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-bucket-analytics-configurations.

AWS CLI

Pour récupérer la liste des configurations d’analyse d’un compartiment

L’exemple list-bucket-analytics-configurations suivant récupère 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 utiliser list-bucket-metrics-configurations.

AWS CLI

Pour récupérer la liste des configurations de métriques d’un compartiment

L’exemple list-bucket-metrics-configurations suivant récupère la 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 utiliser list-tags-for-resource.

AWS CLI

Pour répertorier les balises d’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, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser put-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 utiliser put-object-retention.

AWS CLI

Pour définir la configuration de rétention d’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, consultez PutObjectRetention dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser put-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 la configuration du 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, consultez PutPublicAccessBlock dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser register-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, consultez RegisterTransitGateway dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser reject-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, consultez RejectAttachment dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser start-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, consultez StartRouteAnalysis dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser tag-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, consultez TagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser untag-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, consultez UntagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-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, consultez UpdateDevice dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-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, consultez UpdateGlobalNetwork dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-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 Gestion des liens dans le Guide de Transit Gateway Network Manager.

  • Pour plus de détails sur l’API, consultez UpdateLink dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-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, consultez UpdateSite dans la Référence des commandes de l’AWS CLI.