Verwenden von Dual-Stack-Endpunkten in Amazon ECS - Amazon Elastic Container Service
Verwenden von Dual-Stack-Endpunkten (AWS CLI)Verwenden von Dual-Stack-Endpunkten (AWS SDKs)Verwenden von Dual-Stack-Endpunkte von der REST-API

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden von Dual-Stack-Endpunkten in Amazon ECS

Amazon ECS-Dual-Stack-Endpunkte unterstützen Anfragen an Amazon ECS über Internet Protocol Version 4 (IPv4) und Internet Protocol Version 6 (IPv6). Eine Liste aller Amazon-ECS-Endpunkte finden Sie unter Amazon-ECS-Endpunkte und -Kontingente in der Allgemeine AWS-Referenz.

Wenn Sie die REST-API verwenden, können Sie direkt auf einen Amazon-ECS-Endpunkt zugreifen, indem Sie den Endpunktnamen (URI) verwenden. Amazon ECS unterstützt nur regionale Dual-Stack-Endpunktnamen, d. h. Sie müssen die Region als Teil des Namens angeben.

Verwenden Sie die folgende Namenskonvention für die Dual-Stack-Endpunktnamen: ecs.region.api.aws.

Wenn Sie AWS Command Line Interface (AWS CLI) und verwenden AWS SDKs, können Sie einen Parameter oder ein Flag verwenden, um zu einem Dual-Stack-Endpunkt zu wechseln. Sie können den Dual-Stack-Endpunkt auch direkt als Überschreibung des Amazon-ECS-Endpunkts in der Konfigurationsdatei angeben.

In den folgenden Abschnitten wird beschrieben, wie Dual-Stack-Endpunkte aus der AWS CLI AWS SDKs, und der REST-API verwendet werden.

Verwenden von Dual-Stack-Endpunkten von der AWS CLI

Dieser Abschnitt enthält Beispiele für AWS CLI Befehle, die verwendet werden, um Anfragen an einen Dual-Stack-Endpunkt zu stellen. Weitere Informationen zur Installation AWS CLI oder Aktualisierung auf die neueste Version finden Sie unter Installation oder Aktualisierung auf die neueste Version von AWS CLI im AWS Command Line Interface Benutzerhandbuch für Version 2.

Um einen Dual-Stack-Endpunkt zu verwenden, können Sie den Konfigurationswert true in der config Datei use_dualstack_endpoint auf festlegen, AWS CLI damit alle Amazon ECS-Anfragen, die vom ecs AWS CLI Befehl gestellt werden, an den Dual-Stack-Endpunkt für die angegebene Region weitergeleitet werden. Sie geben die Region in der config-Datei oder in einem Befehl mit der Option --region an. Weitere Informationen zu den Konfigurationsdateien für finden Sie unter Einstellungen für die AWS CLI Konfiguration und die Anmeldeinformationsdatei AWS CLI im AWS Command Line Interface Benutzerhandbuch für Version 2.

Wenn Sie einen Dual-Stack-Endpunkt für bestimmte AWS CLI Befehle verwenden möchten, können Sie eine der folgenden Methoden verwenden:

  • Sie können den Dual-Stack-Endpunkt pro Befehl verwenden, indem Sie für einen beliebigen ecs-Befehl den Parameter --endpoint-url auf https://ecs.aws-region.api.aws oder http://ecs.aws-region.api.aws setzen.

    Der folgende Beispielbefehl listet alle verfügbaren Cluster auf und verwendet den Dual-Stack-Endpunkt für die Anfrage.

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

  • Sie können separate Profile in Ihrer AWS Config Datei einrichten. Legen Sie beispielsweise ein Profil an, das use_dualstack_endpoint auf true setzt, und ein Profil, das use_dualstack_endpoint nicht setzt. Wenn Sie einen Befehl ausführen, geben Sie an, welches Profil Sie verwenden wollen, abhängig davon, ob Sie den Dual-Stack-Endpunkt verwenden wollen oder nicht.

Verwenden von Dual-Stack-Endpunkten aus dem AWS SDKs

Dieser Abschnitt enthält Beispiele für den Zugriff auf einen Dual-Stack-Endpunkt mithilfe von. AWS SDKs

AWS SDK for Java 2.x

Das folgenden Beispiel zeigt, wie Sie einen Dual-Stack-Endpunkt für die Region us-east-1 mithilfe der AWS SDK for Java 2.x angeben.

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

Das folgenden Beispiel zeigt, wie Sie einen Dual-Stack-Endpunkt für die Region us-east-1 mithilfe der AWS SDK für Go angeben.

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")
})

Weitere Informationen finden Sie unter Dual-Stack- und FIPS-Endpunkte im Referenzhandbuch AWS SDKs und im Tools-Referenzhandbuch.

Verwenden von Dual-Stack-Endpunkte von der REST-API

Wenn Sie die REST-API verwenden, können Sie direkt auf einen Dual-Stack-Endpunkt zugreifen, indem Sie ihn in Ihrer Anfrage angeben. Das folgende Beispiel verwendet den Dual-Stack-Endpunkt, um alle Amazon-ECS-Cluster in der Region us-east-1 aufzulisten.

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

{}