Amazon ECS task metadata v4 examples for tasks on Amazon ECS Managed Instances
The following examples show sample outputs from the task metadata endpoints for Amazon ECS tasks run on Amazon ECS Managed Instances.
From the container, you can use curl followed by the task meta data endpoint to query
the endpoint for example curl ${ECS_CONTAINER_METADATA_URI_V4}/task.
Example container metadata response
When querying the ${ECS_CONTAINER_METADATA_URI_V4} endpoint you are
returned only metadata about the container itself. The following is an example
output.
{
"DockerId": "400c0466d1e54c0691aae0f86e0f9dc6-2531612879",
"Name": "nginx",
"DockerName": "nginx",
"Image": "public.ecr.aws/nginx/nginx:latest"
"ImageID": "sha256:d5f28ef21aabddd098f3dbc21fe5b7a7d7a184720bc07da0b6c9b9820e97f25e",
"Labels": {
"com.amazonaws.ecs.cluster": "arn:aws:ecs:us-west-2:111122223333:cluster/managed-instances-cluster",
"com.amazonaws.ecs.container-name": "curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6",
"com.amazonaws.ecs.task-definition-family": "ecs-managed-instances-task-def",
"com.amazonaws.ecs.task-definition-version": "7"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": { "CPU": 2 },
"CreatedAt": "2025-09-24T19:39:04.88336233Z",
"StartedAt": "2025-09-24T19:39:04.88336233Z",
"Type": "NORMAL",
"LogDriver": "awslogs",
"LogOptions": {
"awslogs-create-group": "true",
"awslogs-group": "/ecs/managed-instances-task-def",
"awslogs-region": "us-west-2",
"awslogs-stream": "ecs/nginx/400c0466d1e54c0691aae0f86e0f9dc6"
},
"ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6/3703f0e4-a351-4f1e-a0e7-6981ea7adc8b",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": ["172.31.62.223"],
"AttachmentIndex": 0,
"MACAddress": "0e:41:0b:1e:f2:fb",
"IPv4SubnetCIDRBlock": "172.31.48.0/20",
"PrivateDNSName": "ip-172-31-62-223.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "172.31.48.1/20"
}
],
"Snapshotter": "overlayfs"
}Amazon ECS task metadata v4 examples for tasks on Amazon ECS Managed Instances
When querying the ${ECS_CONTAINER_METADATA_URI_V4}/task endpoint you
are returned metadata about the task the container is part of. The following is an
example output.
{
"Cluster": "arn:aws:ecs:us-west-2:111122223333:cluster/managed-instances-cluster",
"TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6",
"Family": "managed-instances-task-def",
"Revision": "7",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": { "CPU": 1, "Memory": 3072 },
"PullStartedAt": "2025-09-24T19:38:58.682942001Z",
"PullStoppedAt": "2025-09-24T19:39:03.091597524Z",
"AvailabilityZone": "us-west-2d",
"LaunchType": "MANAGED_INSTANCES",
"Containers": [
{
"DockerId": "400c0466d1e54c0691aae0f86e0f9dc6-2531612879",
"Name": "curl",
"DockerName": "curl",
"Image": "nginx",
"ImageID": "sha256:d5f28ef21aabddd098f3dbc21fe5b7a7d7a184720bc07da0b6c9b9820e97f25e",
"Labels": {
"com.amazonaws.ecs.cluster": "arn:aws:ecs:us-west-2:111122223333:cluster/managed-instances-cluster",
"com.amazonaws.ecs.container-name": "nginx",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6",
"com.amazonaws.ecs.task-definition-family": "managed-instances-task-def",
"com.amazonaws.ecs.task-definition-version": "7"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": { "CPU": 2 },
"CreatedAt": "2025-09-24T19:39:04.88336233Z",
"StartedAt": "2025-09-24T19:39:04.88336233Z",
"Type": "NORMAL",
"LogDriver": "awslogs",
"LogOptions": {
"awslogs-create-group": "true",
"awslogs-group": "/ecs/managed-instances-task-def",
"awslogs-region": "us-west-2",
"awslogs-stream": "ecs/nginx/400c0466d1e54c0691aae0f86e0f9dc6"
},
"ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/managed-instances-cluster/400c0466d1e54c0691aae0f86e0f9dc6/3703f0e4-a351-4f1e-a0e7-6981ea7adc8b",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": ["172.31.62.223"],
"AttachmentIndex": 0,
"MACAddress": "0e:41:0b:1e:f2:fb",
"IPv4SubnetCIDRBlock": "172.31.48.0/20",
"PrivateDNSName": "ip-172-31-62-223.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "172.31.48.1/20"
}
],
"Snapshotter": "overlayfs"
}
],
"ServiceName": "exec-service-2",
"ClockDrift": {
"ClockErrorBound": 0.14120749999999999,
"ReferenceTimestamp": "2025-09-24T19:48:37Z",
"ClockSynchronizationStatus": "SYNCHRONIZED"
},
"FaultInjectionEnabled": false
}Example task stats response
When querying the ${ECS_CONTAINER_METADATA_URI_V4}/task/stats
endpoint you are returned network metrics about the task the container is part of.
The following is an example output.
{
"400c0466d1e54c0691aae0f86e0f9dc6-2531612879": {
"read": "2025-09-24T19:51:54.899736614Z",
"preread": "2025-09-24T19:51:44.901199024Z",
"pids_stats": {},
"blkio_stats": {
"io_service_bytes_recursive": [
{ "major": 259, "minor": 1, "op": "read", "value": 0 },
{ "major": 259, "minor": 1, "op": "write", "value": 131072 },
{ "major": 259, "minor": 0, "op": "read", "value": 48173056 },
{ "major": 259, "minor": 0, "op": "write", "value": 0 },
{ "major": 252, "minor": 0, "op": "read", "value": 48173056 },
{ "major": 252, "minor": 0, "op": "write", "value": 0 }
],
"io_serviced_recursive": null,
"io_queue_recursive": null,
"io_service_time_recursive": null,
"io_wait_time_recursive": null,
"io_merged_recursive": null,
"io_time_recursive": null,
"sectors_recursive": null
},
"num_procs": 0,
"storage_stats": {},
"cpu_stats": {
"cpu_usage": {
"total_usage": 670462000,
"usage_in_kernelmode": 276072000,
"usage_in_usermode": 394389000
},
"system_cpu_usage": 787660000000,
"online_cpus": 1,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"precpu_stats": {
"cpu_usage": {
"total_usage": 663809000,
"usage_in_kernelmode": 273333000,
"usage_in_usermode": 390476000
},
"system_cpu_usage": 777710000000,
"online_cpus": 1,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"memory_stats": {
"usage": 83562496,
"stats": {
"active_anon": 24576,
"active_file": 258048,
"anon": 32264192,
"anon_thp": 0,
"file": 48533504,
"file_dirty": 0,
"file_mapped": 36286464,
"file_writeback": 0,
"inactive_anon": 32243712,
"inactive_file": 48271360,
"kernel_stack": 442368,
"pgactivate": 6,
"pgdeactivate": 0,
"pgfault": 18936,
"pglazyfree": 0,
"pglazyfreed": 0,
"pgmajfault": 311,
"pgrefill": 0,
"pgscan": 0,
"pgsteal": 0,
"shmem": 4096,
"slab": 1598960,
"slab_reclaimable": 1080040,
"slab_unreclaimable": 518920,
"sock": 0,
"thp_collapse_alloc": 0,
"thp_fault_alloc": 0,
"unevictable": 0,
"workingset_activate": 0,
"workingset_nodereclaim": 0,
"workingset_refault": 0
},
"limit": 18446744073709551615
},
"name": "nginx",
"id": "400c0466d1e54c0691aae0f86e0f9dc6-2531612879"
}
}