# Exemplos do Global Accelerator usando AWS CLI
<a name="cli_global-accelerator_code_examples"></a>

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

*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>

### `add-custom-routing-endpoints`
<a name="global-accelerator_AddCustomRoutingEndpoints_cli_topic"></a>

O código de exemplo a seguir mostra como usar `add-custom-routing-endpoints`.

**AWS CLI**  
**Para adicionar um endpoint de sub-rede VPC a um grupo de endpoints para um acelerador de roteamento personalizado**  
O exemplo `add-custom-routing-endpoints` a seguir adiciona um endpoint de sub-rede VPC a um grupo de endpoints para um acelerador de roteamento personalizado.  

```
aws globalaccelerator add-custom-routing-endpoints \
    --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd \
    --endpoint-configurations "EndpointId=subnet-1234567890abcdef0"
```
Resultado:  

```
{
    "EndpointDescriptions": [
        {
            "EndpointId": "subnet-1234567890abcdef0"
        }
    ],
    "EndpointGroupArn":"arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd"
}
```
Para obter mais informações, consulte [Endpoints de sub-rede da Amazon VPC para aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [AddCustomRoutingEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/add-custom-routing-endpoints.html) na *Referência de comandos da AWS CLI*. 

### `advertise-byoip-cidr`
<a name="global-accelerator_AdvertiseByoipCidr_cli_topic"></a>

O código de exemplo a seguir mostra como usar `advertise-byoip-cidr`.

**AWS CLI**  
**Anunciar um intervalo de endereços**  
O exemplo `advertise-byoip-cidr` a seguir solicita que AWS anuncie um intervalo de endereços fornecido pelo usuário para ser usado com seus recursos. AWS  

```
aws globalaccelerator advertise-byoip-cidr \
    --cidr 198.51.100.0/24
```
Resultado:  

```
{
    "ByoipCidr": {
        "Cidr": "198.51.100.0/24",
        "State": "PENDING_ADVERTISING"
    }
}
```
Para obter mais informações, consulte [Usar seu próprio endereço IP no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [AdvertiseByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/advertise-byoip-cidr.html) na *Referência de comandos da AWS CLI*. 

### `allow-custom-routing-traffic`
<a name="global-accelerator_AllowCustomRoutingTraffic_cli_topic"></a>

O código de exemplo a seguir mostra como usar `allow-custom-routing-traffic`.

**AWS CLI**  
**Permitir tráfego para destinos específicos de instâncias do Amazon EC2 em uma sub-rede VPC para um acelerador de roteamento personalizado**  
O exemplo `allow-custom-routing-traffic` a seguir especifica que o tráfego é permitido para determinados endereços IP e portas de instância (destino) do Amazon EC2 para um endpoint de sub-rede VPC em um acelerador de roteamento personalizado que pode receber o tráfego.  

```
aws globalaccelerator allow-custom-routing-traffic \
    --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example \
    --endpoint-id subnet-abcd123example \
    --destination-addresses "172.31.200.6" "172.31.200.7" \
    --destination-ports 80 81
```
Este comando não produz saída.  
Para obter mais informações, consulte [Endpoints de sub-rede da Amazon VPC para aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [AllowCustomRoutingTraffic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/allow-custom-routing-traffic.html) na *Referência de comandos da AWS CLI*. 

### `create-accelerator`
<a name="global-accelerator_CreateAccelerator_cli_topic"></a>

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

**AWS CLI**  
**Criar um acelerador**  
O exemplo `create-accelerator` a seguir cria um acelerador de duas marcas com dois endereços IP estáticos BYOIP. É necessário especificar a região `US-West-2 (Oregon)` para criar ou atualizar um acelerador.  

```
aws globalaccelerator create-accelerator \
    --name ExampleAccelerator \
    --tags Key="Name",Value="Example Name" Key="Project",Value="Example Project" \
    --ip-addresses 192.0.2.250 198.51.100.52
```
Resultado:  

```
{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleAccelerator",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1542394847.0,
        "LastModifiedTime": 1542394847.0
    }
}
```
Para obter mais informações, consulte [Aceleradores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [CreateAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-accelerator.html) na *Referência de comandos da AWS CLI*. 

### `create-custom-routing-accelerator`
<a name="global-accelerator_CreateCustomRoutingAccelerator_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-custom-routing-accelerator`.

**AWS CLI**  
**Criar um acelerador de roteamento personalizado**  
O exemplo `create-custom-routing-accelerator` a seguir cria um acelerador de roteamento personalizado com as marcas `Name` e `Project`.  

```
aws globalaccelerator create-custom-routing-accelerator \
    --name ExampleCustomRoutingAccelerator \
    --tags Key="Name",Value="Example Name" Key="Project",Value="Example Project" \
    --ip-addresses 192.0.2.250 198.51.100.52
```
Resultado:  

```
{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleCustomRoutingAccelerator",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1542394847.0,
        "LastModifiedTime": 1542394847.0
    }
}
```
Para obter mais informações, consulte [Aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [CreateCustomRoutingAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-accelerator.html) na *Referência de comandos da AWS CLI*. 

### `create-custom-routing-endpoint-group`
<a name="global-accelerator_CreateCustomRoutingEndpointGroup_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-custom-routing-endpoint-group`.

**AWS CLI**  
**Criar um grupo de endpoints para um acelerador de roteamento personalizado**  
O exemplo `create-custom-routing-endpoint-group` a seguir cria um grupo de endpoints para um acelerador de roteamento personalizado.  

```
aws globalaccelerator create-custom-routing-endpoint-group \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \
    --endpoint-group-region us-east-2 \
    --destination-configurations "FromPort=80,ToPort=81,Protocols=TCP,UDP"
```
Resultado:  

```
{
    "EndpointGroup": {
        "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd",
        "EndpointGroupRegion": "us-east-2",
        "DestinationDescriptions": [
            {
                "FromPort": 80,
                "ToPort": 81,
                "Protocols": [
                    "TCP",
                    "UDP"
                ]
            }
        ],
        "EndpointDescriptions": []
    }
}
```
Para obter mais informações, consulte [Grupos de endpoints para aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [CreateCustomRoutingEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-endpoint-group.html) na *Referência de comandos da AWS CLI*. 

### `create-custom-routing-listener`
<a name="global-accelerator_CreateCustomRoutingListener_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-custom-routing-listener`.

**AWS CLI**  
**Criar um receptor para acelerador de roteamento personalizado**  
O exemplo `create-custom-routing-listener` a seguir cria um receptor com um intervalo de portas de 5.000 a 10.000 para um acelerador de roteamento personalizado.  

```
aws globalaccelerator create-custom-routing-listener \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --port-ranges FromPort=5000,ToPort=10000
```
Resultado:  

```
{
    "Listener": {
        "PortRange": [
            "FromPort": 5000,
            "ToPort": 10000
        ],
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz"
    }
}
```
Para obter mais informações, consulte [Receptores de aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [CreateCustomRoutingListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-listener.html) na *Referência de comandos da AWS CLI*. 

### `create-endpoint-group`
<a name="global-accelerator_CreateEndpointGroup_cli_topic"></a>

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

**AWS CLI**  
**Criar um grupo de endpoints**  
O exemplo `create-endpoint-group` a seguir cria um grupo de endpoints com um endpoint.  

```
aws globalaccelerator create-endpoint-group \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \
    --endpoint-group-region us-east-1 \
    --endpoint-configurations EndpointId=i-1234567890abcdef0,Weight=128
```
Resultado:  

```
{
    "EndpointGroup": {
        "TrafficDialPercentage": 100.0,
        "EndpointDescriptions": [
            {
                "Weight": 128,
                "EndpointId": "i-1234567890abcdef0"
            }
        ],
        "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu",
        "EndpointGroupRegion": "us-east-1"
    }
}
```
Para obter mais informações, consulte [Grupos de endpoints no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [CreateEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-endpoint-group.html) na *Referência de comandos da AWS CLI*. 

### `create-listener`
<a name="global-accelerator_CreateListener_cli_topic"></a>

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

**AWS CLI**  
**Criar um receptor**  
O exemplo `create-listener` a seguir cria um receptor com duas portas.  

```
aws globalaccelerator create-listener \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --port-ranges FromPort=80,ToPort=80 FromPort=81,ToPort=81 \
    --protocol TCP
```
Resultado:  

```
{
    "Listener": {
        "PortRanges": [
            {
                "ToPort": 80,
                "FromPort": 80
            },
            {
                "ToPort": 81,
                "FromPort": 81
            }
        ],
        "ClientAffinity": "NONE",
        "Protocol": "TCP",
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz"
    }
}
```
Para obter mais informações, consulte [Receptores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Consulte detalhes da API em [CreateListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-listener.html) na *Referência de comandos da AWS CLI*. 

### `deny-custom-routing-traffic`
<a name="global-accelerator_DenyCustomRoutingTraffic_cli_topic"></a>

O código de exemplo a seguir mostra como usar `deny-custom-routing-traffic`.

**AWS CLI**  
**Especificar um endereço de destino que não pode receber tráfego em um acelerador de roteamento personalizado**  
O exemplo `deny-custom-routing-traffic` a seguir especifica o endereço ou endereços de destino em um endpoint de sub-rede sem condições de receber tráfego para um acelerador de roteamento personalizado. Para especificar mais de um endereço de destino, separe-os com um espaço. Não há resposta para uma chamada bem-sucedida de negação de tráfego personalizado.  

```
aws globalaccelerator deny-custom-routing-traffic \
    --endpoint-group-arn "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example" \
    --endpoint-id "subnet-abcd123example" \
    --destination-addresses "198.51.100.52"
```
Este comando não produz saída.  
Para obter mais informações, consulte [Endpoints de sub-rede da Amazon VPC para aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DenyCustomRoutingTraffic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/deny-custom-routing-traffic.html) na *Referência de comandos da AWS CLI*. 

### `deprovision-byoip-cidr`
<a name="global-accelerator_DeprovisionByoipCidr_cli_topic"></a>

O código de exemplo a seguir mostra como usar `deprovision-byoip-cidr`.

**AWS CLI**  
**Desprovisionar um intervalo de endereços**  
O exemplo `deprovision-byoip-cidr` a seguir libera o intervalo de endereços específico fornecido pelo usuário para uso com seus recursos da AWS.  

```
aws globalaccelerator deprovision-byoip-cidr \
    --cidr "198.51.100.0/24"
```
Resultado:  

```
{
    "ByoipCidr": {
        "Cidr": "198.51.100.0/24",
        "State": "PENDING_DEPROVISIONING"
    }
}
```
Para obter mais informações, consulte [Usar seu próprio endereço IP no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DeprovisionByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/deprovision-byoip-cidr.html) na *Referência de comandos da AWS CLI*. 

### `describe-accelerator-attributes`
<a name="global-accelerator_DescribeAcceleratorAttributes_cli_topic"></a>

O código de exemplo a seguir mostra como usar `describe-accelerator-attributes`.

**AWS CLI**  
**Descrever os atributos de um acelerador**  
O exemplo `describe-accelerator-attributes` a seguir recupera os atributos de um acelerador.  

```
aws globalaccelerator describe-accelerator-attributes \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh
```
Resultado:  

```
{
    "AcceleratorAttributes": {
        "FlowLogsEnabled": true
        "FlowLogsS3Bucket": flowlogs-abc
        "FlowLogsS3Prefix": bucketprefix-abc
    }
}
```
Para obter mais informações, consulte [Aceleradores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DescribeAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-accelerator-attributes.html) na *Referência de comandos da AWS CLI*. 

### `describe-accelerator`
<a name="global-accelerator_DescribeAccelerator_cli_topic"></a>

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

**AWS CLI**  
**Descrever um acelerador**  
O exemplo `describe-accelerator` a seguir recupera detalhes de um acelerador específico.  

```
aws globalaccelerator describe-accelerator \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh
```
Resultado:  

```
{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleAccelerator",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1542394847,
        "LastModifiedTime": 1542395013
    }
}
```
Para obter mais informações, consulte [Aceleradores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DescribeAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-accelerator.html) na *Referência de comandos da AWS CLI*. 

### `describe-custom-routing-accelerator-attributes`
<a name="global-accelerator_DescribeCustomRoutingAcceleratorAttributes_cli_topic"></a>

O código de exemplo a seguir mostra como usar `describe-custom-routing-accelerator-attributes`.

**AWS CLI**  
**Descrever os atributos de um acelerador de roteamento personalizado**  
O exemplo `describe-custom-routing-accelerator-attributes` a seguir descreve os atributos de um acelerador de roteamento personalizado.  

```
aws globalaccelerator describe-custom-routing-accelerator-attributes \
   --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh
```
Resultado:  

```
{
    "AcceleratorAttributes": {
    "FlowLogsEnabled": false
    }
}
```
Para obter mais informações, consulte [Aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DescribeCustomRoutingAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-accelerator-attributes.html) na *Referência de comandos da AWS CLI*. 

### `describe-custom-routing-accelerator`
<a name="global-accelerator_DescribeCustomRoutingAccelerator_cli_topic"></a>

O código de exemplo a seguir mostra como usar `describe-custom-routing-accelerator`.

**AWS CLI**  
**Descrever um acelerador de roteamento personalizado**  
O exemplo `describe-custom-routing-accelerator` a seguir recupera detalhes de um dado acelerador de roteamento personalizado.  

```
aws globalaccelerator describe-custom-routing-accelerator \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh
```
Resultado:  

```
{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleCustomRoutingAccelerator",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1542394847,
        "LastModifiedTime": 1542395013
    }
}
```
Para obter mais informações, consulte [Aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DescribeCustomRoutingAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-accelerator.html) na *Referência de comandos da AWS CLI*. 

### `describe-custom-routing-endpoint-group`
<a name="global-accelerator_DescribeCustomRoutingEndpointGroup_cli_topic"></a>

O código de exemplo a seguir mostra como usar `describe-custom-routing-endpoint-group`.

**AWS CLI**  
**Descrever um grupo de endpoints para um acelerador de roteamento personalizado**  
O exemplo `describe-custom-routing-endpoint-group` a seguir descreve um grupo de endpoints para um acelerador de roteamento personalizado.  

```
aws globalaccelerator describe-custom-routing-endpoint-group \
    --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz/endpoint-group/ab88888example
```
Resultado:  

```
{
    "EndpointGroup": {
        "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz/endpoint-group/ab88888example",
        "EndpointGroupRegion": "us-east-2",
        "DestinationDescriptions": [
            {
                "FromPort": 5000,
                "ToPort": 10000,
                "Protocols": [
                    "UDP"
                ]
            }
        ],
        "EndpointDescriptions": [
            {
                "EndpointId": "subnet-1234567890abcdef0"
            }
        ]
    }
}
```
Para obter mais informações, consulte [Grupos de endpoints para aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DescribeCustomRoutingEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-endpoint-group.html) na *Referência de comandos da AWS CLI*. 

### `describe-custom-routing-listener`
<a name="global-accelerator_DescribeCustomRoutingListener_cli_topic"></a>

O código de exemplo a seguir mostra como usar `describe-custom-routing-listener`.

**AWS CLI**  
**Descrever um receptor para um acelerador de roteamento personalizado**  
O exemplo `describe-custom-routing-listener` a seguir descreve um receptor para um acelerador de roteamento personalizado.  

```
aws globalaccelerator describe-custom-routing-listener \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234
```
Resultado:  

```
{
    "Listener": {
        "PortRanges": [
            "FromPort": 5000,
            "ToPort": 10000
        ],
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234"
    }
}
```
Para obter mais informações, consulte [Receptores de aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DescribeCustomRoutingListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-listener.html) na *Referência de comandos da AWS CLI*. 

### `describe-endpoint-group`
<a name="global-accelerator_DescribeEndpointGroup_cli_topic"></a>

O código de exemplo a seguir mostra como usar `describe-endpoint-group`.

**AWS CLI**  
**Descrever um grupo de endpoints**  
O exemplo `describe-endpoint-group` a seguir recupera detalhes sobre um grupo de endpoints com os seguintes endpoints: uma instância do Amazon EC2, um ALB e um NLB.  

```
aws globalaccelerator describe-endpoint-group \
    --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/ab88888example
```
Resultado:  

```
{
    "EndpointGroup": {
        "TrafficDialPercentage": 100.0,
        "EndpointDescriptions": [
        {
            "Weight": 128,
            "EndpointId": "i-1234567890abcdef0"
        },
        {
            "Weight": 128,
            "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz"
        },
        {
            "Weight": 128,
            "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs"
        }
        ],
        "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/4321abcd-abcd-4321-abcd-4321abcdefg",
        "EndpointGroupRegion": "us-east-1"
    }
}
```
Para obter mais informações, consulte [Grupos de endpoints no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DescribeEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-endpoint-group.html) na *Referência de comandos da AWS CLI*. 

### `describe-listener`
<a name="global-accelerator_DescribeListener_cli_topic"></a>

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

**AWS CLI**  
**Descrever um receptor**  
O exemplo `describe-listener` a seguir descreve um receptor.  

```
aws globalaccelerator describe-listener \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234
```
Resultado:  

```
{
    "Listener": {
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234",
        "PortRanges": [
            {
                "FromPort": 80,
                "ToPort": 80
            }
        ],
        "Protocol": "TCP",
        "ClientAffinity": "NONE"
    }
}
```
Para obter mais informações, consulte [Receptores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [DescribeListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-listener.html) na *AWS CLI Referência de comando*. 

### `list-accelerators`
<a name="global-accelerator_ListAccelerators_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-accelerators`.

**AWS CLI**  
**Listar seus aceleradores**  
O exemplo `list-accelerators` a seguir lista todos os aceleradores em sua conta da AWS. Esta conta tem dois aceleradores.  

```
aws globalaccelerator list-accelerators
```
Resultado:  

```
{
    "Accelerators": [
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/5555abcd-abcd-5555-abcd-5555EXAMPLE1",
            "Name": "TestAccelerator",
            "IpAddressType": "IPV4",
            "Enabled": true,
            "IpSets": [
                {
                    "IpFamily": "IPv4",
                    "IpAddresses": [
                        "192.0.2.250",
                        "198.51.100.52"
                    ]
                }
            ],
            "DnsName": "5a5a5a5a5a5a5a5a.awsglobalaccelerator.com",
            "Status": "DEPLOYED",
            "CreatedTime": 1552424416.0,
            "LastModifiedTime": 1569375641.0
        },
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::888888888888:accelerator/8888abcd-abcd-8888-abcd-8888EXAMPLE2",
            "Name": "ExampleAccelerator",
            "IpAddressType": "IPV4",
            "Enabled": true,
            "IpSets": [
                {
                    "IpFamily": "IPv4",
                    "IpAddresses": [
                        "192.0.2.100",
                        "198.51.100.10"
                    ]
                }
            ],
            "DnsName": "6a6a6a6a6a6a6a.awsglobalaccelerator.com",
            "Status": "DEPLOYED",
            "CreatedTime": 1575585564.0,
            "LastModifiedTime": 1579809243.0
        },
    ]
}
```
Para obter mais informações, consulte [Aceleradores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ListAccelerators](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-accelerators.html) na *Referência de comandos da AWS CLI*. 

### `list-byoip-cidr`
<a name="global-accelerator_ListByoipCidr_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-byoip-cidr`.

**AWS CLI**  
**Listar seus intervalos de endereço**  
O exemplo `list-byoip-cidr` a seguir lista os intervalos de endereços do tipo use seu próprio endereço IP (BYOIP) que você forneceu para uso com o Global Accelerator.  

```
aws globalaccelerator list-byoip-cidrs
```
Resultado:  

```
{
    "ByoipCidrs": [
        {
            "Cidr": "198.51.100.0/24",
            "State": "READY"
        }
        {
            "Cidr": "203.0.113.25/24",
            "State": "READY"
        }
    ]
}
```
Para obter mais informações, consulte [Usar seu próprio endereço IP no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ListByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-byoip-cidr.html) na *Referência de comandos da AWS CLI*. 

### `list-custom-routing-accelerators`
<a name="global-accelerator_ListCustomRoutingAccelerators_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-custom-routing-accelerators`.

**AWS CLI**  
**Listar seus aceleradores de roteamento personalizados**  
O exemplo `list-custom-routing-accelerators` a seguir lista os aceleradores de roteamento personalizados em uma conta da AWS.  

```
aws globalaccelerator list-custom-routing-accelerators
```
Resultado:  

```
{
    "Accelerators": [
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/5555abcd-abcd-5555-abcd-5555EXAMPLE1",
            "Name": "TestCustomRoutingAccelerator",
            "IpAddressType": "IPV4",
            "Enabled": true,
            "IpSets": [
                {
                    "IpFamily": "IPv4",
                    "IpAddresses": [
                        "192.0.2.250",
                        "198.51.100.52"
                    ]
                }
            ],
            "DnsName": "5a5a5a5a5a5a5a5a.awsglobalaccelerator.com",
            "Status": "DEPLOYED",
            "CreatedTime": 1552424416.0,
            "LastModifiedTime": 1569375641.0
        },
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::888888888888:accelerator/8888abcd-abcd-8888-abcd-8888EXAMPLE2",
            "Name": "ExampleCustomRoutingAccelerator",
            "IpAddressType": "IPV4",
            "Enabled": true,
            "IpSets": [
                {
                    "IpFamily": "IPv4",
                    "IpAddresses": [
                        "192.0.2.100",
                        "198.51.100.10"
                    ]
                }
            ],
            "DnsName": "6a6a6a6a6a6a6a.awsglobalaccelerator.com",
            "Status": "DEPLOYED",
            "CreatedTime": 1575585564.0,
            "LastModifiedTime": 1579809243.0
        },
    ]
}
```
Para obter mais informações, consulte [Aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ListCustomRoutingAccelerators](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-accelerators.html) na *Referência de comandos da AWS CLI*. 

### `list-custom-routing-endpoint-groups`
<a name="global-accelerator_ListCustomRoutingEndpointGroups_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-custom-routing-endpoint-groups`.

**AWS CLI**  
**Listar grupos de endpoints para um receptor em um acelerador de roteamento personalizado**  
O exemplo `list-custom-routing-endpoint-groups` a seguir lista os grupos de endpoints para um receptor em um acelerador de roteamento personalizado.  

```
aws globalaccelerator list-custom-routing-endpoint-groups \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234
```
Resultado:  

```
{
    "EndpointGroups": [
        {
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234/endpoint-group/ab88888example",
            "EndpointGroupRegion": "eu-central-1",
            "DestinationDescriptions": [
                {
                    "FromPort": 80,
                    "ToPort": 80,
                    "Protocols": [
                        "TCP",
                        "UDP"
                    ]
                }
            ]
            "EndpointDescriptions": [
                {
                    "EndpointId": "subnet-abcd123example"
                }
            ]
        }
    ]
}
```
Para obter mais informações, consulte [Grupos de endpoints para aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ListCustomRoutingEndpointGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-endpoint-groups.html) na *Referência de comandos da AWS CLI*. 

### `list-custom-routing-listeners`
<a name="global-accelerator_ListCustomRoutingListeners_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-custom-routing-listeners`.

**AWS CLI**  
**Listar receptores para aceleradores de roteamento personalizados**  
O exemplo `list-custom-routing-listeners` a seguir lista os receptores para um acelerador de roteamento personalizado.  

```
aws globalaccelerator list-custom-routing-listeners \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh
```
Resultado:  

```
{
    "Listeners": [
        {
            "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234",
            "PortRanges": [
                {
                    "FromPort": 5000,
                    "ToPort": 10000
                }
            ],
            "Protocol": "TCP"
        }
    ]
}
```
Para obter mais informações, consulte [Receptores de aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ListCustomRoutingListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-listeners.html) na *Referência de comandos da AWS CLI*. 

### `list-custom-routing-port-mappings-by-destination`
<a name="global-accelerator_ListCustomRoutingPortMappingsByDestination_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-custom-routing-port-mappings-by-destination`.

**AWS CLI**  
**Para listar os mapeamentos de porta para um destino específico do acelerador de roteamento personalizado**  
O exemplo `list-custom-routing-port-mappings-by-destination` a seguir fornece mapeamentos de porta para um servidor EC2 de destino específico (no endereço de destino) para um acelerador de roteamento personalizado.  

```
aws globalaccelerator list-custom-routing-port-mappings-by-destination \
    --endpoint-id subnet-abcd123example \
    --destination-address 198.51.100.52
```
Resultado:  

```
{
    "DestinationPortMappings": [
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::402092451327:accelerator/24ea29b8-d750-4489-8919-3095f3c4b0a7",
                "AcceleratorSocketAddresses": [
                    {
                        "IpAddress": "192.0.2.250",
                        "Port": 65514
                    },
                    {
                        "IpAddress": "192.10.100.99",
                        "Port": 65514
                    }
                ],
                "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example",
                "EndpointId": "subnet-abcd123example",
                "EndpointGroupRegion": "us-west-2",
                "DestinationSocketAddress": {
                    "IpAddress": "198.51.100.52",
                    "Port": 80
                },
                "IpAddressType": "IPv4",
                "DestinationTrafficState": "ALLOW"
        }
    ]
}
```
Para obter mais informações, consulte [Como os aceleradores de roteamento personalizados funcionam no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-how-it-works.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ListCustomRoutingPortMappingsByDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-port-mappings-by-destination.html) na *Referência de comandos da AWS CLI*. 

### `list-custom-routing-port-mappings`
<a name="global-accelerator_ListCustomRoutingPortMappings_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-custom-routing-port-mappings`.

**AWS CLI**  
**Listar mapeamentos de porta em um acelerador de roteamento personalizado**  
O exemplo `list-custom-routing-port-mappings` a seguir fornece uma lista parcial de mapeamentos de portas em um acelerador de roteamento personalizado.  

```
aws globalaccelerator list-custom-routing-port-mappings \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh
```
Resultado:  

```
{
    "PortMappings": [
        {
            "AcceleratorPort": 40480,
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu",
            "EndpointId": "subnet-1234567890abcdef0",
            "DestinationSocketAddress": {
                "IpAddress": "192.0.2.250",
                "Port": 80
            },
            "Protocols": [
                "TCP",
                "UDP"
            ],
            "DestinationTrafficState": "ALLOW"
        }
        {
            "AcceleratorPort": 40481,
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu",
            "EndpointId": "subnet-1234567890abcdef0",
            "DestinationSocketAddress": {
               "IpAddress": "192.0.2.251",
              "Port": 80
            },
            "Protocols": [
                "TCP",
                "UDP"
            ],
            "DestinationTrafficState": "ALLOW"
        }
    ]
}
```
Para obter mais informações, consulte [Como os aceleradores de roteamento personalizados funcionam no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-how-it-works.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ListCustomRoutingPortMappings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-port-mappings.html) na *Referência de comandos da AWS CLI*. 

### `list-endpoint-groups`
<a name="global-accelerator_ListEndpointGroups_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-endpoint-groups`.

**AWS CLI**  
**Listar grupos de endpoints**  
O exemplo `list-endpoint-groups` a seguir lista os grupos de endpoints de um receptor. Este receptor tem dois grupos de endpoints.  

```
aws globalaccelerator --region us-west-2 list-endpoint-groups \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234
```
Resultado:  

```
{
    "EndpointGroups": [
        {
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234/endpoint-group/ab88888example",
            "EndpointGroupRegion": "eu-central-1",
            "EndpointDescriptions": [],
            "TrafficDialPercentage": 100.0,
            "HealthCheckPort": 80,
            "HealthCheckProtocol": "TCP",
            "HealthCheckIntervalSeconds": 30,
            "ThresholdCount": 3
        }
        {
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234/endpoint-group/ab99999example",
            "EndpointGroupRegion": "us-east-1",
            "EndpointDescriptions": [],
            "TrafficDialPercentage": 50.0,
            "HealthCheckPort": 80,
            "HealthCheckProtocol": "TCP",
            "HealthCheckIntervalSeconds": 30,
            "ThresholdCount": 3
        }
    ]
}
```
Para obter mais informações, consulte [Grupos de Endpoints no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ListEndpointGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-endpoint-groups.html) na *Referência de comandos da AWS CLI*. 

### `list-listeners`
<a name="global-accelerator_ListListeners_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-listeners`.

**AWS CLI**  
**Listar receptores**  
O exemplo `list-listeners` a seguir lista os receptores de um acelerador.  

```
aws globalaccelerator list-listeners \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh
```
Resultado:  

```
{
    "Listeners": [
        {
            "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234",
            "PortRanges": [
                {
                    "FromPort": 80,
                    "ToPort": 80
                }
            ],
            "Protocol": "TCP",
            "ClientAffinity": "NONE"
        }
    ]
}
```
Para obter mais informações, consulte [Receptores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ListListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-listeners.html) na *Referência de comandos da AWS CLI*. 

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

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

**AWS CLI**  
**Listar marcas para um acelerador**  
O exemplo `list-tags-for-resource` a seguir lista as marcas de um acelerador específico.  

```
aws globalaccelerator list-tags-for-resource \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh
```
Resultado:  

```
{
    "Tags": [
        {
            "Key": "Project",
            "Value": "A123456"
        }
    ]
}
```
Para obter mais informações, consulte [Marcação no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-tags-for-resource.html) na *AWS CLI Command Reference*. 

### `provision-byoip-cidr`
<a name="global-accelerator_ProvisionByoipCidr_cli_topic"></a>

O código de exemplo a seguir mostra como usar `provision-byoip-cidr`.

**AWS CLI**  
**Provisionar um intervalo de endereços**  
O exemplo `provision-byoip-cidr` a seguir fornece o intervalo de endereços específico a ser usado com seus recursos da AWS.  

```
aws globalaccelerator provision-byoip-cidr \
    --cidr 192.0.2.250/24 \
    --cidr-authorization-context Message="$text_message",Signature="$signed_message"
```
Resultado:  

```
{
    "ByoipCidr": {
        "Cidr": "192.0.2.250/24",
        "State": "PENDING_PROVISIONING"
    }
}
```
Para obter mais informações, consulte [Usar seu próprio endereço IP no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [ProvisionByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/provision-byoip-cidr.html) na *Referência de comandos da AWS CLI*. 

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

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

**AWS CLI**  
**Marcar um acelerador**  
O exemplo `tag-resource` a seguir adiciona as marcas Nome e Projeto a um acelerador, além dos valores correspondentes a cada uma.  

```
aws globalaccelerator tag-resource \
    --resource-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --tags Key="Name",Value="Example Name" Key="Project",Value="Example Project"
```
Este comando não produz saída.  
Para obter mais informações, consulte [Marcação no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/tag-resource.html) na *Referência de comandos da AWS CLI*. 

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

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

**AWS CLI**  
**Remover marca de um acelerador**  
O exemplo `untag-resource` a seguir remove as marcas Nome e Projeto de um acelerador.  

```
aws globalaccelerator untag-resource \
    --resource-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --tag-keys Key="Name" Key="Project"
```
Este comando não produz saída.  
Para obter mais informações, consulte [Marcação no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/untag-resource.html) na *Referência de comandos da AWS CLI*. 

### `update-accelerator-attributes`
<a name="global-accelerator_UpdateAcceleratorAttributes_cli_topic"></a>

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

**AWS CLI**  
**Atualizar os atributos de um acelerador**  
O exemplo `update-accelerator-attributes` a seguir atualiza um acelerador para ativar logs de fluxo. É preciso especificar a `US-West-2 (Oregon)` região para criar ou atualizar os atributos do acelerador.  

```
aws globalaccelerator update-accelerator-attributes \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --flow-logs-enabled \
    --flow-logs-s3-bucket flowlogs-abc \
    --flow-logs-s3-prefix bucketprefix-abc
```
Resultado:  

```
{
    "AcceleratorAttributes": {
        "FlowLogsEnabled": true
        "FlowLogsS3Bucket": flowlogs-abc
        "FlowLogsS3Prefix": bucketprefix-abc
    }
}
```
Para obter mais informações, consulte [Aceleradores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [UpdateAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-accelerator-attributes.html) na *Referência de comandos da AWS CLI*. 

### `update-accelerator`
<a name="global-accelerator_UpdateAccelerator_cli_topic"></a>

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

**AWS CLI**  
**Atualizar um acelerador**  
O exemplo `update-accelerator` a seguir modifica um acelerador para alterar seu nome para `ExampleAcceleratorNew`. É necessário especificar a região `US-West-2 (Oregon)` para criar ou atualizar aceleradores.  

```
aws globalaccelerator update-accelerator \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --name ExampleAcceleratorNew
```
Resultado:  

```
{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleAcceleratorNew",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1232394847,
        "LastModifiedTime": 1232395654
    }
}
```
Para obter mais informações, consulte [Aceleradores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [UpdateAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-accelerator.html) na *Referência de comandos da AWS CLI*. 

### `update-custom-routing-accelerator-attributes`
<a name="global-accelerator_UpdateCustomRoutingAcceleratorAttributes_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-custom-routing-accelerator-attributes`.

**AWS CLI**  
**Atualizar os atributos de um acelerador de roteamento personalizado**  
O exemplo `update-custom-routing-accelerator-attributes` a seguir atualiza um acelerador de roteamento personalizado para habilitar logs de fluxo.  

```
aws globalaccelerator update-custom-routing-accelerator-attributes \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --flow-logs-enabled \
    --flow-logs-s3-bucket flowlogs-abc \
    --flow-logs-s3-prefix bucketprefix-abc
```
Resultado:  

```
{
    "AcceleratorAttributes": {
        "FlowLogsEnabled": true
        "FlowLogsS3Bucket": flowlogs-abc
        "FlowLogsS3Prefix": bucketprefix-abc
    }
}
```
Para obter mais informações, consulte [Aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [UpdateCustomRoutingAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-accelerator-attributes.html) na *Referência de comandos da AWS CLI*. 

### `update-custom-routing-accelerator`
<a name="global-accelerator_UpdateCustomRoutingAccelerator_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-custom-routing-accelerator`.

**AWS CLI**  
**Atualizar um acelerador de roteamento personalizado**  
O exemplo `update-custom-routing-accelerator` a seguir modifica um acelerador de roteamento personalizado para alterar seu nome.  

```
aws globalaccelerator --region us-west-2 update-custom-routing-accelerator \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --name ExampleCustomRoutingAcceleratorNew
```
Resultado:  

```
{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleCustomRoutingAcceleratorNew",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1232394847,
        "LastModifiedTime": 1232395654
    }
}
```
Para obter mais informações, consulte [Aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [UpdateCustomRoutingAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-accelerator.html) na *Referência de comandos da AWS CLI*. 

### `update-custom-routing-listener`
<a name="global-accelerator_UpdateCustomRoutingListener_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-custom-routing-listener`.

**AWS CLI**  
**Atualizar um receptor para um acelerador de roteamento personalizado**  
O exemplo `update-custom-routing-listener` a seguir atualiza um receptor para alterar o intervalo de portas.  

```
aws globalaccelerator update-custom-routing-listener \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \
    --port-ranges FromPort=10000,ToPort=20000
```
Resultado:  

```
{
    "Listener": {
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz
        "PortRanges": [
            {
                "FromPort": 10000,
                "ToPort": 20000
            }
        ],
        "Protocol": "TCP"
    }
}
```
Para obter mais informações, consulte [Receptores de aceleradores de roteamento personalizados no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [UpdateCustomRoutingListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-listener.html) na *Referência de comandos da AWS CLI*. 

### `update-endpoint-group`
<a name="global-accelerator_UpdateEndpointGroup_cli_topic"></a>

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

**AWS CLI**  
**Atualizar um grupo de endpoints**  
O exemplo `update-endpoint-group` a seguir adiciona três endpoints a um grupo de endpoints: um endereço IP elástico, um ALB e um NLB.  

```
aws globalaccelerator update-endpoint-group \
    --endpoint-group-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/ab88888example \
    --endpoint-configurations \
        EndpointId=eipalloc-eip01234567890abc,Weight=128 \
        EndpointId=arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz,Weight=128 \
        EndpointId=arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs,Weight=128
```
Resultado:  

```
{
    "EndpointGroup": {
        "TrafficDialPercentage": 100,
        "EndpointDescriptions": [
            {
                "Weight": 128,
                "EndpointId": "eip01234567890abc"
            },
            {
                "Weight": 128,
                "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz"
            },
            {
                "Weight": 128,
                "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs"
            }
        ],
        "EndpointGroupArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/4321abcd-abcd-4321-abcd-4321abcdefg",
        "EndpointGroupRegion": "us-east-1"
    }
}
```
Para obter mais informações, consulte [Grupos de endpoints no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [UpdateEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-endpoint-group.html) na *Referência de comandos da AWS CLI*. 

### `update-listener`
<a name="global-accelerator_UpdateListener_cli_topic"></a>

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

**AWS CLI**  
**Atualizar um receptor**  
O exemplo `update-listener` a seguir atualiza um receptor para alterar a porta para 100.  

```
aws globalaccelerator update-listener \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \
    --port-ranges FromPort=100,ToPort=100
```
Resultado:  

```
{
    "Listener": {
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz
        "PortRanges": [
            {
                "FromPort": 100,
                "ToPort": 100
            }
        ],
        "Protocol": "TCP",
        "ClientAffinity": "NONE"
    }
}
```
Para obter mais informações, consulte [Receptores no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [UpdateListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-listener.html) na *Referência de comandos da AWS CLI*. 

### `withdraw-byoip-cidr`
<a name="global-accelerator_WithdrawByoipCidr_cli_topic"></a>

O código de exemplo a seguir mostra como usar `withdraw-byoip-cidr`.

**AWS CLI**  
**Para remover um intervalo de endereços**  
O exemplo `withdraw-byoip-cidr` a seguir remove do AWS Global Accelerator um intervalo de endereços que você divulgou anteriormente para ser usado com seus recursos da AWS.  

```
aws globalaccelerator withdraw-byoip-cidr \
    --cidr 192.0.2.250/24
```
Resultado:  

```
{
    "ByoipCidr": {
        "Cidr": "192.0.2.250/24",
        "State": "PENDING_WITHDRAWING"
    }
}
```
Para obter mais informações, consulte [Usar seu próprio endereço IP no AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) no *Guia do Desenvolvedor do AWS Global Accelerator*.  
+  Para ver detalhes da API, consulte [WithdrawByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/withdraw-byoip-cidr.html) na *Referência de comandos da AWS CLI*.