Utilisation des points de terminaison à double pile Amazon ECS - Amazon Elastic Container Service
Utilisation des points de terminaison Dual-Stack (AWS CLI)Utilisation des points de terminaison Dual-Stack (AWS SDKs)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 demandes adressées à Amazon ECS via le protocole Internet version 4 (IPv4) et le protocole Internet version 6 (IPv6). Pour obtenir la liste de tous les 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 en utilisant le nom du point de terminaison (URI). Amazon ECS prend uniquement en charge les noms de point de terminaison régionaux à double pile, ce qui signifie que vous devez spécifier la région dans le nom.

Utilisez la convention de dénomination suivante pour les noms de point de terminaison à double pile :ecs.region.api.aws.

Lorsque vous utilisez le AWS Command Line Interface (AWS CLI) et AWS SDKs, vous pouvez utiliser un paramètre ou un indicateur pour passer à un point de terminaison à double pile. Vous pouvez également spécifier le point de terminaison à double pile directement en remplacement du 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, de AWS CLI AWS SDKs, et de l'API REST.

Utilisation de points de terminaison Dual-Stack avec l AWS CLI

Cette section fournit des exemples de AWS CLI commandes utilisées pour envoyer des demandes à un point de terminaison à double pile. Pour plus d'informations sur l'installation AWS CLI ou la mise à jour vers la dernière version, voir Installation ou mise à jour vers la dernière version du AWS CLI 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 demandes 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 pouvez spécifier la région dans le config fichier ou dans une commande à l'aide de l'--regionoption. 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 --endpoint-url paramètre sur https://ecs.aws-region.api.aws ou http://ecs.aws-region.api.aws pour n'importe quelle ecs commande.

    L'exemple de commande suivant répertorie tous les clusters disponibles et utilise le point de terminaison à double pile pour la demande.

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

  • Vous pouvez configurer des profils distincts dans votre AWS Config fichier. 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.

En utilisant des points de terminaison à double pile à partir du AWS SDKs

Cette section fournit des exemples d'accès à un point de terminaison à double pile à l'aide du AWS SDKs.

AWS SDK for Java 2.x

L'exemple suivant montre comment spécifier un point de terminaison à double pile pour la us-east-1 région à l'aide du 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 us-east-1 région à l'aide du 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 Points de terminaison à double pile et FIPS dans le guide de référence AWS SDKs et Tools.

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 en le spécifiant dans votre demande. L'exemple suivant utilise le point de terminaison à double pile pour répertorier tous les clusters Amazon ECS de la us-east-1 région.

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

{}