

# Uso de puntos de conexión de doble pila en Amazon ECS
<a name="dual-stack-endpoint"></a>

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](https://docs.aws.amazon.com/general/latest/gr/ecs-service.html) 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.

**Topics**
+ [Usar puntos de enlace de doble pila desde la AWS CLI](#dual-stack-endpoints-cli)
+ [Uso de los puntos de enlace de doble pila de los SDK de AWS](#dual-stack-endpoints-sdks)
+ [Usar los puntos de enlace de doble pila desde la API REST](#dual-stack-endpoints-examples-rest-api)

## Usar puntos de enlace de doble pila desde la AWS CLI
<a name="dual-stack-endpoints-cli"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) en la *Guía del usuario de la versión 2 de la AWS Command Line Interface*.

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
<a name="dual-stack-endpoints-sdks"></a>

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](https://docs.aws.amazon.com/sdkref/latest/guide/feature-endpoints.html) en la *Guía de referencia de AWS SDK y las herramientas*.

## Usar los puntos de enlace de doble pila desde la API REST
<a name="dual-stack-endpoints-examples-rest-api"></a>

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

{}
```