Amazon ECS任務中繼資料端點第 4 版

Amazon ECS容器代理程式會將環境變數注入每個容器，稱為任務中繼資料端點，為容器提供各種任務中繼資料和 Docker 統計資料。

任務中繼資料和網路速率統計資料會傳送至 CloudWatch Container Insights，並可在 中檢視 AWS Management Console。如需詳細資訊，請參閱使用 ECS Container Insights 監控 Amazon 容器。

注意

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

根據預設，環境變數會注入在執行至少版本 Amazon 容器代理程式的 Amazon EC2 Linux 執行個體上啟動1.39.0的 Amazon ECS任務ECS容器中。對於使用awsvpc網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS容器代理程式必須至少是 版本1.54.0。如需詳細資訊，請參閱Amazon ECS Linux 容器執行個體管理。

注意

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

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

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

${ECS_CONTAINER_METADATA_URI_V4}

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

${ECS_CONTAINER_METADATA_URI_V4}/task

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

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

除了可以使用 ListTagsForResource 擷取的任務和容器執行個體標籤之外，此路徑還會傳回/task端點中包含的任務中繼資料API。擷取標籤中繼資料時收到的任何錯誤都會包含在回應的 Errors 欄位中。

注意

Errors 欄位僅回應在執行至少版本容器代理程式1.50.0的 Amazon EC2 Linux 執行個體上託管的任務。對於使用awsvpc網路模式的 Amazon EC2 Windows 執行個體，Amazon ECS容器代理程式必須至少為 版本 1.54.0

此端點需要 ecs.ListTagsForResource 許可。

${ECS_CONTAINER_METADATA_URI_V4}/stats

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

對於使用在執行至少版本容器代理程式的 Amazon EC2 Linux 執行個體上託管的 awsvpc或 bridge 網路模式1.43.0的 Amazon ECS任務，回應中將包含額外的網路速率統計資料。對於所有其他任務，回應只會包含累積的網路統計資訊。

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

此路徑傳回與任務相關聯之所有容器的 Docker 統計資訊。附屬容器可使用該資訊來擷取網路指標。如需每個傳回統計資料的詳細資訊，請參閱 Docker API 文件ContainerStats中的 。

對於使用在執行至少版本容器代理程式的 Amazon EC2 Linux 執行個體上託管的 awsvpc或 bridge 網路模式1.43.0的 Amazon ECS任務，回應中將包含額外的網路速率統計資料。對於所有其他任務，回應只會包含累積的網路統計資訊。