使用 Amazon ECS 雙堆疊端點 - Amazon Elastic Container Service
使用雙堆疊端點 (AWS CLI)使用雙堆疊端點AWS SDKs)從 REST API 使用雙堆疊端點

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Amazon ECS 雙堆疊端點

Amazon ECS 雙堆疊端點支援透過網際網路通訊協定第 4 版 (IPv4) 和網際網路通訊協定第 6 版 (IPv6) 向 Amazon ECS 提出請求。如需所有 Amazon ECS 端點的清單，請參閱《》中的 Amazon ECS 端點和配額 AWS 一般參考。

使用 REST API 時，您可以使用端點名稱 (URI) 直接存取 Amazon ECS 端點。Amazon ECS 僅支援區域雙堆疊端點名稱，這表示您必須指定區域做為名稱的一部分。

針對雙堆疊端點名稱使用下列命名慣例：ecs.region.api.aws。

使用 AWS Command Line Interface (AWS CLI) 和 AWS SDKs時，您可以使用參數或旗標來變更為雙堆疊端點。您也可以直接將雙堆疊端點指定為組態檔案中 Amazon ECS 端點的覆寫。

下列各節說明如何使用來自 AWS CLI、 AWS SDKs和 REST API 的雙堆疊端點。

從 AWS CLI使用雙堆疊端點

本節提供用於向雙堆疊端點提出請求的 AWS CLI 命令範例。如需安裝 AWS CLI 或更新至最新版本的詳細資訊，請參閱《 第 AWS Command Line Interface 2 版使用者指南》中的安裝或更新至最新版本 AWS CLI的 。

若要使用雙堆疊端點，您可以將 config use_dualstack_endpointtrue檔案中的組態值設定為 AWS CLI ，讓 將ecs AWS CLI 命令提出的所有 Amazon ECS 請求導向指定區域的雙堆疊端點。您可以使用 --region選項，在 config 檔案或命令中指定區域。如需 組態檔案的詳細資訊 AWS CLI，請參閱《 第 2 版使用者指南》中的組態和登入資料檔案設定 AWS CLI。 AWS Command Line Interface

如果您想要針對特定 AWS CLI 命令使用雙堆疊端點，您可以使用下列其中一種方法：

  • 您可以針對任何命令將 --endpoint-url 參數設定為 https://ecs.aws-region.api.aws或 ，以使用每個ecs命令http://ecs.aws-region.api.aws的雙堆疊端點。

    下列範例命令會列出所有可用的叢集，並使用請求的雙堆疊端點。

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

  • 您可以在 AWS Config 檔案中設定個別的設定檔。例如，您可以建立一個設定檔，將 use_dualstack_endpoint 設為 true，再建立另一個設定檔不設定 use_dualstack_endpoint。當您執行命令時，必須依據是否要使用雙堆疊端點來指定所要使用的設定檔。

從 AWS 開發套件使用雙堆疊端點

本節提供如何使用 AWS SDKs 存取雙堆疊端點的範例。

AWS SDK for Java 2.x

下列範例顯示如何使用 為 us-east-1區域指定雙堆疊端點 AWS SDK for Java 2.x。

Region region = Region.US_EAST_1
EcsClient client = EcsClient.builder().region(region).dualstackEnabled(true).build();
適用於 Go 的 AWS SDK

下列範例示範如何使用 為 us-east-1區域指定雙堆疊端點 適用於 Go 的 AWS SDK。

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

如需詳細資訊，請參閱 AWS SDKs 和工具參考指南中的雙堆疊和 FIPS 端點。

從 REST API 使用雙堆疊端點

使用 REST API 時，您可以在請求中指定雙堆疊端點，以直接存取該端點。下列範例使用雙堆疊端點列出 us-east-1區域中的所有 Amazon ECS 叢集。

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

{}