適用於 Fargate 上任務的 Amazon ECS 任務中繼資料端點第 4 版

重要

如果您使用託管在 Amazon ECS 執行個體上的 Amazon EC2 任務，請參閱 Amazon ECS 任務中繼資料端點。

從 Fargate 平台版本 1.4.0 開始，名為 ECS_CONTAINER_METADATA_URI_V4 的環境變數會插入任務中的每個容器。當您查詢任務中繼資料端點第 4 版時，有各種任務中繼資料和 Docker 統計資訊可供任務使用。

任務中繼資料端點第 4 版功能與第 3 版端點類似，但第 4 版為您的容器和任務提供其他網路中繼資料。查詢 /stats 端點時，也可以使用其他網路指標。

使用平台版本 1.4.0或更新版本執行的所有 Amazon ECS 任務 AWS Fargate ，其任務中繼資料端點預設為開啟。

注意

為了避免未來需要建立新的任務中繼資料端點版本，可以將其他中繼資料新增至第 4 版輸出。我們不會移除任何現有中繼資料或變更中繼資料欄位名稱。

Fargate 任務中繼資料端點第 4 版路徑

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

${ECS_CONTAINER_METADATA_URI_V4}

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

${ECS_CONTAINER_METADATA_URI_V4}/task

此路徑會傳回任務的中繼資料，包括容器 IDs 的清單，以及與任務相關聯的所有容器名稱。如需此端點之回應的詳細資訊，請參閱「Fargate 上任務的 Amazon ECS 任務中繼資料 v4 JSON 回應」。

${ECS_CONTAINER_METADATA_URI_V4}/stats

此路徑傳回 Docker 容器的 Docker 統計資訊。如需每個傳回統計資料的詳細資訊，請參閱 Docker ContainerStats 文件中的 API。

注意

上的 Amazon ECS 任務 AWS Fargate 需要容器執行約 1 秒，才能傳回容器統計資料。

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

此路徑傳回與任務相關聯之所有容器的 Docker 統計資訊。如需每個傳回統計資料的詳細資訊，請參閱 Docker ContainerStats 文件中的 API。

注意

上的 Amazon ECS 任務 AWS Fargate 需要容器執行約 1 秒，才能傳回容器統計資料。