Amazon ECS 任務中繼資料端點第 4 版 - Amazon Elastic Container Service
任務中繼資料端點版本 4 路徑

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

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

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

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

注意

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

環境變數會預設插入至 Amazon ECS 任務的容器中，這些任務在執行 Amazon ECS 容器代理程式至少 1.39.0 版的 Amazon EC2 Linux 執行個體上啟動。對於使用 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

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

${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags

除了可使用 ListTagsForResource API 擷取的任務和容器執行個體標籤之外，此路徑還會傳回包含在 /task 端點內的任務的中繼資料。擷取標籤中繼資料時收到的任何錯誤都會包含在回應的 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。

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

${ECS_CONTAINER_METADATA_URI_V4}/task/stats

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

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