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

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 montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur 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 du Transit Gateway Network Manager.

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 API plus de détails, 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 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 WAN mondial AWS Cloud.

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 WAN l'utilisateur du AWS cloud.

  • Pour API plus de détails, 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'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, consultez la section Working with Devices dans le guide du Transit Gateway Network Manager.

  • Pour API plus de détails, 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

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 API plus de détails, 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'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 API plus de détails, 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'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 API plus de détails, 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 une VPC pièce jointe

L'create-vpc-attachmentexemple suivant crée une VPC pièce jointe avec IPv6 support dans 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éation d'une pièce jointe dans le guide de WAN l'utilisateur du cloud.

  • Pour API plus de détails, 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 WAN l'utilisateur du cloud.

  • Pour API plus de détails, 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 my-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 my-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 WAN mondial Cloud.

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 dans le Guide de WAN l'utilisateur du cloud.

  • Pour API plus de détails, 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, consultez la section Working with Devices dans le guide du Transit Gateway Network Manager.

  • Pour API plus de détails, 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 API plus de détails, 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 API plus de détails, 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 my-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 API plus de détails, 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 du 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 API plus de détails, 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 my-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 my-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 API plus de détails, 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 API plus de détails, 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 API plus de détails, 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 my-bucket-with-object-lock \ --key doc1.rtf

Sortie :

{ "Retention": { "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00.000Z" } }
  • Pour API plus de détails, 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 my-bucket

Sortie :

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

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 API plus de détails, 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 VPC pièce jointe

L'get-vpc-attachmentexemple suivant renvoie des informations sur une VPC pièce jointe.

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 WAN l'utilisateur du cloud.

  • Pour API plus de détails, 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 my-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 my-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 API plus de détails, 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 my-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 my-bucket-with-object-lock \ --key doc1.rtf \ --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'

Cette commande ne produit aucun résultat.

  • Pour API plus de détails, 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 my-bucket \ --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"

Cette commande ne produit aucun résultat.

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 de VPC pièce jointe.

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 WAN l'utilisateur du cloud.

  • Pour API plus de détails, 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 API plus de détails, 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 API plus de détails, 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 API plus de détails, 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, consultez la section Working with Devices dans le guide du Transit Gateway Network Manager.

  • Pour API plus de détails, 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 API plus de détails, 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 API plus de détails, 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 API plus de détails, voir UpdateSitela section Référence des AWS CLI commandes.