D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples
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-gateway
exemple suivant associe la passerelle client au périphériquecgw-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-idglobal-network-01231231231231231
\ --device-iddevice-07f6fd08867abc123
\ --regionus-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-link
exemple suivant associe un lienlink-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-iddevice-07f6fd08867abc123
\ --link-idlink-11112222aaaabbbb1
\ --regionus-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-network
exemple 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-device
exemple 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"
\ --regionus-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-link
exemple 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"
\ --bandwidthUploadSpeed=10,DownloadSpeed=20
\ --provider"AnyCompany"
\ --site-idsite-444555aaabbb11223
\ --regionus-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-site
exemple 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"
\ --locationLatitude=40.7128,Longitude=-74.0060
\ --regionus-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-attachment
exemple 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-arnarn:aws:ec2:us-east-1:987654321012:vpc/vpc-09f37f69e2786eeb8
\ --subnet-arnsarn:aws:ec2:us-east-1:987654321012:subnet/subnet-04ca4e010857e7bb7
\ --Ipv6Support=trueSortie :
{ "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, reportez-vous CreateVpcAttachment
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-attachment
.
- AWS CLI
-
Pour supprimer une pièce jointe
L'
delete-attachment
exemple 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, reportez-vous DeleteAttachment
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-bucket-analytics-configuration
.
- AWS CLI
-
Pour supprimer une configuration d'analyse pour un bucket
L'
delete-bucket-analytics-configuration
exemple 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
\ --id1
Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, reportez-vous DeleteBucketAnalyticsConfiguration
à la section Référence des AWS CLI commandes.
-
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-configuration
exemple 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
\ --id123
Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, reportez-vous DeleteBucketMetricsConfiguration
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-core-network
.
- AWS CLI
-
Pour supprimer un réseau principal
L'
delete-core-network
exemple 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, reportez-vous DeleteCoreNetwork
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-device
.
- AWS CLI
-
Pour supprimer un appareil
L'
delete-device
exemple 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-iddevice-07f6fd08867abc123
\ --regionus-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, reportez-vous DeleteDevice
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-global-network
.
- AWS CLI
-
Pour supprimer un réseau mondial
L'
delete-global-network
exemple suivant supprime un réseau mondial.aws networkmanager delete-global-network \ --global-network-id
global-network-052bedddccb193b6b
Sortie :
{ "GlobalNetwork": { "GlobalNetworkId": "global-network-052bedddccb193b6b", "GlobalNetworkArn": "arn:aws:networkmanager::987654321012:global-network/global-network-052bedddccb193b6b", "CreatedAt": "2021-12-09T18:19:12+00:00", "State": "DELETING" } }
-
Pour plus de détails sur l'API, reportez-vous DeleteGlobalNetwork
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-link
.
- AWS CLI
-
Pour supprimer un lien
L'
delete-link
exemple suivant supprime le lien spécifié du réseau mondial spécifié.aws networkmanager delete-link \ --global-network-id
global-network-01231231231231231
\ --link-idlink-11112222aaaabbbb1
\ --regionus-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, reportez-vous DeleteLink
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-public-access-block
.
- AWS CLI
-
Pour supprimer la configuration de blocage de l'accès public pour un bucket
L'
delete-public-access-block
exemple 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.
-
Pour plus de détails sur l'API, reportez-vous DeletePublicAccessBlock
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-site
.
- AWS CLI
-
Pour supprimer un site
L'
delete-site
exemple 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-idsite-444555aaabbb11223
\ --regionus-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, reportez-vous DeleteSite
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserderegister-transit-gateway
.
- AWS CLI
-
Pour désenregistrer une passerelle de transit d'un réseau mondial
L'
deregister-transit-gateway
exemple 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-arnarn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc
\ --regionus-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.
-
Pour plus de détails sur l'API, reportez-vous DeregisterTransitGateway
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-global-networks
.
- AWS CLI
-
Pour décrire vos réseaux mondiaux
L'
describe-global-networks
exemple 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" } ] }
-
Pour plus de détails sur l'API, reportez-vous DescribeGlobalNetworks
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdisassociate-customer-gateway
.
- AWS CLI
-
Pour dissocier une passerelle client
L'
disassociate-customer-gateway
exemple 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-arnarn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889
\ --regionus-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.
-
Pour plus de détails sur l'API, reportez-vous DisassociateCustomerGateway
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdisassociate-link
.
- AWS CLI
-
Pour dissocier un lien
L'
disassociate-link
exemple suivant dissocie le lien spécifié du périphériquedevice-07f6fd08867abc123
du réseau mondial spécifié.aws networkmanager disassociate-link \ --global-network-id
global-network-01231231231231231
\ --device-iddevice-07f6fd08867abc123
\ --link-idlink-11112222aaaabbbb1
\ --regionus-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, reportez-vous DisassociateLink
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-bucket-analytics-configuration
.
- AWS CLI
-
Pour récupérer la configuration d'analyse d'un bucket avec un ID spécifique
L'
get-bucket-analytics-configuration
exemple 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
\ --id1
Sortie :
{ "AnalyticsConfiguration": { "StorageClassAnalysis": {}, "Id": "1" } }
-
Pour plus de détails sur l'API, reportez-vous GetBucketAnalyticsConfiguration
à la section Référence des AWS CLI commandes.
-
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-configuration
exemple 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
\ --id123
Sortie :
{ "MetricsConfiguration": { "Filter": { "Prefix": "logs" }, "Id": "123" } }
-
Pour plus de détails sur l'API, reportez-vous GetBucketMetricsConfiguration
à la section Référence des AWS CLI commandes.
-
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-associations
exemple 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
\ --regionus-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" } ] }
-
Pour plus de détails sur l'API, reportez-vous GetCustomerGatewayAssociations
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-devices
.
- AWS CLI
-
Pour obtenir vos appareils
L'
get-devices
exemple suivant permet d'obtenir les appareils du réseau mondial spécifié.aws networkmanager get-devices \ --global-network-id
global-network-01231231231231231
\ --regionus-west-2
Sortie :
{ "Devices": [ { "DeviceId": "device-07f6fd08867abc123", "DeviceArn": "arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123", "GlobalNetworkId": "global-network-01231231231231231", "Description": "NY office device", "Type": "office device", "Vendor": "anycompany", "Model": "abcabc", "SerialNumber": "1234", "CreatedAt": 1575554005.0, "State": "AVAILABLE" } ] }
-
Pour plus de détails sur l'API, reportez-vous GetDevices
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-link-associations
.
- AWS CLI
-
Pour obtenir vos associations de liens
L'
get-link-associations
exemple suivant permet d'obtenir les associations de liens dans le réseau mondial spécifié.aws networkmanager get-link-associations \ --global-network-id
global-network-01231231231231231
\ --regionus-west-2
Sortie :
{ "LinkAssociations": [ { "GlobalNetworkId": "global-network-01231231231231231", "DeviceId": "device-07f6fd08867abc123", "LinkId": "link-11112222aaaabbbb1", "LinkAssociationState": "AVAILABLE" } ] }
-
Pour plus de détails sur l'API, reportez-vous GetLinkAssociations
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-links
.
- AWS CLI
-
Pour obtenir vos liens
L'
get-links
exemple suivant permet d'obtenir les liens du réseau mondial spécifié.aws networkmanager get-links \ --global-network-id
global-network-01231231231231231
\ --regionus-west-2
Sortie :
{ "Links": [ { "LinkId": "link-11112222aaaabbbb1", "LinkArn": "arn:aws:networkmanager::123456789012:link/global-network-01231231231231231/link-11112222aaaabbbb1", "GlobalNetworkId": "global-network-01231231231231231", "SiteId": "site-444555aaabbb11223", "Description": "VPN Link", "Type": "broadband", "Bandwidth": { "UploadSpeed": 10, "DownloadSpeed": 20 }, "Provider": "AnyCompany", "CreatedAt": 1575555811.0, "State": "AVAILABLE" } ] }
-
Pour plus de détails sur l'API, reportez-vous GetLinks
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-object-retention
.
- AWS CLI
-
Pour récupérer la configuration de rétention d'un objet
L'
get-object-retention
exemple 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
\ --keydoc1.rtf
Sortie :
{ "Retention": { "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00.000Z" } }
-
Pour plus de détails sur l'API, reportez-vous GetObjectRetention
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-public-access-block
.
- AWS CLI
-
Pour définir ou modifier la configuration de blocage de l'accès public pour un bucket
L'
get-public-access-block
exemple 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, reportez-vous GetPublicAccessBlock
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-sites
.
- AWS CLI
-
Pour obtenir vos sites
L'
get-sites
exemple suivant permet d'obtenir les sites du réseau mondial spécifié.aws networkmanager get-sites \ --global-network-id
global-network-01231231231231231
\ --regionus-west-2
Sortie :
{ "Sites": [ { "SiteId": "site-444555aaabbb11223", "SiteArn": "arn:aws:networkmanager::123456789012:site/global-network-01231231231231231/site-444555aaabbb11223", "GlobalNetworkId": "global-network-01231231231231231", "Description": "NY head office", "Location": { "Latitude": "40.7128", "Longitude": "-74.0060" }, "CreatedAt": 1575554528.0, "State": "AVAILABLE" } ] }
-
Pour plus de détails sur l'API, reportez-vous GetSites
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-transit-gateway-registrations
.
- AWS CLI
-
Pour obtenir les inscriptions à votre passerelle de transit
L'
get-transit-gateway-registrations
exemple 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
\ --regionus-west-2
Sortie :
{ "TransitGatewayRegistrations": [ { "GlobalNetworkId": "global-network-01231231231231231", "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc", "State": { "Code": "AVAILABLE" } } ] }
-
Pour plus de détails sur l'API, reportez-vous GetTransitGatewayRegistrations
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-vpc-attachment
.
- AWS CLI
-
Pour obtenir une pièce jointe à un VPC
L'
get-vpc-attachment
exemple 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, reportez-vous GetVpcAttachment
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-bucket-analytics-configurations
.
- AWS CLI
-
Pour 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 }
-
Pour plus de détails sur l'API, reportez-vous ListBucketAnalyticsConfigurations
à la section Référence des AWS CLI commandes.
-
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-configurations
exemple 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" } ] }
-
Pour plus de détails sur l'API, reportez-vous ListBucketMetricsConfigurations
à la section Référence des AWS CLI commandes.
-
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-resource
exemple 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
\ --regionus-west-2
Sortie :
{ "TagList": [ { "Key": "Network", "Value": "Northeast" } ] }
-
Pour plus de détails sur l'API, reportez-vous ListTagsForResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserput-bucket-metrics-configuration
.
- AWS CLI
-
Pour définir une configuration de métriques pour un bucket
L'
put-bucket-metrics-configuration
exemple 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
\ --id123
\ --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}
'Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, reportez-vous PutBucketMetricsConfiguration
à la section Référence des AWS CLI commandes.
-
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-retention
exemple 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
\ --keydoc1.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, reportez-vous PutObjectRetention
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserput-public-access-block
.
- AWS CLI
-
Pour définir la configuration de blocage de l'accès public pour un bucket
L'
put-public-access-block
exemple 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, reportez-vous PutPublicAccessBlock
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserregister-transit-gateway
.
- AWS CLI
-
Pour enregistrer une passerelle de transit dans un réseau mondial
L'
register-transit-gateway
exemple suivant enregistre une passerelle de transittgw-123abc05e04123abc
dans le réseau mondial spécifié.aws networkmanager register-transit-gateway \ --global-network-id
global-network-01231231231231231
\ --transit-gateway-arnarn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc
\ --regionus-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.
-
Pour plus de détails sur l'API, reportez-vous RegisterTransitGateway
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserreject-attachment
.
- AWS CLI
-
Pour rejeter une pièce jointe
L'
reject-attachment
exemple 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, reportez-vous RejectAttachment
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserstart-route-analysis
.
- AWS CLI
-
Pour démarrer l'analyse des itinéraires
L'
start-route-analysis
exemple 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
\ --sourceTransitGatewayAttachmentArn=arn:aws:ec2:us-east-1:503089527312:transit-gateway-attachment/tgw-attach-0d4a2d491bf68c093,IpAddress=10.0.0.0
\ --destinationTransitGatewayAttachmentArn=arn:aws:ec2:us-west-1:503089527312:transit-gateway-attachment/tgw-attach-002577f30bb181742,IpAddress=11.0.0.0
\ --include-return-pathSortie :
{ "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, reportez-vous StartRouteAnalysis
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisertag-resource
.
- AWS CLI
-
Pour appliquer des balises à une ressource
L'
tag-resource
exemple suivant applique la baliseNetwork=Northeast
à l'appareildevice-07f6fd08867abc123
.aws networkmanager tag-resource \ --resource-arn
arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123
\ --tagsKey=Network,Value=Northeast
\ --regionus-west-2
Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, reportez-vous TagResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliseruntag-resource
.
- AWS CLI
-
Pour supprimer des balises d'une ressource
L'
untag-resource
exemple 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-keysNetwork
\ --regionus-west-2
Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, reportez-vous UntagResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-device
.
- AWS CLI
-
Pour mettre à jour un appareil
L'
update-device
exemple suivant met à jour l'appareildevice-07f6fd08867abc123
en spécifiant un ID de site pour l'appareil.aws networkmanager update-device \ --global-network-id
global-network-01231231231231231
\ --device-iddevice-07f6fd08867abc123
\ --site-idsite-444555aaabbb11223
\ --regionus-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, reportez-vous UpdateDevice
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-global-network
.
- AWS CLI
-
Pour mettre à jour un réseau mondial
L'
update-global-network
exemple 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"
\ --regionus-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, reportez-vous UpdateGlobalNetwork
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-link
.
- AWS CLI
-
Pour mettre à jour un lien
L'
update-link
exemple suivant met à jour les informations de bande passante pour le lienlink-11112222aaaabbbb1
.aws networkmanager update-link \ --global-network-id
global-network-01231231231231231
\ --link-idlink-11112222aaaabbbb1
\ --bandwidthUploadSpeed=20,DownloadSpeed=20
\ --regionus-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, reportez-vous UpdateLink
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-site
.
- AWS CLI
-
Pour mettre à jour un site
L'
update-site
exemple suivant met à jour la description du sitesite-444555aaabbb11223
dans le réseau mondial spécifié.aws networkmanager update-site \ --global-network-id
global-network-01231231231231231
\ --site-idsite-444555aaabbb11223
\ --description"New York Office site"
\ --regionus-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, reportez-vous UpdateSite
à la section Référence des AWS CLI commandes.
-