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

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

使用 Amazon ECS 雙堆疊端點

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

使用 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 或更新至最新版本的詳細資訊，請參閱《 第 2 版使用者指南》中的安裝或更新至最新版本 AWS CLI的 。 AWS Command Line Interface

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

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

  • 您可以將任何 ecs 命令的 --endpoint-url 參數設定為 https://ecs.aws-region.api.aws 或 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

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

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

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

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 and Tools Reference Guide 中的 Dual-stack and FIPS endpoints。

從 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

{}