

Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Exemplos do Network Manager usando AWS CLI
<a name="cli_2_networkmanager_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Network Manager.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `associate-customer-gateway`
<a name="networkmanager_AssociateCustomerGateway_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `associate-customer-gateway`.

**AWS CLI**  
**Como associar um gateway do cliente**  
O exemplo `associate-customer-gateway` a seguir associa o gateway do cliente `cgw-11223344556677889` na rede global especificada com o 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
```
Saída:  

```
{
    "CustomerGatewayAssociation": {
        "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "State": "PENDING"
    }
}
```
Para obter mais informações, consulte [Associações do gateway do cliente](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#cgw-association) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [AssociateCustomerGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/associate-customer-gateway.html)em *Referência de AWS CLI Comandos*. 

### `associate-link`
<a name="networkmanager_AssociateLink_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `associate-link`.

**AWS CLI**  
**Como associar um link**  
O exemplo `associate-link` a seguir associa o link `link-11112222aaaabbbb1` ao dispositivo `device-07f6fd08867abc123`. O link e o dispositivo estão na rede global especificada.  

```
aws networkmanager associate-link \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --link-id link-11112222aaaabbbb1 \
    --region us-west-2
```
Saída:  

```
{
    "LinkAssociation": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "LinkId": "link-11112222aaaabbbb1",
        "LinkAssociationState": "PENDING"
    }
}
```
Para obter mais informações, consulte [Associações de dispositivos e links](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#device-link-association) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [AssociateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/associate-link.html)em *Referência de AWS CLI Comandos*. 

### `create-core-network`
<a name="networkmanager_CreateCoreNetwork_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `create-core-network`.

**AWS CLI**  
**Para criar uma rede principal**  
O `create-core-network` exemplo a seguir cria uma rede principal usando uma descrição e tags opcionais em uma rede global 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"
```
Saída:  

```
{
    "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"
            }
        ]
    }
}
```
Para obter mais informações, consulte [Redes globais e principais](https://docs.aws.amazon.com/network-manager/latest/cloudwan/cloudwan-core-network-policy.html) no *Guia do usuário do AWS Cloud WAN*.  
+  Para obter detalhes da API, consulte [CreateCoreNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-core-network.html)em *Referência de AWS CLI Comandos*. 

### `create-device`
<a name="networkmanager_CreateDevice_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `create-device`.

**AWS CLI**  
**Para criar um dispositivo**  
O exemplo `create-device` a seguir cria um dispositivo na rede global especificada. Os detalhes do dispositivo incluem uma descrição, o tipo, o fornecedor, o modelo e o número de série.  

```
aws networkmanager create-device
    --global-network-id global-network-01231231231231231 \
    --description "New York office device" \
    --type "office device" \
    --vendor "anycompany" \
    --model "abcabc" \
    --serial-number "1234" \
    --region us-west-2
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Trabalhar com dispositivos](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-devices) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [CreateDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-device.html)em *Referência de AWS CLI Comandos*. 

### `create-global-network`
<a name="networkmanager_CreateGlobalNetwork_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `create-global-network`.

**AWS CLI**  
**Para criar uma rede global**  
O exemplo `create-global-network` a seguir cria uma rede global. O estado inicial após a criação é `PENDING`.  

```
aws networkmanager create-global-network
```
Saída:  

```
{
    "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"
    }
}
```
+  Para obter detalhes da API, consulte [CreateGlobalNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-global-network.html)em *Referência de AWS CLI Comandos*. 

### `create-link`
<a name="networkmanager_CreateLink_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `create-link`.

**AWS CLI**  
**Para criar um link**  
O exemplo `create-link` a seguir cria um link na rede global especificada. O link inclui uma descrição e detalhes sobre o tipo de link, a largura de banda e o provedor. O ID do site indica o site ao qual o link está associado.  

```
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
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Trabalhar com links](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-links) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-link.html)em *Referência de AWS CLI Comandos*. 

### `create-site`
<a name="networkmanager_CreateSite_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `create-site`.

**AWS CLI**  
**Para criar um site**  
O exemplo `create-site` a seguir cria um site na rede global especificada. Os detalhes do site incluem uma descrição e as informações de localização.  

```
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
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Trabalhar com sites](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-sites) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [CreateSite](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-site.html)em *Referência de AWS CLI Comandos*. 

### `create-vpc-attachment`
<a name="networkmanager_CreateVpcAttachment_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `create-vpc-attachment`.

**AWS CLI**  
**Para criar um anexo VPC**  
O `create-vpc-attachment` exemplo a seguir cria um anexo VPC com IPv6 suporte em uma rede principal.  

```
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
```
Saída:  

```
{
    "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
        }
    }
}
```
Para obter mais informações, consulte [Criar um anexo](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-create-attachment.html) no *Guia do usuário do Cloud WAN*.  
+  Para obter detalhes da API, consulte [CreateVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/create-vpc-attachment.html)em *Referência de AWS CLI Comandos*. 

### `delete-attachment`
<a name="networkmanager_DeleteAttachment_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-attachment`.

**AWS CLI**  
**Para excluir um anexo**  
O exemplo `delete-attachment` a seguir exclui um anexo do Connect.  

```
aws networkmanager delete-attachment \
    --attachment-id attachment-01feddaeae26ab68c
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Excluir anexos](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-attachments-working-with.html#cloudwan-attachments-deleting) no *Guia do usuário do Cloud WAN*.  
+  Para obter detalhes da API, consulte [DeleteAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-attachment.html)em *Referência de AWS CLI Comandos*. 

### `delete-bucket-analytics-configuration`
<a name="networkmanager_DeleteBucketAnalyticsConfiguration_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-bucket-analytics-configuration`.

**AWS CLI**  
**Para excluir uma configuração de análise de um bucket**  
O exemplo `delete-bucket-analytics-configuration` a seguir recupera a configuração referente ao bucket e ID especificados.  

```
aws s3api delete-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1
```
Este comando não produz saída.  
+  Para obter detalhes da API, consulte [DeleteBucketAnalyticsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-bucket-analytics-configuration.html)em *Referência de AWS CLI Comandos*. 

### `delete-bucket-metrics-configuration`
<a name="networkmanager_DeleteBucketMetricsConfiguration_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-bucket-metrics-configuration`.

**AWS CLI**  
**Para excluir uma configuração de métricas referente a um bucket**  
O exemplo `delete-bucket-metrics-configuration` a seguir remove a configuração referente ao bucket e ID especificados.  

```
aws s3api delete-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123
```
Este comando não produz saída.  
+  Para obter detalhes da API, consulte [DeleteBucketMetricsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-bucket-metrics-configuration.html)em *Referência de AWS CLI Comandos*. 

### `delete-core-network`
<a name="networkmanager_DeleteCoreNetwork_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-core-network`.

**AWS CLI**  
**Para excluir uma rede principal**  
O exemplo `delete-core-network` a seguir exclui uma rede principal de uma rede global Cloud WAN.  

```
aws networkmanager delete-core-network \
    --core-network-id core-network-0fab62fe438d94db6
```
Saída:  

```
{
    "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": []
            }
        ]
    }
}
```
Para obter mais informações, consulte [Redes principais](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-networks-working-with.html#cloudwan-core-networks) no *Guia do usuário do Cloud WAN*.  
+  Para obter detalhes da API, consulte [DeleteCoreNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-core-network.html)em *Referência de AWS CLI Comandos*. 

### `delete-device`
<a name="networkmanager_DeleteDevice_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-device`.

**AWS CLI**  
**Para excluir um dispositivo**  
O exemplo `delete-device` a seguir exclui o dispositivo especificado da rede global especificada.  

```
aws networkmanager delete-device \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --region us-west-2
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Trabalhar com dispositivos](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-devices) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [DeleteDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-device.html)em *Referência de AWS CLI Comandos*. 

### `delete-global-network`
<a name="networkmanager_DeleteGlobalNetwork_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-global-network`.

**AWS CLI**  
**Para excluir uma rede global**  
O exemplo `delete-global-network` a seguir exclui uma rede global.  

```
aws networkmanager delete-global-network \
    --global-network-id global-network-052bedddccb193b6b
```
Saída:  

```
{
    "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"
    }
}
```
+  Para obter detalhes da API, consulte [DeleteGlobalNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-global-network.html)em *Referência de AWS CLI Comandos*. 

### `delete-link`
<a name="networkmanager_DeleteLink_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-link`.

**AWS CLI**  
**Para excluir um link**  
O exemplo `delete-link` a seguir exclui o link especificado da rede global especificada.  

```
aws networkmanager delete-link \
    --global-network-id global-network-01231231231231231  \
    --link-id link-11112222aaaabbbb1 \
    --region us-west-2
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Trabalhar com links](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-links) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-link.html)em *Referência de AWS CLI Comandos*. 

### `delete-public-access-block`
<a name="networkmanager_DeletePublicAccessBlock_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-public-access-block`.

**AWS CLI**  
**Para excluir a configuração do Bloqueio de Acesso Público para um bucket**  
O exemplo `delete-public-access-block` a seguir remove a configuração do Bloqueio de Acesso Público no bucket especificado.  

```
aws s3api delete-public-access-block \
    --bucket amzn-s3-demo-bucket
```
Este comando não produz saída.  
+  Para obter detalhes da API, consulte [DeletePublicAccessBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-public-access-block.html)em *Referência de AWS CLI Comandos*. 

### `delete-site`
<a name="networkmanager_DeleteSite_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-site`.

**AWS CLI**  
**Para excluir um site**  
O exemplo `delete-site` a seguir exclui o site especificado (`site-444555aaabbb11223`) da rede global especificada.  

```
aws networkmanager delete-site \
    --global-network-id global-network-01231231231231231  \
    --site-id site-444555aaabbb11223 \
    --region us-west-2
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Trabalhar com sites](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-sites) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [DeleteSite](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/delete-site.html)em *Referência de AWS CLI Comandos*. 

### `deregister-transit-gateway`
<a name="networkmanager_DeregisterTransitGateway_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `deregister-transit-gateway`.

**AWS CLI**  
**Como cancelar o registro de um gateway de trânsito de uma rede global**  
O exemplo `deregister-transit-gateway` a seguir cancela o registro do gateway de trânsito especificado da rede global especificada.  

```
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
```
Saída:  

```
{
    "TransitGatewayRegistration": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
        "State": {
            "Code": "DELETING"
        }
    }
}
```
Para obter mais informações, consulte [Registro de gateways de trânsito](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-registrations.html) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [DeregisterTransitGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/deregister-transit-gateway.html)em *Referência de AWS CLI Comandos*. 

### `describe-global-networks`
<a name="networkmanager_DescribeGlobalNetworks_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `describe-global-networks`.

**AWS CLI**  
**Para descrever suas redes globais**  
O exemplo `describe-global-networks` a seguir descreve todas as suas redes globais em sua conta.  

```
aws networkmanager describe-global-networks \
    --region us-west-2
```
Saída:  

```
{
    "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"
        }
    ]
}
```
+  Para obter detalhes da API, consulte [DescribeGlobalNetworks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/describe-global-networks.html)em *Referência de AWS CLI Comandos*. 

### `disassociate-customer-gateway`
<a name="networkmanager_DisassociateCustomerGateway_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `disassociate-customer-gateway`.

**AWS CLI**  
**Como desassociar um gateway do cliente**  
O exemplo `disassociate-customer-gateway` a seguir desassocia o gateway do cliente especificado (`cgw-11223344556677889`) da rede global especificada.  

```
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
```
Saída:  

```
{
    "CustomerGatewayAssociation": {
        "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "State": "DELETING"
    }
}
```
Para obter mais informações, consulte [Associações do gateway do cliente](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#cgw-association) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [DisassociateCustomerGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/disassociate-customer-gateway.html)em *Referência de AWS CLI Comandos*. 

### `disassociate-link`
<a name="networkmanager_DisassociateLink_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `disassociate-link`.

**AWS CLI**  
**Como desassociar um link**  
O exemplo `disassociate-link` a seguir desassocia o link especificado do dispositivo `device-07f6fd08867abc123` na rede global especificada.  

```
aws networkmanager disassociate-link \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --link-id link-11112222aaaabbbb1 \
    --region us-west-2
```
Saída:  

```
{
    "LinkAssociation": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "DeviceId": "device-07f6fd08867abc123",
        "LinkId": "link-11112222aaaabbbb1",
        "LinkAssociationState": "DELETING"
    }
}
```
Para obter mais informações, consulte [Associações de dispositivos e links](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#device-link-association) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [DisassociateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/disassociate-link.html)em *Referência de AWS CLI Comandos*. 

### `get-bucket-analytics-configuration`
<a name="networkmanager_GetBucketAnalyticsConfiguration_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-bucket-analytics-configuration`.

**AWS CLI**  
**Para recuperar a configuração de análise de um bucket com um ID específico**  
O exemplo `get-bucket-analytics-configuration` a seguir recupera a configuração de análise referente ao bucket e ID especificados.  

```
aws s3api get-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 1
```
Saída:  

```
{
    "AnalyticsConfiguration": {
        "StorageClassAnalysis": {},
        "Id": "1"
    }
}
```
+  Para obter detalhes da API, consulte [GetBucketAnalyticsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-bucket-analytics-configuration.html)em *Referência de AWS CLI Comandos*. 

### `get-bucket-metrics-configuration`
<a name="networkmanager_GetBucketMetricsConfiguration_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-bucket-metrics-configuration`.

**AWS CLI**  
**Para recuperar a configuração de métricas de um bucket com um ID específico**  
O exemplo `get-bucket-metrics-configuration` a seguir exibe a configuração de métricas referente ao bucket e ID especificados.  

```
aws s3api get-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123
```
Saída:  

```
{
    "MetricsConfiguration": {
        "Filter": {
            "Prefix": "logs"
        },
        "Id": "123"
    }
}
```
+  Para obter detalhes da API, consulte [GetBucketMetricsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-bucket-metrics-configuration.html)em *Referência de AWS CLI Comandos*. 

### `get-customer-gateway-associations`
<a name="networkmanager_GetCustomerGatewayAssociations_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-customer-gateway-associations`.

**AWS CLI**  
**Para obter suas associações de gateway do cliente**  
O exemplo `get-customer-gateway-associations` a seguir obtém as associações de gateway do cliente da rede global especificada.  

```
aws networkmanager get-customer-gateway-associations \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2
```
Saída:  

```
{
    "CustomerGatewayAssociations": [
        {
            "CustomerGatewayArn": "arn:aws:ec2:us-west-2:123456789012:customer-gateway/cgw-11223344556677889",
            "GlobalNetworkId": "global-network-01231231231231231",
            "DeviceId": "device-07f6fd08867abc123",
            "State": "AVAILABLE"
        }
    ]
}
```
+  Para obter detalhes da API, consulte [GetCustomerGatewayAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-customer-gateway-associations.html)em *Referência de AWS CLI Comandos*. 

### `get-devices`
<a name="networkmanager_GetDevices_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-devices`.

**AWS CLI**  
**Como configurar o dispositivo**  
O exemplo `get-devices` a seguir obtém os dispositivos na rede global especificada.  

```
aws networkmanager get-devices \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2
```
Saída:  

```
{
    "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"
        }
    ]
}
```
+  Para obter detalhes da API, consulte [GetDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-devices.html)em *Referência de AWS CLI Comandos*. 

### `get-link-associations`
<a name="networkmanager_GetLinkAssociations_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-link-associations`.

**AWS CLI**  
**Para obter suas associações de links**  
O exemplo `get-link-associations` a seguir obtém as associações de links na rede global especificada.  

```
aws networkmanager get-link-associations \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2
```
Saída:  

```
{
    "LinkAssociations": [
        {
            "GlobalNetworkId": "global-network-01231231231231231",
            "DeviceId": "device-07f6fd08867abc123",
            "LinkId": "link-11112222aaaabbbb1",
            "LinkAssociationState": "AVAILABLE"
        }
    ]
}
```
+  Para obter detalhes da API, consulte [GetLinkAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-link-associations.html)em *Referência de AWS CLI Comandos*. 

### `get-links`
<a name="networkmanager_GetLinks_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-links`.

**AWS CLI**  
**Para obter seus links**  
O exemplo `get-links` a seguir obtém os links na rede global especificada.  

```
aws networkmanager get-links \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2
```
Saída:  

```
{
    "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"
        }
    ]
}
```
+  Para obter detalhes da API, consulte [GetLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-links.html)em *Referência de AWS CLI Comandos*. 

### `get-object-retention`
<a name="networkmanager_GetObjectRetention_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-object-retention`.

**AWS CLI**  
**Para recuperar a configuração de retenção de objetos de um objeto**  
O exemplo de `get-object-retention` a seguir recupera a configuração de retenção de objetos do objeto especificado.  

```
aws s3api get-object-retention \
    --bucket amzn-s3-demo-bucket-with-object-lock \
    --key doc1.rtf
```
Saída:  

```
{
    "Retention": {
        "Mode": "GOVERNANCE",
        "RetainUntilDate": "2025-01-01T00:00:00.000Z"
    }
}
```
+  Para obter detalhes da API, consulte [GetObjectRetention](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-object-retention.html)em *Referência de AWS CLI Comandos*. 

### `get-public-access-block`
<a name="networkmanager_GetPublicAccessBlock_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-public-access-block`.

**AWS CLI**  
**Para definir ou modificar a configuração do Bloqueio de Acesso Público de um bucket**  
O exemplo `get-public-access-block` a seguir exibe a configuração do Bloqueio de Acesso Público do bucket especificado.  

```
aws s3api get-public-access-block --bucket amzn-s3-demo-bucket
```
Saída:  

```
{
    "PublicAccessBlockConfiguration": {
        "IgnorePublicAcls": true,
        "BlockPublicPolicy": true,
        "BlockPublicAcls": true,
        "RestrictPublicBuckets": true
    }
}
```
+  Para obter detalhes da API, consulte [GetPublicAccessBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-public-access-block.html)em *Referência de AWS CLI Comandos*. 

### `get-sites`
<a name="networkmanager_GetSites_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-sites`.

**AWS CLI**  
**Para obter seus sites**  
O exemplo `get-sites` a seguir obtém os sites na rede global especificada.  

```
aws networkmanager get-sites \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2
```
Saída:  

```
{
    "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"
        }
    ]
}
```
+  Para obter detalhes da API, consulte [GetSites](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-sites.html)em *Referência de AWS CLI Comandos*. 

### `get-transit-gateway-registrations`
<a name="networkmanager_GetTransitGatewayRegistrations_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-transit-gateway-registrations`.

**AWS CLI**  
**Para obter seus registros de gateways de trânsito**  
O exemplo `get-transit-gateway-registrations` a seguir obtém os gateways de trânsito registrados na rede global especificada.  

```
aws networkmanager get-transit-gateway-registrations \
    --global-network-id global-network-01231231231231231 \
    --region us-west-2
```
Saída:  

```
{
    "TransitGatewayRegistrations": [
        {
            "GlobalNetworkId": "global-network-01231231231231231",
            "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
            "State": {
                "Code": "AVAILABLE"
            }
        }
    ]
}
```
+  Para obter detalhes da API, consulte [GetTransitGatewayRegistrations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-transit-gateway-registrations.html)em *Referência de AWS CLI Comandos*. 

### `get-vpc-attachment`
<a name="networkmanager_GetVpcAttachment_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-vpc-attachment`.

**AWS CLI**  
**Como obter um anexo de VPC**  
O exemplo `get-vpc-attachment` a seguir recupera informações sobre um anexo de VPC.  

```
aws networkmanager get-vpc-attachment \
    --attachment-id  attachment-03b7ea450134787da
```
Saída:  

```
{
    "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
        }
    }
}
```
Para obter mais informações, consulte [Anexos](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-attachments-working-with.html) no *Guia do usuário do Cloud WAN*.  
+  Para obter detalhes da API, consulte [GetVpcAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/get-vpc-attachment.html)em *Referência de AWS CLI Comandos*. 

### `list-bucket-analytics-configurations`
<a name="networkmanager_ListBucketAnalyticsConfigurations_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-bucket-analytics-configurations`.

**AWS CLI**  
**Para recuperar uma lista de configurações de análise de um bucket**  
O exemplo `list-bucket-analytics-configurations` a seguir recupera uma lista de configurações de análise do bucket especificado.  

```
aws s3api list-bucket-analytics-configurations \
    --bucket amzn-s3-demo-bucket
```
Saída:  

```
{
    "AnalyticsConfigurationList": [
        {
            "StorageClassAnalysis": {},
            "Id": "1"
        }
    ],
    "IsTruncated": false
}
```
+  Para obter detalhes da API, consulte [ListBucketAnalyticsConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/list-bucket-analytics-configurations.html)em *Referência de AWS CLI Comandos*. 

### `list-bucket-metrics-configurations`
<a name="networkmanager_ListBucketMetricsConfigurations_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-bucket-metrics-configurations`.

**AWS CLI**  
**Para recuperar uma lista de configurações de métrica de um bucket**  
O exemplo `list-bucket-metrics-configurations` a seguir recupera uma lista de configurações de métricas do bucket especificado.  

```
aws s3api list-bucket-metrics-configurations \
    --bucket amzn-s3-demo-bucket
```
Saída:  

```
{
    "IsTruncated": false,
    "MetricsConfigurationList": [
        {
            "Filter": {
                "Prefix": "logs"
            },
            "Id": "123"
        },
        {
            "Filter": {
                "Prefix": "tmp"
            },
            "Id": "234"
        }
    ]
}
```
+  Para obter detalhes da API, consulte [ListBucketMetricsConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/list-bucket-metrics-configurations.html)em *Referência de AWS CLI Comandos*. 

### `list-tags-for-resource`
<a name="networkmanager_ListTagsForResource_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-tags-for-resource`.

**AWS CLI**  
**Para listar as tags de um recurso**  
O exemplo `list-tags-for-resource` a seguir lista as tags para o recurso de dispositivo especificado (`device-07f6fd08867abc123`).  

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

```
{
    "TagList": [
        {
            "Key": "Network",
            "Value": "Northeast"
        }
    ]
}
```
+  Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*. 

### `put-bucket-metrics-configuration`
<a name="networkmanager_PutBucketMetricsConfiguration_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `put-bucket-metrics-configuration`.

**AWS CLI**  
**Como definir uma configuração de métricas para um bucket**  
O exemplo `put-bucket-metrics-configuration` a seguir define a configuração de métricas com ID 123 para o bucket especificado.  

```
aws s3api put-bucket-metrics-configuration \
    --bucket amzn-s3-demo-bucket \
    --id 123 \
    --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}'
```
Este comando não produz saída.  
+  Para obter detalhes da API, consulte [PutBucketMetricsConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/put-bucket-metrics-configuration.html)em *Referência de AWS CLI Comandos*. 

### `put-object-retention`
<a name="networkmanager_PutObjectRetention_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `put-object-retention`.

**AWS CLI**  
**Como definir uma configuração de retenção de objetos para um objeto**  
O exemplo de `put-object-retention` a seguir define uma configuração de retenção de objetos para o objeto especificado até 2025-01-01.  

```
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" }'
```
Este comando não produz saída.  
+  Para obter detalhes da API, consulte [PutObjectRetention](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/put-object-retention.html)em *Referência de AWS CLI Comandos*. 

### `put-public-access-block`
<a name="networkmanager_PutPublicAccessBlock_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `put-public-access-block`.

**AWS CLI**  
**Como definir a configuração do bloqueio de acesso público de um bucket**  
O exemplo `put-public-access-block` a seguir define uma configuração restritiva de bloqueio de acesso público para o bucket especificado.  

```
aws s3api put-public-access-block \
    --bucket amzn-s3-demo-bucket \
    --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"
```
Este comando não produz saída.  
+  Para obter detalhes da API, consulte [PutPublicAccessBlock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/put-public-access-block.html)em *Referência de AWS CLI Comandos*. 

### `register-transit-gateway`
<a name="networkmanager_RegisterTransitGateway_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `register-transit-gateway`.

**AWS CLI**  
**Para registrar um gateway de trânsito em uma rede global**  
O exemplo `register-transit-gateway` a seguir registra um gateway de trânsito `tgw-123abc05e04123abc` na rede global especificada.  

```
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
```
Saída:  

```
{
    "TransitGatewayRegistration": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "TransitGatewayArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway/tgw-123abc05e04123abc",
        "State": {
            "Code": "PENDING"
        }
    }
}
```
Para obter mais informações, consulte [Registro de gateways de trânsito](https://docs.aws.amazon.com/vpc/latest/tgw/tgw-registrations.html) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [RegisterTransitGateway](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/register-transit-gateway.html)em *Referência de AWS CLI Comandos*. 

### `reject-attachment`
<a name="networkmanager_RejectAttachment_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `reject-attachment`.

**AWS CLI**  
**Como rejeitar um anexo**  
O exemplo `reject-attachment` a seguir rejeita uma solicitação de anexo de VPC.  

```
aws networkmanager reject-attachment \
    --attachment-id  attachment-03b7ea450134787da
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Aceitação de anexos](https://docs.aws.amazon.com/vpc/latest/cloudwan/cloudwan-attachments-working-with.html#cloudwan-attachments-acceptance) no *Guia do usuário do Cloud WAN*.  
+  Para obter detalhes da API, consulte [RejectAttachment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/reject-attachment.html)em *Referência de AWS CLI Comandos*. 

### `start-route-analysis`
<a name="networkmanager_StartRouteAnalysis_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `start-route-analysis`.

**AWS CLI**  
**Para iniciar a análise da rota**  
O exemplo `start-route-analysis` a seguir inicia a análise entre a origem e o destino, incluindo o `include-return-path` opcional.  

```
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
```
Saída:  

```
{
    "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
    }
}
```
Para obter mais informações, consulte o [Analisador de rotas](https://docs.aws.amazon.com/network-manager/latest/tgwnm/route-analyzer.html) no *Guia do AWS Global Networks for Transit Gateways*.  
+  Para obter detalhes da API, consulte [StartRouteAnalysis](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/start-route-analysis.html)em *Referência de AWS CLI Comandos*. 

### `tag-resource`
<a name="networkmanager_TagResource_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `tag-resource`.

**AWS CLI**  
**Aplicar marcas a um recurso**  
O exemplo `tag-resource` a seguir aplica a tag `Network=Northeast` ao 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
```
Este comando não produz saída.  
+  Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/tag-resource.html)em *Referência de AWS CLI Comandos*. 

### `untag-resource`
<a name="networkmanager_UntagResource_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `untag-resource`.

**AWS CLI**  
**Como remover as tags de um recurso**  
O exemplo `untag-resource` a seguir remove a tag com o nome de chave `Network` do 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
```
Este comando não produz saída.  
+  Para obter detalhes da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/untag-resource.html)em *Referência de AWS CLI Comandos*. 

### `update-device`
<a name="networkmanager_UpdateDevice_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `update-device`.

**AWS CLI**  
**Para atualizar um dispositivo**  
O exemplo `update-device` a seguir atualiza o dispositivo `device-07f6fd08867abc123` especificando uma ID do site para o dispositivo.  

```
aws networkmanager update-device \
    --global-network-id global-network-01231231231231231 \
    --device-id device-07f6fd08867abc123 \
    --site-id site-444555aaabbb11223 \
    --region us-west-2
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Trabalhar com dispositivos](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-devices) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [UpdateDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-device.html)em *Referência de AWS CLI Comandos*. 

### `update-global-network`
<a name="networkmanager_UpdateGlobalNetwork_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `update-global-network`.

**AWS CLI**  
**Para atualizar uma rede global**  
O exemplo `update-global-network` a seguir atualiza a descrição da rede global `global-network-01231231231231231`.  

```
aws networkmanager update-global-network \
    --global-network-id global-network-01231231231231231 \
    --description "Head offices" \
    --region us-west-2
```
Saída:  

```
{
    "GlobalNetwork": {
        "GlobalNetworkId": "global-network-01231231231231231",
        "GlobalNetworkArn": "arn:aws:networkmanager::123456789012:global-network/global-network-01231231231231231",
        "Description": "Head offices",
        "CreatedAt": 1575553525.0,
        "State": "UPDATING"
    }
}
```
Para obter mais informações, consulte [Redes globais](https://docs.aws.amazon.com/vpc/latest/tgw/global-networks.html) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [UpdateGlobalNetwork](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-global-network.html)em *Referência de AWS CLI Comandos*. 

### `update-link`
<a name="networkmanager_UpdateLink_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `update-link`.

**AWS CLI**  
**Para atualizar um link**  
O exemplo `update-link` a seguir atualiza as informações de largura de banda do 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
```
Saída:  

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Trabalhar com links](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-links) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-link.html)em *Referência de AWS CLI Comandos*. 

### `update-site`
<a name="networkmanager_UpdateSite_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `update-site`.

**AWS CLI**  
**Para atualizar um site**  
O exemplo `update-site` a seguir atualiza a descrição do site `site-444555aaabbb11223` na rede global especificada.  

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

```
{
    "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"
    }
}
```
Para obter mais informações, consulte [Trabalhar com sites](https://docs.aws.amazon.com/vpc/latest/tgw/on-premises-networks.html#working-with-sites) no *Guia do Transit Gateway Network Manager*.  
+  Para obter detalhes da API, consulte [UpdateSite](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmanager/update-site.html)em *Referência de AWS CLI Comandos*. 