View a markdown version of this page

Utilisation des points de terminaison à double pile Amazon ECS - Amazon Elastic Container Service
Utilisation des points de terminaison Dual-Stack (AWS CLI)Utilisation de points de terminaison à double pile (SDK)AWS Utilisation de points de terminaison Dual-Stack avec l'API REST

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation des points de terminaison à double pile Amazon ECS

Les points de terminaison à double pile Amazon ECS prennent en charge les requêtes adressées à Amazon ECS via IPv4 (Internet Protocol version 4) et IPv6 (Internet Protocol version 6). Pour obtenir la liste des points de terminaison Amazon ECS, consultez la section Points de terminaison et quotas Amazon ECS dans le Références générales AWS.

Lorsque vous utilisez l’API REST, vous accédez directement à un point de terminaison Amazon ECS à l’aide du nom de point de terminaison (URI). Amazon ECS ne prend en charge que les noms de points de terminaison à double pile régionaux ; vous devez donc spécifier la région dans le nom.

Utilisez la convention de nommage suivante pour les noms des points de terminaison à double pile : ecs.region.api.aws.

Lorsque vous utilisez le AWS Command Line Interface (AWS CLI) et AWS les SDK, vous pouvez utiliser un paramètre ou un indicateur pour passer à un point de terminaison à double pile. Vous pouvez également spécifier directement le point de terminaison à double pile en remplaçant le point de terminaison Amazon ECS dans le fichier de configuration.

Les sections suivantes décrivent comment utiliser les points de terminaison à double pile à partir de l'API AWS CLI AWS REST, des SDK et de l'API.

À l'aide de points de terminaison à double pile provenant du AWS CLI

Cette section fournit des exemples de AWS CLI commandes utilisées pour envoyer des requêtes à un point de terminaison à double pile. Pour plus d'informations sur l'installation AWS CLI ou la mise à jour vers la dernière version, consultez la section Installation ou mise à jour vers la AWS CLI dernière version du Guide de l'AWS Command Line Interface utilisateur de la version 2.

Pour utiliser un point de terminaison à double pile, vous pouvez définir la valeur use_dualstack_endpoint de configuration sur true dans le config fichier AWS CLI afin de diriger toutes les requêtes Amazon ECS effectuées par la ecs AWS CLI commande vers le point de terminaison à double pile pour la région spécifiée. Vous indiquez la Région dans le fichier config ou dans une commande à l’aide de l’option --region. Pour plus d'informations sur les fichiers de configuration pour le AWS CLI, consultez la section Paramètres des fichiers de configuration et d'identification AWS CLI dans le Guide de l'AWS Command Line Interface utilisateur de la version 2.

Si vous souhaitez utiliser un point de terminaison à double pile pour des AWS CLI commandes spécifiques, vous pouvez utiliser l'une des méthodes suivantes :

  • Vous pouvez utiliser le point de terminaison à double pile par commande en définissant le paramètre --endpoint-url sur https://ecs.aws-region.api.aws ou sur http://ecs.aws-region.api.aws pour toute commande ecs.

    L’exemple de commande suivant répertorie tous les clusters disponibles et utilise le point de terminaison à double pile pour la requête.

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

  • Vous pouvez créer des profils distincts dans votre AWS Config dossier. Par exemple, vous pouvez créer un profil qui définit use_dualstack_endpoint sur true et un profil qui ne définit pas use_dualstack_endpoint. Lorsque vous exécutez une commande, spécifiez le profil adéquat selon que vous comptez utiliser ou non le point de terminaison Dual-Stack.

À l'aide de points de terminaison à double pile provenant du AWS Kits SDK

Cette section fournit des exemples d'accès à un point de terminaison à double pile à l'aide des kits de AWS développement logiciel (SDK).

AWS SDK for Java 2.x

L’exemple suivant montre comment spécifier un point de terminaison à double pile pour la région us-east-1 à l’aide de AWS SDK for Java 2.x.

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

L’exemple suivant montre comment spécifier un point de terminaison à double pile pour la région us-east-1 à l’aide de AWS SDK pour 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")
})

Pour plus d'informations, consultez la section relative Dual-stack aux points de terminaison FIPS dans le Guide de référence des AWS kits de développement logiciel et des outils.

Utilisation de points de terminaison Dual-Stack avec l'API REST

Lorsque vous utilisez l’API REST, vous pouvez accéder directement à un point de terminaison à double pile si vous le spécifiez dans votre requête. L’exemple suivant utilise le point de terminaison à double pile pour répertorier tous les clusters Amazon ECS de la région 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

{}