Exemples d'utilisation de Network Manager AWS CLI - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

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 d'utilisation de Network Manager 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 façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

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

AWS CLI

Pour associer une passerelle client

L'associate-customer-gatewayexemple suivant associe la passerelle client au périphérique cgw-11223344556677889 dans le réseau mondial spécifié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 la section Customer Gateway Associations dans le guide Transit Gateway Network Manager.

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

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

AWS CLI

Pour associer un lien

L'associate-linkexemple suivant associe un lien link-11112222aaaabbbb1 à un appareildevice-07f6fd08867abc123. Le lien et le périphérique 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 la section Associations de périphériques et de liens dans le guide du Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous AssociateLinkà la 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 central

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 la section Réseaux mondiaux et principaux dans le Guide de l'utilisateur du AWS Cloud WAN.

  • Pour plus de détails sur l'API, reportez-vous CreateCoreNetworkà la 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'create-deviceexemple suivant crée un appareil dans le 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, voir Working with Devices dans le guide du Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous CreateDeviceà la 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

Les create-global-network exemples suivants créent un nouveau réseau mondial. L'état initial lors de la création estPENDING.

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, reportez-vous CreateGlobalNetworkà la 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'create-linkexemple 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, voir Working with Links dans le guide du Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, reportez-vous CreateLinkà la 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'create-siteexemple 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, voir Working with Sites dans le guide du Transit Gateway Network Manager.

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

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

AWS CLI

Pour créer une pièce jointe 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 la section Créer une pièce jointe dans le guide de l'utilisateur de Cloud WAN.

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

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

AWS CLI

Pour supprimer une pièce jointe

L'delete-attachmentexemple suivant supprime une pièce jointe 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 la section Supprimer les pièces jointes dans le guide de l'utilisateur de Cloud WAN.

  • Pour plus de détails sur l'API, voir DeleteAttachmentla 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 pour un bucket

L'delete-bucket-analytics-configurationexemple suivant supprime la configuration d'analyse pour le bucket et l'ID spécifiés.

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

Cette commande ne produit aucun résultat.

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

AWS CLI

Pour supprimer la configuration des métriques d'un bucket

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

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

Cette commande ne produit aucun résultat.

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

AWS CLI

Pour supprimer un réseau principal

L'delete-core-networkexemple suivant supprime un réseau central 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 la section Réseaux principaux du Guide de l'utilisateur du Cloud WAN.

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

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

AWS CLI

Pour supprimer un appareil

L'delete-deviceexemple suivant supprime le périphérique 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, voir Working with Devices dans le guide du Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, voir DeleteDevicela 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'delete-global-networkexemple 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, voir DeleteGlobalNetworkla section Référence des AWS CLI commandes.

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

AWS CLI

Pour supprimer un lien

L'delete-linkexemple 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, voir Working with Links dans le guide du Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, voir DeleteLinkla 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 de blocage de l'accès public pour un bucket

L'delete-public-access-blockexemple suivant supprime la configuration de blocage de l'accès public sur le compartiment spécifié.

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

Cette commande ne produit aucun résultat.

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

AWS CLI

Pour supprimer un site

L'delete-siteexemple 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, voir Working with Sites dans le guide du Transit Gateway Network Manager.

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

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

AWS CLI

Pour désenregistrer une passerelle de transit d'un réseau mondial

L'deregister-transit-gatewayexemple suivant désenregistre 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 la section sur les inscriptions à Transit Gateway dans le guide du gestionnaire du réseau Transit Gateway.

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

AWS CLI

Pour décrire vos réseaux mondiaux

L'describe-global-networksexemple suivant décrit tous les réseaux mondiaux de 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"
        }
    ]
}

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

AWS CLI

Pour dissocier une passerelle client

L'disassociate-customer-gatewayexemple 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 la section Customer Gateway Associations dans le guide Transit Gateway Network Manager.

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

AWS CLI

Pour dissocier un lien

L'disassociate-linkexemple suivant dissocie le lien spécifié du périphérique device-07f6fd08867abc123 du 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 la section Associations de périphériques et de liens dans le guide du Transit Gateway Network Manager.

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

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

AWS CLI

Pour récupérer la configuration d'analyse d'un bucket avec un ID spécifique

L'get-bucket-analytics-configurationexemple suivant affiche la configuration d'analyse pour le bucket 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 récupérer la configuration des métriques d'un bucket avec un ID spécifique

L'get-bucket-metrics-configurationexemple suivant affiche la configuration des métriques pour le bucket 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 créer des associations avec votre passerelle client

L'get-customer-gateway-associationsexemple suivant obtient 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'get-devicesexemple suivant permet d'obtenir 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, voir GetDevicesla 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'get-link-associationsexemple suivant obtient 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, voir GetLinkAssociationsla section Référence des AWS CLI commandes.

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

AWS CLI

Pour obtenir vos liens

L'get-linksexemple suivant permet d'obtenir 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, voir GetLinksla section Référence des AWS CLI commandes.

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

AWS CLI

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

L'get-object-retentionexemple suivant récupère la configuration de rétention d'objets pour 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, voir GetObjectRetentionla 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 de blocage de l'accès public pour un bucket

L'get-public-access-blockexemple suivant montre la configuration de blocage de l'accès public pour le 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, voir GetPublicAccessBlockla section Référence des AWS CLI commandes.

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

AWS CLI

Pour obtenir vos sites

L'get-sitesexemple suivant permet d'obtenir 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, voir GetSitesla section Référence des AWS CLI commandes.

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

AWS CLI

Pour obtenir les inscriptions à votre passerelle de transit

L'get-transit-gateway-registrationsexemple suivant obtient 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 une pièce jointe à un VPC

L'get-vpc-attachmentexemple suivant renvoie des informations sur un attachement 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 la section Pièces jointes du Guide de l'utilisateur du Cloud WAN.

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

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

AWS CLI

Pour récupérer la liste des configurations d'analyse pour un bucket

Ce qui suit list-bucket-analytics-configurations permet de récupérer la liste des configurations d'analyse pour le 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 récupérer la liste des configurations de métriques pour un bucket

L'list-bucket-metrics-configurationsexemple suivant extrait une liste de configurations de métriques pour le 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 d'une ressource

L'list-tags-for-resourceexemple suivant répertorie les balises pour la ressource de périphérique 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, voir ListTagsForResourcela section Référence des AWS CLI commandes.

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

AWS CLI

Pour définir une configuration de métriques pour un bucket

L'put-bucket-metrics-configurationexemple suivant définit une configuration métrique 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 aucun résultat.

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

AWS CLI

Pour définir une configuration de rétention d'objets pour un objet

L'put-object-retentionexemple suivant définit une configuration de rétention d'objet pour 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 aucun résultat.

  • Pour plus de détails sur l'API, voir PutObjectRetentionla 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 de blocage de l'accès public pour un bucket

L'put-public-access-blockexemple suivant définit une configuration d'accès public par blocs restrictifs 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 aucun résultat.

  • Pour plus de détails sur l'API, voir PutPublicAccessBlockla 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 dans un réseau mondial

L'register-transit-gatewayexemple 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 la section sur les inscriptions à Transit Gateway dans le guide du gestionnaire du réseau Transit Gateway.

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

AWS CLI

Pour rejeter une pièce jointe

L'reject-attachmentexemple suivant rejette une demande d'attachement 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 la section Acceptation des pièces jointes dans le guide de l'utilisateur du Cloud WAN.

  • Pour plus de détails sur l'API, voir RejectAttachmentla 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 des itinéraires

L'start-route-analysisexemple suivant démarre l'analyse entre une source et une destination, y compris l'option facultativeinclude-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 de AWS Global Networks for Transit Gateways.

  • Pour plus de détails sur l'API, voir StartRouteAnalysisla 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'tag-resourceexemple suivant applique la balise Network=Northeast à l'appareildevice-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 aucun résultat.

  • Pour plus de détails sur l'API, voir TagResourcela 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'untag-resourceexemple suivant supprime la balise contenant la clé Network de l'appareildevice-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 aucun résultat.

  • Pour plus de détails sur l'API, voir UntagResourcela 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'update-deviceexemple 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, voir Working with Devices dans le guide du Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, voir UpdateDevicela 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'update-global-networkexemple suivant met à jour la description du réseau mondialglobal-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 Global Networks dans le guide du gestionnaire de réseau Transit Gateway.

  • Pour plus de détails sur l'API, voir UpdateGlobalNetworkla 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'update-linkexemple suivant met à jour les informations de bande passante pour le lienlink-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, voir Working with Links dans le guide du Transit Gateway Network Manager.

  • Pour plus de détails sur l'API, voir UpdateLinkla 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'update-siteexemple 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, voir Working with Sites dans le guide du Transit Gateway Network Manager.

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