Utilizzo degli endpoint dual-stack Amazon ECS - Amazon Elastic Container Service
Utilizzo degli endpoint dual-stack (AWS CLI)Utilizzo degli endpoint dual-stack (SDK AWS)Utilizzo degli endpoint dual-stack dall'API REST

Utilizzo degli endpoint dual-stack Amazon ECS

Gli endpoint dual-stack Amazon ECS supportano le richieste ad Amazon ECS tramite Protocollo Internet versione 4 (IPv4) e Protocollo Internet versione 6 (IPv6). Per un elenco degli endpoint Amazon ECS, consulta Endpoint e quote Amazon ECS in Riferimenti generali di AWS.

Quando utilizzi la REST API puoi accedere direttamente a un endpoint Amazon ECS utilizzando il nome dell'endpoint (URI). Amazon ECS supporta solo i nomi di endpoint dual-stack regionali, il che significa che è necessario specificare la regione come parte del nome.

I nomi degli endpoint dual-stack usano la seguente convenzione di denominazione: ecs.region.api.aws.

Quando utilizzi AWS Command Line Interface (AWS CLI) e gli SDK di AWS puoi servirti di un parametro o flag per passare a un endpoint dual-stack. Puoi anche specificare l'endpoint dual-stack direttamente come sostituzione dell'endpoint Amazon ECS nel file di configurazione.

Nelle seguenti sezioni viene descritto come utilizzare gli endpoint dual-stack dalla AWS CLI, gli SDK AWS e la REST API.

Utilizzo degli endpoint dual-stack dalla AWS CLI

In questa sezione vengono forniti esempi dei comandi dell'AWS CLI utilizzati per effettuare le richieste a un endpoint dual-stack. Per informazioni sull'installazione della AWS CLI o sull’aggiornamento alla versione più recente, consulta Installazione o aggiornamento della versione più recente della AWS CLI nella Guida per l'utente AWS Command Line Interface per la versione 2.

Per utilizzare un endpoint dual-stack puoi impostare il valore di configurazione use_dualstack_endpoint su true nel file config per la AWS CLI per indirizzare tutte le richieste Amazon ECS effettuate dal comando ecs della AWS CLI all'endpoint dual-stack per la regione specificata. La regione va specificata nel file config o in un comando tramite l'opzione --region. Per ulteriori informazioni sui file di configurazione per la AWS CLI, consulta Configurazione e impostazioni dei file credenziali nella AWS CLI nella Guida per l'utente AWS Command Line Interface per la versione 2.

Se desideri utilizzare l'endpoint dual-stack solo per comandi specifici della AWS CLI, puoi servirti di uno dei seguenti metodi:

  • Puoi utilizzare l'endpoint dual-stack per comando, impostando il parametro --endpoint-url su https://ecs.aws-region.api.aws o http://ecs.aws-region.api.aws per qualsiasi comando ecs.

    Il comando di esempio seguente elenca tutti i cluster disponibili e utilizza l'endpoint dual-stack per la richiesta.

    $ aws ecs list-clusters --endpoint-url https://ecs.aws-region.api.aws

  • È possibile impostare profili separati nel file AWS Config. Ad esempio, si può creare un profilo che imposta use_dualstack_endpoint su true e un profilo che non imposta use_dualstack_endpoint. Quando si esegue un comando, specificare il profilo da usare, a seconda se si desidera o meno utilizzare l'endpoint dual-stack.

Utilizzo degli endpoint dual-stack dagli SDK AWS

In questa sezione vengono forniti esempi su come accedere all'endpoint dual-stack tramite gli SDK AWS.

AWS SDK for Java 2.x

Gli esempi seguenti mostrano come specificare un endpoint per la Regione us-east-1utilizzando AWS SDK for Java 2.x.

Region region = Region.US_EAST_1
EcsClient client = EcsClient.builder().region(region).dualstackEnabled(true).build();
AWS SDK per Go

Gli esempi seguenti mostrano come specificare un endpoint per la Regione us-east-1 utilizzando AWS SDK per 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")
})

Per ulteriori informazioni, consulta Endpoint dual-stack e FIPS nella Guida AWS su SDKs e strumenti.

Utilizzo degli endpoint dual-stack dall'API REST

Quando utilizzi la REST API puoi accedere direttamente a un endpoint dual-stack specificandolo nella richiesta. L'esempio seguente utilizza l'endpoint dual-stack per elencare tutti i cluster Amazon ECS nella regione 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

{}