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

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

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 azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

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

AWS CLI

Come associare un gateway del cliente

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

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 Associazioni del gateway del cliente nella Guida di Transit Gateway network manager.

Il seguente esempio di codice mostra come utilizzareassociate-link.

AWS CLI

Come associare un link

L’esempio associate-link seguente associa il link link-11112222aaaabbbb1 al dispositivo device-07f6fd08867abc123. Il link 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, consulta Associazioni di dispositivi e link nella Guida di Transit Gateway network manager.

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

AWS CLI

Come creare una rete principale

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

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 Reti di base e globali nella Guida per l’utente di AWS Cloud WAN.

Il seguente esempio di codice mostra come utilizzarecreate-device.

AWS CLI

Come creare un dispositivo

L’esempio create-device 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, consulta Utilizzo di dispositivi nella Guida di Transit Gateway network manager.

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

AWS CLI

Come creare una rete globale

L’esempio create-global-network seguente crea 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

Come creare un link

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

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, consulta Utilizzo di link nella Guida di Transit Gateway network manager.

Il seguente esempio di codice mostra come utilizzarecreate-site.

AWS CLI

Come creare un sito

L’esempio create-site 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, consulta Utilizzo di siti nella Guida di Transit Gateway network manager.

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

AWS CLI

Come creare un collegamento VPC

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

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 Creare un collegameto nella Guida per l’utente di Cloud WAN.

Il seguente esempio di codice mostra come utilizzaredelete-attachment.

AWS CLI

Come eliminare un collegamento

L’esempio delete-attachment seguente elimina un collegamento 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 i collegamenti nella Guida per l’utente di Cloud WAN.

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

AWS CLI

Come eliminare una configurazione di analisi per un bucket

L’esempio delete-bucket-analytics-configuration seguente rimuove la configurazione di analisi per il bucket e l’ID specificati.

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

Questo comando non produce alcun output.

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

AWS CLI

Come eliminare una configurazione delle metriche per un bucket

L’esempio delete-bucket-metrics-configuration seguente rimuove la configurazione delle metriche per il bucket e l’ID specificati.

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

Questo comando non produce alcun output.

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

AWS CLI

Come eliminare una rete principale

L’esempio delete-core-network seguente elimina una rete core da una rete globale Cloud WAN.

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 Reti di base nella Guida per l’utente di Cloud WAN.

Il seguente esempio di codice mostra come utilizzaredelete-device.

AWS CLI

Come eliminare un dispositivo

L’esempio delete-device 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, consulta Utilizzo di dispositivi nella Guida di Transit Gateway network manager.

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

AWS CLI

Come eliminare una rete globale

L’esempio delete-global-network 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

Come eliminare un link

L’esempio delete-link 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, consulta Utilizzo di link nella Guida di Transit Gateway network manager.

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

AWS CLI

Come eliminare la configurazione di blocco dell’accesso pubblico per un bucket

L’esempio delete-public-access-block seguente rimuove la configurazione del blocco dell’accesso pubblico per il bucket e l’ID specificati.

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

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzaredelete-site.

AWS CLI

Come eliminare un sito

L’esempio delete-site 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, consulta Utilizzo di siti nella Guida di Transit Gateway network manager.

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

AWS CLI

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

L’esempio deregister-transit-gateway seguente annulla la registrazione del gateway di transito specificato nella 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, consulta Registrazioni di Transit Gateway nella Guida di Transit Gateway network manager.

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

AWS CLI

Come descrivere le reti globali

L’esempio describe-global-networks seguente descrive tutte le reti globali nell’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

Come dissociare un gateway del cliente

L’esempio disassociate-customer-gateway seguente dissocia il gateway del cliente 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 Associazioni del gateway del cliente nella Guida di Transit Gateway network manager.

Il seguente esempio di codice mostra come utilizzaredisassociate-link.

AWS CLI

Come dissociare un link

L’esempio disassociate-link seguente dissocia il link 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, consulta Associazioni di dispositivi e link nella Guida di Transit Gateway network manager.

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

AWS CLI

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

L’esempio get-bucket-analytics-configuration seguente visualizza la configurazione di analisi per il bucket e l’ID specificati.

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

Output:

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

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

AWS CLI

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

L’esempio get-bucket-metrics-configuration seguente visualizza la configurazione delle metriche per il bucket e l’ID specificati.

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

Output:

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

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

AWS CLI

Come ottenere le associazioni del gateway del cliente

L’esempio get-customer-gateway-associations seguente ottiene le associazioni del gateway del cliente 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

Come ottenere i tuoi dispositivi

L’esempio get-devices 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"
        }
    ]
}

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

AWS CLI

Come ottenere le associazioni dei link

L’esempio get-link-associations seguente ottiene le associazioni dei 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

Come ottenere i tuoi link

L’esempio get-links seguente ottiene i link 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"
        }
    ]
}

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

AWS CLI

Come recuperare la configurazione di conservazione degli oggetti per un oggetto

L’esempio get-object-retention seguente recupera la configurazione di conservazione degli oggetti per il bucket specificato.

aws s3api get-object-retention \
    --bucket amzn-s3-demo-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

Come impostare o modificare la configurazione di blocco dell’accesso pubblico per un bucket

L’esempio get-public-access-block seguente visualizza la configurazione del blocco dell’accesso pubblico per il bucket specificato.

aws s3api get-public-access-block --bucket amzn-s3-demo-bucket

Output:

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

Il seguente esempio di codice mostra come utilizzareget-sites.

AWS CLI

Come ottenere i tuoi siti

L’esempio get-sites seguente ottiene i siti nella 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"
        }
    ]
}

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

AWS CLI

Come ottenere le registrazioni dei gateway di transito

L’esempio get-transit-gateway-registrations 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

Come ottenere un collegamento VPC

L’esempio get-vpc-attachment seguente restituisce informazioni su un collegamento VPC.

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 Collegamenti nella Guida per l’utente di Cloud WAN.

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

AWS CLI

Come recuperare un elenco di configurazioni di analisi per un bucket

L’esempio list-bucket-analytics-configurations seguente recupera un elenco di configurazioni di analisi per il bucket specificato.

aws s3api list-bucket-analytics-configurations \
    --bucket amzn-s3-demo-bucket

Output:

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

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

AWS CLI

Come recuperare un elenco di configurazioni di analisi per un bucket

L’esempio list-bucket-metrics-configurations seguente recupera un elenco di configurazioni di metriche per il bucket specificato.

aws s3api list-bucket-metrics-configurations \
    --bucket amzn-s3-demo-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

Come elencare i tag per una risorsa

L’esempio list-tags-for-resource seguente elenca i tag per la risorsa 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

Come eliminare una configurazione delle metriche per un bucket

L’esempio put-bucket-metrics-configuration seguente imposta una configurazione della metrica con ID 123 per il bucket specificato.

aws s3api put-bucket-metrics-configuration \
    --bucket amzn-s3-demo-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

Come impostare la configurazione di conservazione degli oggetti per un oggetto

L’esempio put-object-retention seguente imposta una configurazione di conservazione degli oggetti per l’oggetto specificato fino al giorno 01/01/2025.

aws s3api put-object-retention \
    --bucket amzn-s3-demo-bucket-with-object-lock \
    --key doc1.rtf \
    --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'

Questo comando non produce alcun output.

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

AWS CLI

Come impostare la configurazione di blocco dell’accesso pubblico per un bucket

L’esempio put-public-access-block seguente imposta una configurazione di blocco dell’accesso pubblico restrittiva per il bucket specificato.

aws s3api put-public-access-block \
    --bucket amzn-s3-demo-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

Come registrare un gateway di transito in una rete globale

L’esempio register-transit-gateway 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, consulta Registrazioni di Transit Gateway nella Guida di Transit Gateway network manager.

Il seguente esempio di codice mostra come utilizzarereject-attachment.

AWS CLI

Come rifiutare un collegamento

L’esempio reject-attachment seguente rifiuta una richiesta di collegamento VPC.

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 Accettazione dei collegamenti nella Guida per l’utente di Cloud WAN.

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

AWS CLI

Come avviare l’analisi delle route

L’esempio start-route-analysis seguente avvia l’analisi tra un’origine e una destinazione, inclusa l’opzione include-return-path facoltativa.

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, consulta Strumento di analisi delle route nella Guida per l’utente di Reti globali AWS per gateway di transito.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come applicare tag a una risorsa

L’esempio tag-resource seguente applica il tag Network=Northeast al dispositivo device-07f6fd08867abc123.

aws networkmanager tag-resource \
    --resource-arn arn:aws:networkmanager::123456789012:device/global-network-01231231231231231/device-07f6fd08867abc123 \
    --tags Key=Network,Value=Northeast \
    --region us-west-2

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere tag da una risorsa

L’esempio untag-resource seguente rimuove il tag con la chiave Network dal dispositivo device-07f6fd08867abc123.

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

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzareupdate-device.

AWS CLI

Come aggiornare un dispositivo

L’esempio update-device 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, consulta Utilizzo di dispositivi nella Guida di Transit Gateway network manager.

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

AWS CLI

Come aggiornare una rete globale

L’esempio update-global-network seguente aggiorna la descrizione per la rete globale global-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, consulta Reti globali nella Guida di Transit Gateway network manager.

Il seguente esempio di codice mostra come utilizzareupdate-link.

AWS CLI

Come aggiornare un link

L’esempio update-link seguente aggiorna le informazioni sulla larghezza di banda per il link link-11112222aaaabbbb1.

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

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, consulta Utilizzo di link nella Guida di Transit Gateway network manager.

Il seguente esempio di codice mostra come utilizzareupdate-site.

AWS CLI

Come aggiornare un sito

L’esempio update-site seguente aggiorna la descrizione per il 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, consulta Utilizzo di siti nella Guida di Transit Gateway network manager.