Uso de puntos de conexión de doble pila en Amazon ECS - Amazon Elastic Container Service
Usar puntos de enlace de doble pila (AWS CLI)Uso de los puntos de enlace de doble pila (SDK de AWS)Usar los puntos de enlace de doble pila desde la API REST

Uso de puntos de conexión de doble pila en Amazon ECS

Los puntos de conexión de doble pila de Amazon ECS admiten solicitudes a Amazon ECS a través del Protocolo de Internet versión 4 (IPv4) y el Protocolo de Internet versión 6 (IPv6). Para obtener una lista de todos los puntos de conexión de Amazon ECS, consulte Puntos de conexión y cuotas de Amazon ECS en la Referencia general de AWS.

Cuando se utiliza la API de REST, accede directamente a un punto de conexión de Amazon ECS mediante el nombre del punto de conexión (URI). Amazon ECS solo es compatible con nombres de puntos de conexión de doble pila regionales, lo que implica que debe especificar la región como parte del nombre.

Utilice la siguiente convención de nomenclatura para los nombres de puntos de conexión de doble pila: ecs.region.api.aws.

Al usar AWS Command Line Interface (AWS CLI) y los SDK de AWS, puede utilizar un parámetro o una marca para cambiar a un punto de conexión de doble pila. También puede especificar el punto de conexión de doble pila directamente como una anulación del punto de conexión de Amazon ECS en el archivo de configuración.

En las secciones siguientes, se describe cómo utilizar los puntos de conexión de doble pila desde la AWS CLI, los SDK de AWS y la API de REST.

Usar puntos de enlace de doble pila desde la AWS CLI

Esta sección proporciona ejemplos de comandos de la AWS CLI. que se usan para realizar solicitudes a un punto de conexión de doble pila. Para obtener más información acerca de cómo instalar la AWS CLI o actualizarla a la versión más reciente, consulte Instalación o actualización de la versión más reciente de la AWS CLI en la Guía del usuario de la versión 2 de la AWS Command Line Interface.

Para utilizar un punto de conexión de doble pila, puede establecer el valor de configuración use_dualstack_endpoint en true en su archivo de config para la AWS CLI a fin de dirigir todas las solicitudes de Amazon ECS que realicen los comandos ecs y AWS CLI de al punto de conexión de doble pila para la región especificada. Puede especificar la región en el archivo config o en un comando mediante la opción --region. Para obtener más información sobre los archivos de configuración de la AWS CLI, consulte Configuración de archivos de configuración y credenciales en la AWS CLI en la Guía del usuario de la versión 2 de la AWS Command Line Interface.

También puede utilizar un comando para actualizar la configuración. El siguiente comando actualiza use_dualstack_endpoint a true en el perfil predeterminado.

$ aws configure set default.ecs.use_dualstack_endpoint true

Si quiere utilizar un punto de conexión de doble pila para comandos de la AWS CLI específicos, puede usar uno de los métodos siguientes:

  • Puede utilizar el punto de conexión de doble pila por cada comando si configura el parámetro --endpoint-url como https://ecs.aws-region.api.aws o http://ecs.aws-region.api.aws para cualquier comando de ecs.

    El siguiente comando de ejemplo enumera todos los clústeres disponibles y utiliza el punto de conexión de doble pila para la solicitud.

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

  • Puede configurar perfiles separados en su archivo de AWS Config. Por ejemplo, puede crear un perfil que configure use_dualstack_endpoint como true y un perfil que no configure use_dualstack_endpoint. Al ejecutar un comando, especifique qué perfil quiere usar, en función de si quiere usar el punto de conexión de doble pila o no.

Uso de los puntos de enlace de doble pila de los SDK de AWS

En esta sección, se proporcionan ejemplos de cómo obtener acceso a un punto de enlace de doble pila con los SDK de AWS.

AWS SDK for Java 2.x

En los siguientes ejemplos, se muestra cómo especificar un punto de conexión para la región us-east-1 mediante 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

En los siguientes ejemplos, se muestra cómo especificar un punto de conexión para la región us-east-1 mediante 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 obtener más información, consulte Puntos de conexión de doble pila y FIPS en la Guía de referencia de AWS SDK y las herramientas.

Usar los puntos de enlace de doble pila desde la API REST

Cuando utiliza la API de REST, puede acceder directamente a un punto de conexión de doble pila si lo especifica en su solicitud. El siguiente ejemplo utiliza el punto de conexión de doble pila para enumerar todos los clústeres de Amazon ECS en la región 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

{}