Amazon ECS 任務中繼資料端點版本 3

重要

不再積極維護任務中繼資料第 3 版端點。建議您更新任務中繼資料第 4 版端點，以取得最新的中繼資料端點資訊。如需詳細資訊，請參閱 Amazon ECS 任務中繼資料端點版本 4。

如果您使用託管於 AWS Fargate上的 Amazon ECS 任務 AWS Fargate，請參閱 Amazon 彈性容器服務使用者指南中的任務中繼資料端點版本 3。

從 Amazon ECS 容器代理程式 1.21.0 版開始，代理程式會將稱為 ECS_CONTAINER_METADATA_URI 的環境變數插入任務中的每個容器。當您查詢任務中繼資料第 3 版端點時，有各種任務中繼資料和 Docker 統計資訊可供任務使用。對於使用 bridge 網路模式的工作，查詢 /stats 端點時，可使用網路指標。

根據預設，對於在平台版本 1.3.0 或更新版本上使用 Fargate 啟動類型的任務，以及使用 EC2 啟動類型的任務，會啟用任務中繼資料端點第 3 版功能，並在至少執行 Amazon ECS 容器代理程式 1.21.0 版的 Amazon EC2 Linux 基礎設施，或者在至少執行 Amazon ECS 容器代理程式 1.54.0 版的 Amazon EC2 Windows 基礎設施上啟動該功能，並使用 awsvpc 網路模式。如需詳細資訊，請參閱 Amazon ECS Linux 容器實例管理。

您可以將代理更新為最新版本，以在舊容器執行個體上新增此功能的支援。如需詳細資訊，請參閱 更新 Amazon ECS 容器代理程式。

重要

對於使用 Fargate 啟動類型和低於 1.3.0 版平台版本的任務，支援任務中繼資料第 2 版端點。如需詳細資訊，請參閱 Amazon ECS 任務中繼資料端點版本 2。

工作中繼資料端點第 3 版路徑

下列任務中繼資料端點可供容器使用：

${ECS_CONTAINER_METADATA_URI}

此路徑傳回容器的 JSON 中繼資料。

${ECS_CONTAINER_METADATA_URI}/task

此路徑傳回任務的中繼資料 JSON，包括與任務相關聯之所有容器的容器 ID 和名稱清單。如需此端點之回應的詳細資訊，請參閱「Amazon ECS 任務元數據 v3 JSON 響應」。

${ECS_CONTAINER_METADATA_URI}/taskWithTags

除了可使用 ListTagsForResource API 擷取的任務和容器執行個體標籤之外，此路徑還會傳回包含在 /task 端點內的任務的中繼資料。

${ECS_CONTAINER_METADATA_URI}/stats

此路徑傳回特定 Docker 容器的 Docker 統計資訊 JSON。有關每個返回統計信息的更多信息，請參閱 Docker API 文檔ContainerStats中的。

${ECS_CONTAINER_METADATA_URI}/task/stats

此路徑傳回與任務相關聯之所有容器的 Docker 統計資訊 JSON。有關每個返回統計信息的更多信息，請參閱 Docker API 文檔ContainerStats中的。