# Usar endpoints de pilha dupla do Amazon ECS
Os endpoints de pilha dupla do Amazon ECS oferecem suporte a solicitações ao Amazon ECS usando o Internet Protocol versão 4 (IPv4) e o Internet Protocol versão 6 (IPv6). Para obter uma lista dos endpoints do Amazon ECS, consulte [Endpoints e cotas do Amazon ECS](https://docs.aws.amazon.com/general/latest/gr/ecs-service.html) na Referência geral da AWS.
Ao usar a API REST, você acessa diretamente um endpoint do Amazon ECS usando o nome do endpoint (URI). O Amazon ECS oferece suporte apenas a nomes de endpoint de pilha dupla regionais, o que significa que é necessário especificar a região como parte do nome.
Use a seguinte convenção de nomenclatura para os nomes de endpoint de pilha dupla: `ecs.region.api.aws`.
Ao usar a AWS Command Line Interface (AWS CLI) e os AWS SDKs, é possível utilizar um parâmetro ou um sinalizador para mudar para um endpoint de pilha dupla. Também é possível especificar o endpoint de pilha dupla diretamente como uma substituição do endpoint do Amazon ECS no arquivo de configuração.
As seções a seguir descrevem como usar endpoints de pilha dupla via AWS CLI, AWS SDKs e API REST.
**Topics**
+ [Usar endpoints de pilha dupla da AWS CLI](#dual-stack-endpoints-cli)
+ [Usar endpoints de pilha dupla dos AWS SDKs](#dual-stack-endpoints-sdks)
+ [Usar endpoints de pilha dupla da API REST](#dual-stack-endpoints-examples-rest-api)
## Usar endpoints de pilha dupla da AWS CLI
Esta seção fornece exemplos de comandos da AWS CLI usados para fazer solicitações a um endpoint de pilha dupla. Para obter mais informações sobre como instalar a AWS CLI ou atualizá-la para a versão mais recente, consulte [Instalar ou atualizar para a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da versão 2 da AWS Command Line Interface*.
Para usar um endpoint de pilha dupla, é possível definir o valor da configuração `use_dualstack_endpoint` como `true` no arquivo `config` para que a AWS CLI direcione todas as solicitações ao Amazon ECS feitas ao comando `ecs` da AWS CLI para o endpoint de pilha dupla da região especificada. É possível especificar a região no arquivo `config` ou em um comando usando a opção `--region`. Para obter mais informações sobre os arquivos de configuração do AWS CLI, consulte [Opções do arquivo de configuração e credenciais na AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) no *Guia do usuário da versão 2 da AWS Command Line Interface*.
Se desejar usar um endpoint de pilha dupla para comandos especificados da AWS CLI, você poderá usar qualquer um dos seguintes métodos:
+ Usar o endpoint de pilha dupla por comando, definindo o parâmetro `--endpoint-url` como `https://ecs.aws-region.api.aws` ou `http://ecs.aws-region.api.aws` para qualquer comando do `ecs`.
O comando de exemplo a seguir lista todos os clusters disponíveis e usa o endpoint de pilha dupla para a solicitação.
```
$ aws ecs list-clusters --endpoint-url https://ecs.aws-region.api.aws
```
+ Configurar perfis separados em seu arquivo do AWS Config. Por exemplo, crie um perfil que defina `use_dualstack_endpoint` como `true` e um perfil que não defina `use_dualstack_endpoint`. Quando executar um comando, especifique qual perfil deseja usar, dependendo de querer ou não usar o endpoint de pilha dupla.
## Usar endpoints de pilha dupla dos AWS SDKs
Esta seção fornece exemplos de como acessar um endpoint de pilha dupla usando os AWS SDKs.
------
#### [ AWS SDK for Java 2.x ]
O exemplo a seguir mostra como especificar um endpoint de pilha dupla para a região `us-east-1` usando AWS SDK for Java 2.x.
```
Region region = Region.US_EAST_1
EcsClient client = EcsClient.builder().region(region).dualstackEnabled(true).build();
```
------
#### [ AWS SDK para Go ]
O exemplo a seguir mostra como especificar um endpoint de pilha dupla para a região `us-east-1` usando AWS SDK para Go.
```
sess := session.Must(session.NewSession())
svc := ecs.New(sess, &aws.Config{
Region: aws.String(endpoints.UsEast1RegionID),
Endpoint: aws.String("https://ecs.us-east-1.api.aws")
})
```
------
Para obter mais informações, consulte [Endpoints de pilha dupla e FIPS](https://docs.aws.amazon.com/sdkref/latest/guide/feature-endpoints.html) no *Guia de referência de ferramentas e SDKs da AWS*.
## Usar endpoints de pilha dupla da API REST
Ao usar a API REST, você pode acessar diretamente um endpoint de pilha dupla especificando-o em sua solicitação. O exemplo a seguir usa o endpoint de pilha dupla para listar todos os clusters do Amazon ECS na região `us-east-1`.
```
POST / HTTP/1.1
Host: ecs.us-east-1.api.aws
Accept-Encoding: identity
Content-Length: 2
X-Amz-Target: AmazonEC2ContainerServiceV20141113.ListClusters
X-Amz-Date: 20150429T170621Z
Content-Type: application/x-amz-json-1.1
Authorization: AUTHPARAMS
{}
```