Usar endpoints de pilha dupla do Amazon ECS - Amazon Elastic Container Service
Usar endpoints de pilha dupla (AWS CLI)Usar endpoints de pilha dupla (AWS SDKs)Usar endpoints de pilha dupla da API REST

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

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

{}