Esempi di Network Manager che utilizzano AWS CLI - AWS Command Line Interface

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di Network Manager che utilizzano AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with Network Manager.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareassociate-customer-gateway.

AWS CLI

Per associare un gateway per i clienti

L'associate-customer-gatewayesempio seguente associa il gateway del cliente cgw-11223344556677889 nella rete globale specificata al dispositivodevice-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

Output:

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

Per ulteriori informazioni, consulta Customer Gateway Associations nella Transit Gateway Network Manager Guide.

Il seguente esempio di codice mostra come utilizzareassociate-link.

AWS CLI

Per associare un collegamento

L'associate-linkesempio seguente associa il link link-11112222aaaabbbb1 al dispositivodevice-07f6fd08867abc123. Il collegamento e il dispositivo si trovano nella rete globale specificata.

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

Output:

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

Per ulteriori informazioni, vedere Device and Link Associations nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere AssociateLinkin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-core-network.

AWS CLI

Per creare una rete centrale

L'create-core-networkesempio seguente crea una rete principale utilizzando una descrizione e tag opzionali all'interno di una rete WAN globale 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"

Output:

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

Per ulteriori informazioni, consulta Global and core networks nella AWS Cloud WAN User Guide.

Il seguente esempio di codice mostra come utilizzarecreate-device.

AWS CLI

Per creare un dispositivo

L'create-deviceesempio seguente crea un dispositivo nella rete globale specificata. I dettagli del dispositivo includono una descrizione, il tipo, il fornitore, il modello e il numero di serie.

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

Output:

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

Per ulteriori informazioni, vedere Working with Devices nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere CreateDevicein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-global-network.

AWS CLI

Per creare una rete globale

create-global-networkGli esempi seguenti creano una nuova rete globale. Lo stato iniziale al momento della creazione èPENDING.

aws networkmanager create-global-network

Output:

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

Il seguente esempio di codice mostra come utilizzarecreate-link.

AWS CLI

Per creare un collegamento

L'create-linkesempio seguente crea un collegamento nella rete globale specificata. Il collegamento include una descrizione e dettagli sul tipo di collegamento, sulla larghezza di banda e sul provider. L'ID del sito indica il sito a cui è associato il collegamento.

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

Output:

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

Per ulteriori informazioni, vedere Working with Links nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere CreateLinkin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-site.

AWS CLI

Per creare un sito

L'create-siteesempio seguente crea un sito nella rete globale specificata. I dettagli del sito includono una descrizione e informazioni sulla posizione.

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

Output:

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

Per ulteriori informazioni, vedere Working with Sites nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere CreateSitein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-vpc-attachment.

AWS CLI

Per creare un VPC allegato

L'create-vpc-attachmentesempio seguente crea un VPC allegato con IPv6 supporto in una rete principale.

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

Output:

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

Per ulteriori informazioni, consulta Create an attachment in the Cloud WAN User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-attachment.

AWS CLI

Per eliminare un allegato

L'delete-attachmentesempio seguente elimina un allegato Connect.

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

Output:

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

Per ulteriori informazioni, consulta Eliminare gli allegati nella Cloud WAN User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-bucket-analytics-configuration.

AWS CLI

Per eliminare una configurazione di analisi per un bucket

L'delete-bucket-analytics-configurationesempio seguente rimuove la configurazione di analisi per il bucket e l'ID specificati.

aws s3api delete-bucket-analytics-configuration \ --bucket my-bucket \ --id 1

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzaredelete-bucket-metrics-configuration.

AWS CLI

Per eliminare una configurazione di metriche per un bucket

L'delete-bucket-metrics-configurationesempio seguente rimuove la configurazione delle metriche per il bucket e l'ID specificati.

aws s3api delete-bucket-metrics-configuration \ --bucket my-bucket \ --id 123

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzaredelete-core-network.

AWS CLI

Per eliminare una rete centrale

L'delete-core-networkesempio seguente elimina una rete principale da una rete WAN globale Cloud.

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

Output:

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

Per ulteriori informazioni, consulta Core networks in the Cloud WAN User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-device.

AWS CLI

Per eliminare un dispositivo

L'delete-deviceesempio seguente elimina il dispositivo specificato dalla rete globale specificata.

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

Output:

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

Per ulteriori informazioni, vedere Working with Devices nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere DeleteDevicein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-global-network.

AWS CLI

Per eliminare una rete globale

L'delete-global-networkesempio seguente elimina una rete globale.

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

Output:

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

Il seguente esempio di codice mostra come utilizzaredelete-link.

AWS CLI

Per eliminare un collegamento

L'delete-linkesempio seguente elimina il link specificato dalla rete globale specificata.

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

Output:

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

Per ulteriori informazioni, vedere Working with Links nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere DeleteLinkin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-public-access-block.

AWS CLI

Per eliminare la configurazione di blocco dell'accesso pubblico per un bucket

L'delete-public-access-blockesempio seguente rimuove la configurazione di accesso pubblico a blocchi sul bucket specificato.

aws s3api delete-public-access-block \ --bucket my-bucket

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzaredelete-site.

AWS CLI

Per eliminare un sito

L'delete-siteesempio seguente elimina il sito specificato (site-444555aaabbb11223) nella rete globale specificata.

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

Output:

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

Per ulteriori informazioni, vedere Working with Sites nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere DeleteSitein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarederegister-transit-gateway.

AWS CLI

Per annullare la registrazione di un gateway di transito da una rete globale

L'deregister-transit-gatewayesempio seguente annulla la registrazione del gateway di transito specificato dalla rete globale specificata.

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

Output:

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

Per ulteriori informazioni, vedere Transit Gateway Registrations nella Transit Gateway Network Manager Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-global-networks.

AWS CLI

Per descrivere le vostre reti globali

L'describe-global-networksesempio seguente descrive tutte le reti globali presenti nel tuo account.

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

Output:

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

Il seguente esempio di codice mostra come utilizzaredisassociate-customer-gateway.

AWS CLI

Dissociare un Customer Gateway

L'disassociate-customer-gatewayesempio seguente dissocia il customer gateway specificato (cgw-11223344556677889) dalla rete globale specificata.

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

Output:

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

Per ulteriori informazioni, consulta Customer Gateway Associations nella Transit Gateway Network Manager Guide.

Il seguente esempio di codice mostra come utilizzaredisassociate-link.

AWS CLI

Per dissociare un collegamento

L'disassociate-linkesempio seguente dissocia il collegamento specificato dal dispositivo device-07f6fd08867abc123 nella rete globale specificata.

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

Output:

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

Per ulteriori informazioni, vedere Device and Link Associations nella Transit Gateway Network Manager Guide.

Il seguente esempio di codice mostra come utilizzareget-bucket-analytics-configuration.

AWS CLI

Per recuperare la configurazione di analisi per un bucket con un ID specifico

L'get-bucket-analytics-configurationesempio seguente mostra la configurazione di analisi per il bucket e l'ID specificati.

aws s3api get-bucket-analytics-configuration \ --bucket my-bucket \ --id 1

Output:

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

Il seguente esempio di codice mostra come utilizzareget-bucket-metrics-configuration.

AWS CLI

Per recuperare la configurazione delle metriche per un bucket con un ID specifico

L'get-bucket-metrics-configurationesempio seguente visualizza la configurazione delle metriche per il bucket e l'ID specificati.

aws s3api get-bucket-metrics-configuration \ --bucket my-bucket \ --id 123

Output:

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

Il seguente esempio di codice mostra come utilizzareget-customer-gateway-associations.

AWS CLI

Per ottenere le associazioni dei vostri customer gateway

L'get-customer-gateway-associationsesempio seguente ottiene le associazioni dei gateway dei clienti per la rete globale specificata.

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

Output:

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

Il seguente esempio di codice mostra come utilizzareget-devices.

AWS CLI

Per procurarti i tuoi dispositivi

L'get-devicesesempio seguente ottiene i dispositivi nella rete globale specificata.

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

Output:

{ "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" } ] }
  • Per API i dettagli, vedere GetDevicesin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-link-associations.

AWS CLI

Per ottenere le associazioni dei link

L'get-link-associationsesempio seguente ottiene le associazioni di link nella rete globale specificata.

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

Output:

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

Il seguente esempio di codice mostra come utilizzareget-links.

AWS CLI

Per ottenere i tuoi link

L'get-linksesempio seguente ottiene i collegamenti nella rete globale specificata.

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

Output:

{ "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" } ] }
  • Per API i dettagli, vedere GetLinksin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-object-retention.

AWS CLI

Per recuperare la configurazione di conservazione degli oggetti per un oggetto

L'get-object-retentionesempio seguente recupera la configurazione di conservazione degli oggetti per l'oggetto specificato.

aws s3api get-object-retention \ --bucket my-bucket-with-object-lock \ --key doc1.rtf

Output:

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

Il seguente esempio di codice mostra come utilizzareget-public-access-block.

AWS CLI

Per impostare o modificare la configurazione di accesso pubblico a blocchi per un bucket

L'get-public-access-blockesempio seguente visualizza la configurazione dell'accesso pubblico a blocchi per il bucket specificato.

aws s3api get-public-access-block --bucket my-bucket

Output:

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

Il seguente esempio di codice mostra come utilizzareget-sites.

AWS CLI

Per accedere ai tuoi siti

L'get-sitesesempio seguente ottiene i siti della rete globale specificata.

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

Output:

{ "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" } ] }
  • Per API i dettagli, vedere GetSitesin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-transit-gateway-registrations.

AWS CLI

Per ottenere le registrazioni dei gateway di transito

L'get-transit-gateway-registrationsesempio seguente ottiene i gateway di transito registrati nella rete globale specificata.

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

Output:

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

Il seguente esempio di codice mostra come utilizzareget-vpc-attachment.

AWS CLI

Per ottenere un VPC allegato

L'get-vpc-attachmentesempio seguente restituisce informazioni su un VPC allegato.

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

Output:

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

Per ulteriori informazioni, consulta la Guida per l'WANutente Attachments in the Cloud.

Il seguente esempio di codice mostra come utilizzarelist-bucket-analytics-configurations.

AWS CLI

Per recuperare un elenco di configurazioni di analisi per un bucket

Quanto segue list-bucket-analytics-configurations recupera un elenco di configurazioni di analisi per il bucket specificato.

aws s3api list-bucket-analytics-configurations \ --bucket my-bucket

Output:

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

Il seguente esempio di codice mostra come utilizzarelist-bucket-metrics-configurations.

AWS CLI

Per recuperare un elenco di configurazioni di metriche per un bucket

L'list-bucket-metrics-configurationsesempio seguente recupera un elenco di configurazioni di metriche per il bucket specificato.

aws s3api list-bucket-metrics-configurations \ --bucket my-bucket

Output:

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

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Per elencare i tag di una risorsa

L'list-tags-for-resourceesempio seguente elenca i tag per la risorsa del dispositivo specificata (device-07f6fd08867abc123).

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

Output:

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

Il seguente esempio di codice mostra come utilizzareput-bucket-metrics-configuration.

AWS CLI

Per impostare una configurazione delle metriche per un bucket

L'put-bucket-metrics-configurationesempio seguente imposta una configurazione metrica con ID 123 per il bucket specificato.

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

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzareput-object-retention.

AWS CLI

Per impostare una configurazione di conservazione degli oggetti per un oggetto

L'put-object-retentionesempio seguente imposta una configurazione di conservazione degli oggetti per l'oggetto specificato fino al 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" }'

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzareput-public-access-block.

AWS CLI

Per impostare la configurazione di accesso pubblico a blocchi per un bucket

L'put-public-access-blockesempio seguente imposta una configurazione restrittiva di accesso pubblico a blocchi per il bucket specificato.

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

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzareregister-transit-gateway.

AWS CLI

Per registrare un gateway di transito in una rete globale

L'register-transit-gatewayesempio seguente registra il gateway di transito tgw-123abc05e04123abc nella rete globale specificata.

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

Output:

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

Per ulteriori informazioni, vedere Transit Gateway Registrations nella Transit Gateway Network Manager Guide.

Il seguente esempio di codice mostra come utilizzarereject-attachment.

AWS CLI

Rifiutare un allegato

L'reject-attachmentesempio seguente rifiuta una richiesta di VPC allegato.

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

Output:

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

Per ulteriori informazioni, consulta la sezione Accettazione degli allegati nella Cloud WAN User Guide.

Il seguente esempio di codice mostra come utilizzarestart-route-analysis.

AWS CLI

Per iniziare l'analisi del percorso

L'start-route-analysisesempio seguente avvia l'analisi tra un'origine e una destinazione, inclusa l'opzioneinclude-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

Output:

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

Per ulteriori informazioni, vedere Route Analyzer nella Guida per l'utente di AWS Global Networks for Transit Gateways.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Per applicare tag a una risorsa

L'tag-resourceesempio seguente applica il tag Network=Northeast al dispositivodevice-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

Questo comando non produce alcun output.

  • Per API i dettagli, vedere TagResourcein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere i tag da una risorsa

L'untag-resourceesempio seguente rimuove il tag con la chiave Network dal dispositivodevice-07f6fd08867abc123.

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

Questo comando non produce alcun output.

  • Per API i dettagli, vedere UntagResourcein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareupdate-device.

AWS CLI

Per aggiornare un dispositivo

L'update-deviceesempio seguente aggiorna il dispositivo device-07f6fd08867abc123 specificando un ID del sito per il dispositivo.

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

Output:

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

Per ulteriori informazioni, vedere Working with Devices nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere UpdateDevicein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareupdate-global-network.

AWS CLI

Per aggiornare una rete globale

L'update-global-networkesempio seguente aggiorna la descrizione della rete globaleglobal-network-01231231231231231.

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

Output:

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

Per ulteriori informazioni, vedere Global Networks nella Transit Gateway Network Manager Guide.

Il seguente esempio di codice mostra come utilizzareupdate-link.

AWS CLI

Per aggiornare un collegamento

L'update-linkesempio seguente aggiorna le informazioni sulla larghezza di banda per il collegamentolink-11112222aaaabbbb1.

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

Output:

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

Per ulteriori informazioni, vedere Working with Links nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere UpdateLinkin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareupdate-site.

AWS CLI

Per aggiornare un sito

L'update-siteesempio seguente aggiorna la descrizione del sito site-444555aaabbb11223 nella rete globale specificata.

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

Output:

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

Per ulteriori informazioni, vedere Working with Sites nella Transit Gateway Network Manager Guide.

  • Per API i dettagli, vedere UpdateSitein AWS CLI Command Reference.