Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Metadata tugas tersedia untuk tugas Amazon ECS di EC2
[Agen penampung Amazon ECS menyediakan metode untuk mengambil berbagai metadata tugas dan statistik Docker.](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) Hal Ini disebut sebagai titik akhir metadata tugas. Versi berikut tersedia:
+ Titik akhir metadata tugas versi 4 — Menyediakan berbagai metadata dan statistik Docker ke kontainer. Juga dapat menyediakan data tingkat jaringan. Tersedia untuk tugas Amazon ECS yang diluncurkan di instans Amazon EC2 Linux yang menjalankan setidaknya versi agen `1.39.0` penampung Amazon ECS. Untuk instans Windows Amazon EC2 yang menggunakan mode `awsvpc` jaringan, agen penampung Amazon ECS harus setidaknya versi. `1.54.0` Untuk informasi selengkapnya, lihat [Titik akhir metadata tugas Amazon ECS versi 4](task-metadata-endpoint-v4.md).
+ Titik akhir metadata tugas versi 3 — Menyediakan berbagai metadata dan statistik Docker ke kontainer. Tersedia untuk tugas Amazon ECS yang diluncurkan di instans Amazon EC2 Linux yang menjalankan setidaknya versi agen `1.21.0` penampung Amazon ECS. Untuk instans Windows Amazon EC2 yang menggunakan mode `awsvpc` jaringan, agen penampung Amazon ECS harus setidaknya versi. `1.54.0` Untuk informasi selengkapnya, lihat [Titik akhir metadata tugas Amazon ECS versi 3](task-metadata-endpoint-v3.md).
+ Titik akhir metadata tugas versi 2 — Tersedia untuk tugas Amazon ECS yang diluncurkan di instans Amazon EC2 Linux yang menjalankan setidaknya versi agen penampung Amazon ECS. `1.17.0` Untuk instans Windows Amazon EC2 yang menggunakan mode `awsvpc` jaringan, agen penampung Amazon ECS harus setidaknya versi. `1.54.0` Untuk informasi selengkapnya, lihat [Titik akhir metadata tugas Amazon ECS versi 2](task-metadata-endpoint-v2.md).
Jika tugas Amazon ECS Anda di-host di Amazon EC2, atau jika tugas Anda menggunakan `host` mode jaringan dan di-host di Instans Terkelola Amazon ECS, Anda juga dapat mengakses metadata host tugas menggunakan titik akhir Layanan Metadata [Instans](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) (IMDS). Perintah berikut, ketika dijalankan dari dalam instance hosting tugas, mencantumkan ID dari instance host.
```
curl http://169.254.169.254/latest/meta-data/instance-id
```
Jika tugas Amazon ECS Anda di-host di Amazon EC2 dan dalam konfigurasi -only, Anda dapat mengakses metadata host tugas IPv6 menggunakan titik akhir IMDS. IPv6 Perintah berikut, ketika dijalankan dari dalam instance hosting tugas, mencantumkan ID instance host di atas IPv6.
```
curl http://[fd00:ec2::254]/latest/meta-data/instance-id
```
Untuk mengakses titik akhir IPv6 IMDS, aktifkan titik akhir IPv6 IMDS pada instance container Anda dan juga konfigurasikan mode titik akhir layanan metadata menggunakan penyedia kredensi IMDS untuk SDK pilihan Anda. `IPv6` *Untuk informasi selengkapnya tentang mengaktifkan titik akhir IPv6 IMDS untuk instance container Anda, lihat [Mengonfigurasi opsi Layanan Metadata Instans di Panduan Pengguna Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html).* Untuk informasi selengkapnya tentang penyedia kredensi IMDS SDKs, lihat Penyedia [kredensyal IMDS di Panduan Referensi](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html) Alat *AWS SDKs dan* Alat.
**catatan**
Titik akhir IPv6 IMDS tidak dapat diakses saat pengaturan `awsvpcTrunking` akun diaktifkan. Untuk mengakses kredensil peran IAM instance container saat `awsvpcTrunking` diaktifkan, Anda dapat menggunakan peran IAM tugas sebagai gantinya. Untuk informasi selengkapnya tentang peran IAM tugas, lihat[Peran IAM tugas Amazon ECS](task-iam-roles.md).
Informasi yang dapat Anda peroleh dari titik akhir dibagi ke dalam kategori seperti`instance-id`. Untuk informasi selengkapnya tentang berbagai kategori metadata instans host yang dapat Anda peroleh menggunakan titik akhir, lihat Kategori metadata [instans](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories).
# Titik akhir metadata tugas Amazon ECS versi 4
[Agen kontainer Amazon ECS menyuntikkan variabel lingkungan ke dalam setiap kontainer, yang disebut sebagai *titik akhir metadata tugas yang menyediakan berbagai metadata* tugas dan statistik Docker ke wadah.](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)
Metadata tugas dan statistik tingkat jaringan dikirim ke CloudWatch Wawasan Kontainer dan dapat dilihat di. Konsol Manajemen AWS Untuk informasi selengkapnya, lihat [Pantau kontainer Amazon ECS menggunakan Container Insights dengan kemampuan observasi yang ditingkatkan](cloudwatch-container-insights.md).
**catatan**
Amazon ECS menyediakan versi sebelumnya dari titik akhir metadata tugas. Untuk menghindari kebutuhan membuat versi titik akhir metadata tugas di masa mendatang, metadata tambahan dapat ditambahkan ke output versi 4. Kami tidak akan menghapus metadata yang ada atau mengubah nama bidang metadata.
Variabel lingkungan disuntikkan secara default ke dalam wadah tugas Amazon ECS yang diluncurkan pada instans Amazon EC2 Linux yang menjalankan setidaknya versi agen `1.39.0` penampung Amazon ECS. Untuk instans Windows Amazon EC2 yang menggunakan mode `awsvpc` jaringan, agen penampung Amazon ECS harus setidaknya versi. `1.54.0` Untuk informasi selengkapnya, lihat [Manajemen instans penampung Amazon ECS Linux](manage-linux.md).
**catatan**
Anda dapat menambahkan dukungan untuk fitur ini di instans Amazon EC2 menggunakan versi lama agen penampung Amazon ECS dengan memperbarui agen ke versi terbaru. Untuk informasi selengkapnya, lihat [Memperbarui agen kontainer Amazon ECS](ecs-agent-update.md).
Untuk keluaran contoh metadata tugas, lihat contoh [metadata tugas Amazon ECS v4](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v4-examples.html).
## Jalur titik akhir metadata tugas versi 4
Jalur titik akhir metadata tugas berikut tersedia untuk kontainer.
`${ECS_CONTAINER_METADATA_URI_V4}`
Jalur ini mengembalikan metadata untuk kontainer.
`${ECS_CONTAINER_METADATA_URI_V4}/task`
Jalur ini mengembalikan metadata untuk tugas, termasuk daftar penampung IDs dan nama untuk semua kontainer yang terkait dengan tugas. Untuk informasi selengkapnya tentang respons titik akhir ini, lihat [Metadata tugas Amazon ECS V4 Respons JSON](task-metadata-endpoint-v4-response.md).
`${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`
Jalur ini mengembalikan metadata untuk tugas termasuk dalam titik akhir `/task` selain tugas dan tanda instans kontainer yang dapat diambil menggunakan API `ListTagsForResource`. Setiap kesalahan yang diterima saat mengambil metadata tanda akan disertakan dalam kolom `Errors` sebagai responsnya.
`Errors`Bidang ini hanya dalam respons untuk tugas yang dihosting di instans Amazon EC2 Linux yang menjalankan setidaknya versi agen `1.50.0` penampung. Untuk instans Windows Amazon EC2 yang menggunakan mode `awsvpc` jaringan, agen penampung Amazon ECS harus setidaknya versi `1.54.0`
Titik akhir ini membutuhkan `ecs.ListTagsForResource` izin.
Saat menggunakan `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags` titik akhir, ketahuilah bahwa setiap panggilan membuat hingga dua permintaan API `ecs:ListTagsForResource` (satu untuk tag instance kontainer dan satu untuk tag tugas) dan bahwa setiap wadah sespan dalam tugas dapat melakukan panggilan ini atas nama Anda. Panggilan endpoint yang sering dapat mengakibatkan pelambatan API.
Pertimbangkan untuk menerapkan strategi caching atau batching untuk mengurangi frekuensi panggilan, terutama dalam aplikasi dengan lalu lintas tinggi, dan men-debug masalah pelambatan API yang digunakan. AWS CloudTrail Untuk informasi tentang batas pembatasan untuk `ListTagsForResource` API, lihat [Meminta pembatasan untuk Amazon ECS API di Referensi API Amazon Elastic](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/request-throttling.html) *Container Service*. Untuk informasi selengkapnya tentang men-debug panggilan Amazon ECS API menggunakan AWS CloudTrail, lihat. [Log panggilan Amazon ECS API menggunakan AWS CloudTrail](logging-using-cloudtrail.md)
`${ECS_CONTAINER_METADATA_URI_V4}/stats`
Jalur ini mengembalikan statistik Docker untuk kontainer tertentu. Untuk informasi selengkapnya tentang masing-masing statistik yang dikembalikan, lihat [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)di dokumentasi Docker API.
Untuk tugas Amazon ECS yang menggunakan mode `bridge` jaringan `awsvpc` atau yang dihosting di instans Amazon EC2 Linux yang menjalankan setidaknya `1.43.0` versi agen penampung, akan ada statistik tarif jaringan tambahan yang disertakan dalam respons. Untuk semua tugas lainnya, respons hanya akan mencakup statistik jaringan kumulatif.
`${ECS_CONTAINER_METADATA_URI_V4}/task/stats`
Jalan ini mengembalikan statistik Docker untuk semua kontainer yang terkait dengan tugas. Hal ini dapat digunakan oleh kontainer sidecar untuk mengekstrak metrik jaringan. Untuk informasi selengkapnya tentang masing-masing statistik yang dikembalikan, lihat [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)di dokumentasi Docker API.
Untuk tugas Amazon ECS yang menggunakan mode `bridge` jaringan `awsvpc` atau yang dihosting di instans Amazon EC2 Linux yang menjalankan setidaknya `1.43.0` versi agen penampung, akan ada statistik tarif jaringan tambahan yang disertakan dalam respons. Untuk semua tugas lainnya, respons hanya akan mencakup statistik jaringan kumulatif.
# Metadata tugas Amazon ECS V4 Respons JSON
Informasi berikut dikembalikan dari respons JSON (`${ECS_CONTAINER_METADATA_URI_V4}/task`) titik akhir metadata tugas. Hal ini termasuk metadata yang terkait dengan tugas selain metadata untuk setiap kontainer dalam tugas.
`Cluster`
Nama Sumber Daya Amazon (ARN) atau nama pendek dari cluster Amazon ECS tempat tugas tersebut berada.
`ServiceName`
Nama layanan tempat tugas itu berada. ServiceName akan muncul untuk instans penampung Amazon EC2 dan Amazon ECS Anywhere jika tugas dikaitkan dengan layanan.
`ServiceName`Metadata hanya disertakan saat menggunakan versi `1.63.1` agen penampung Amazon ECS atau yang lebih baru.
`VPCID`
ID VPC dari instans penampung Amazon EC2. Bidang ini hanya muncul untuk instans Amazon EC2.
`VPCID`Metadata hanya disertakan saat menggunakan versi `1.63.1` agen penampung Amazon ECS atau yang lebih baru.
`TaskARN`
Nama Sumber Daya Amazon (ARN) dari tugas yang menjadi milik wadah tersebut.
`Family`
Keluarga definisi tugas Amazon ECS untuk tugas tersebut.
`Revision`
Revisi definisi tugas Amazon ECS untuk tugas tersebut.
`DesiredStatus`
Status yang diinginkan untuk tugas dari Amazon ECS.
`KnownStatus`
Status yang diketahui untuk tugas dari Amazon ECS.
`Limits`
Batas sumber daya yang ditentukan pada tingkat tugas, seperti CPU (dinyatakan dalam vCPUs) dan memori. Parameter ini dihilangkan jika tidak ada batasan sumber daya yang ditentukan.
`PullStartedAt`
Stempel waktu saat penarikan gambar kontainer pertama dimulai.
`PullStoppedAt`
Stempel waktu ketika penarikan gambar kontainer terakhir selesai.
`AvailabilityZone`
Availability Zone tempat tugas berada.
Metadata Availability Zone hanya tersedia untuk tugas Fargate menggunakan platform versi 1.4 atau yang lebih baru (Linux) atau 1.0.0 (Windows).
`LaunchType`
Jenis peluncuran yang digunakan tugas. Saat menggunakan penyedia kapasitas cluster, ini menunjukkan apakah tugas tersebut menggunakan infrastruktur Fargate atau EC2.
`LaunchType`Metadata ini hanya disertakan saat menggunakan Amazon ECS Linux versi agen container atau yang lebih baru (Linux) `1.45.0` atau 1.0.0 atau yang lebih baru (Windows).
`Containers`
Daftar metadata kontainer untuk setiap kontainer yang terkait dengan tugas.
`DockerId`
ID Docker untuk wadah.
Saat Anda menggunakan Fargate, id adalah hex 32 digit diikuti dengan angka 10 digit.
`Name`
Nama wadah seperti yang ditentukan dalam definisi tugas.
`DockerName`
Nama wadah yang dipasok ke Docker. Agen penampung Amazon ECS menghasilkan nama unik untuk penampung untuk menghindari tabrakan nama saat beberapa salinan dari definisi tugas yang sama dijalankan pada satu instance.
`Image`
Gambar untuk wadah.
`ImageID`
Intisari SHA-256 dari manifes gambar. Ini adalah intisari yang dapat digunakan untuk menarik gambar menggunakan format`repository-url/image@sha256:digest`.
`Ports`
Port apa pun yang terbuka untuk wadah. Parameter ini dihilangkan jika tidak ada port yang terbuka.
`Labels`
Label apa pun diterapkan pada wadah. Parameter ini dihilangkan jika tidak ada label yang diterapkan.
`DesiredStatus`
Status yang diinginkan untuk wadah dari Amazon ECS.
`KnownStatus`
Status yang diketahui untuk wadah dari Amazon ECS.
`ExitCode`
Kode keluar untuk wadah. Parameter ini dihilangkan jika wadah belum keluar.
`Limits`
Batas sumber daya yang ditentukan pada tingkat kontainer, seperti CPU (dinyatakan dalam unit CPU) dan memori. Parameter ini dihilangkan jika tidak ada batasan sumber daya yang ditentukan.
`CreatedAt`
Cap waktu untuk saat wadah dibuat. Parameter ini dihilangkan jika wadah belum dibuat.
`StartedAt`
Cap waktu untuk saat wadah dimulai. Parameter ini dihilangkan jika wadah belum dimulai.
`FinishedAt`
Cap waktu untuk saat wadah berhenti. Parameter ini dihilangkan jika wadah belum berhenti.
`Type`
Jenis wadahnya. Wadah yang ditentukan dalam definisi tugas Anda adalah tipe`NORMAL`. Anda dapat mengabaikan jenis penampung lain, yang digunakan untuk penyediaan sumber daya tugas internal oleh agen penampung Amazon ECS.
`LogDriver`
Driver log yang digunakan wadah.
`LogDriver`Metadata ini hanya disertakan saat menggunakan versi `1.45.0` agen penampung Amazon ECS Linux atau yang lebih baru.
`LogOptions`
Opsi driver log yang ditentukan untuk wadah.
`LogOptions`Metadata ini hanya disertakan saat menggunakan versi `1.45.0` agen penampung Amazon ECS Linux atau yang lebih baru.
`ContainerARN`
Nama Sumber Daya Amazon (ARN) dari wadah.
`ContainerARN`Metadata ini hanya disertakan saat menggunakan versi `1.45.0` agen penampung Amazon ECS Linux atau yang lebih baru.
`Networks`
Informasi jaringan untuk wadah, seperti mode jaringan dan alamat IP. Parameter ini dihilangkan jika tidak ada informasi jaringan yang didefinisikan.
`RestartCount`
Berapa kali wadah telah dimulai ulang.
`RestartCount`Metadata hanya disertakan jika kebijakan restart diaktifkan untuk penampung. Untuk informasi selengkapnya, lihat [Mulai ulang kontainer individual dalam tugas Amazon ECS dengan kebijakan restart kontainer](container-restart-policy.md).
`ExecutionStoppedAt`
Cap waktu untuk saat tugas `DesiredStatus` pindah ke`STOPPED`. Ini terjadi ketika wadah penting bergerak ke`STOPPED`.
# Contoh metadata tugas Amazon ECS v4
Contoh berikut menampilkan output contoh dari masing-masing titik akhir metadata tugas.
## Respons metadata kontainer contoh
Ketika melakukan kueri terhadap titik akhir `${ECS_CONTAINER_METADATA_URI_V4}`, hanya metadata kontainer tersebut yang dikembalikan kepada Anda. Berikut ini adalah contoh output dari tugas yang berjalan sebagai bagian dari layanan (MyService).
```
{
"DockerId": "ea32192c8553fbff06c9340478a2ff089b2bb5646fb718b4ee206641c9086d66",
"Name": "curl",
"DockerName": "ecs-curltest-24-curl-cca48e8dcadd97805600",
"Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest",
"ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/8f03e41243824aea923aca126495f665",
"com.amazonaws.ecs.task-definition-family": "curltest",
"com.amazonaws.ecs.task-definition-version": "24"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 10,
"Memory": 128
},
"CreatedAt": "2020-10-02T00:15:07.620912337Z",
"StartedAt": "2020-10-02T00:15:08.062559351Z",
"Type": "NORMAL",
"LogDriver": "awslogs",
"LogOptions": {
"awslogs-create-group": "true",
"awslogs-group": "/ecs/metadata",
"awslogs-region": "us-west-2",
"awslogs-stream": "ecs/curl/8f03e41243824aea923aca126495f665"
},
"ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/0206b271-b33f-47ab-86c6-a0ba208a70a9",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.100"
],
"AttachmentIndex": 0,
"MACAddress": "0e:9e:32:c7:48:85",
"IPv4SubnetCIDRBlock": "10.0.2.0/24",
"PrivateDNSName": "ip-10-0-2-100.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "10.0.2.1/24"
}
]
}
```
## Respons metadata tugas contoh
Ketika melakukan kueri terhadap titik akhir `${ECS_CONTAINER_METADATA_URI_V4}/task`, metadata dari tugas yang berisi bagian kontainer selain metada untuk masing-masing kontainer dalam tugas dikembalikan kepada Anda. Berikut ini adalah output contoh.
```
{
"Cluster": "default",
"TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c",
"Family": "curltest",
"ServiceName": "MyService",
"Revision": "26",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"PullStartedAt": "2020-10-02T00:43:06.202617438Z",
"PullStoppedAt": "2020-10-02T00:43:06.31288465Z",
"AvailabilityZone": "us-west-2d",
"VPCID": "vpc-1234567890abcdef0",
"LaunchType": "EC2",
"Containers": [
{
"DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38",
"Name": "~internal~ecs~pause",
"DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00",
"Image": "amazon/amazon-ecs-pause:0.1.0",
"ImageID": "",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "~internal~ecs~pause",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c",
"com.amazonaws.ecs.task-definition-family": "curltest",
"com.amazonaws.ecs.task-definition-version": "26"
},
"DesiredStatus": "RESOURCES_PROVISIONED",
"KnownStatus": "RESOURCES_PROVISIONED",
"Limits": {
"CPU": 0,
"Memory": 0
},
"CreatedAt": "2020-10-02T00:43:05.602352471Z",
"StartedAt": "2020-10-02T00:43:06.076707576Z",
"Type": "CNI_PAUSE",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.61"
],
"AttachmentIndex": 0,
"MACAddress": "0e:10:e2:01:bd:91",
"IPv4SubnetCIDRBlock": "10.0.2.0/24",
"PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "10.0.2.1/24"
}
]
},
{
"DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca",
"Name": "curl",
"DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00",
"Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest",
"ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c",
"com.amazonaws.ecs.task-definition-family": "curltest",
"com.amazonaws.ecs.task-definition-version": "26"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 10,
"Memory": 128
},
"CreatedAt": "2020-10-02T00:43:06.326590752Z",
"StartedAt": "2020-10-02T00:43:06.767535449Z",
"Type": "NORMAL",
"LogDriver": "awslogs",
"LogOptions": {
"awslogs-create-group": "true",
"awslogs-group": "/ecs/metadata",
"awslogs-region": "us-west-2",
"awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c"
},
"ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.61"
],
"AttachmentIndex": 0,
"MACAddress": "0e:10:e2:01:bd:91",
"IPv4SubnetCIDRBlock": "10.0.2.0/24",
"PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "10.0.2.1/24"
}
]
}
]
}
```
## Tugas contoh dengan respons metadata tanda
Ketika melakukan kueri terhadap titik akhir `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, metadata dari tugas yang berisi tugas dan tanda instans kontainer dikembalikan kepada Anda. Berikut ini adalah output contoh.
```
{
"Cluster": "default",
"TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c",
"Family": "curltest",
"ServiceName": "MyService",
"Revision": "26",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"PullStartedAt": "2020-10-02T00:43:06.202617438Z",
"PullStoppedAt": "2020-10-02T00:43:06.31288465Z",
"AvailabilityZone": "us-west-2d",
"VPCID": "vpc-1234567890abcdef0",
"TaskTags": {
"tag-use": "task-metadata-endpoint-test"
},
"ContainerInstanceTags":{
"tag_key":"tag_value"
},
"LaunchType": "EC2",
"Containers": [
{
"DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38",
"Name": "~internal~ecs~pause",
"DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00",
"Image": "amazon/amazon-ecs-pause:0.1.0",
"ImageID": "",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "~internal~ecs~pause",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c",
"com.amazonaws.ecs.task-definition-family": "curltest",
"com.amazonaws.ecs.task-definition-version": "26"
},
"DesiredStatus": "RESOURCES_PROVISIONED",
"KnownStatus": "RESOURCES_PROVISIONED",
"Limits": {
"CPU": 0,
"Memory": 0
},
"CreatedAt": "2020-10-02T00:43:05.602352471Z",
"StartedAt": "2020-10-02T00:43:06.076707576Z",
"Type": "CNI_PAUSE",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.61"
],
"AttachmentIndex": 0,
"MACAddress": "0e:10:e2:01:bd:91",
"IPv4SubnetCIDRBlock": "10.0.2.0/24",
"PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "10.0.2.1/24"
}
]
},
{
"DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca",
"Name": "curl",
"DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00",
"Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest",
"ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c",
"com.amazonaws.ecs.task-definition-family": "curltest",
"com.amazonaws.ecs.task-definition-version": "26"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 10,
"Memory": 128
},
"CreatedAt": "2020-10-02T00:43:06.326590752Z",
"StartedAt": "2020-10-02T00:43:06.767535449Z",
"Type": "NORMAL",
"LogDriver": "awslogs",
"LogOptions": {
"awslogs-create-group": "true",
"awslogs-group": "/ecs/metadata",
"awslogs-region": "us-west-2",
"awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c"
},
"ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.61"
],
"AttachmentIndex": 0,
"MACAddress": "0e:10:e2:01:bd:91",
"IPv4SubnetCIDRBlock": "10.0.2.0/24",
"PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "10.0.2.1/24"
}
]
}
]
}
```
## Tugas contoh dengan tanda yang menggambarkan respons metadata kesalahan
Ketika melakukan kueri terhadap titik akhir `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, metadata dari tugas yang berisi tugas dan tanda instans kontainer dikembalikan kepada Anda. Jika terjadi kesalahan saat mengambil data penandaan, kesalahan dikembalikan dalam bentuk respons. Berikut ini adalah contoh keluaran ketika peran IAM yang terkait dengan instance container tidak memiliki `ecs:ListTagsForResource` izin yang diizinkan.
```
{
"Cluster": "default",
"TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c",
"Family": "curltest",
"ServiceName": "MyService",
"Revision": "26",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"PullStartedAt": "2020-10-02T00:43:06.202617438Z",
"PullStoppedAt": "2020-10-02T00:43:06.31288465Z",
"AvailabilityZone": "us-west-2d",
"VPCID": "vpc-1234567890abcdef0",
"Errors": [
{
"ErrorField": "ContainerInstanceTags",
"ErrorCode": "AccessDeniedException",
"ErrorMessage": "User: arn:aws:sts::111122223333:assumed-role/ecsInstanceRole/i-0744a608689EXAMPLE is not authorized to perform: ecs:ListTagsForResource on resource: arn:aws:ecs:us-west-2:111122223333:container-instance/default/2dd1b186f39845a584488d2ef155c131",
"StatusCode": 400,
"RequestId": "cd597ef0-272b-4643-9bd2-1de469870fa6",
"ResourceARN": "arn:aws:ecs:us-west-2:111122223333:container-instance/default/2dd1b186f39845a584488d2ef155c131"
},
{
"ErrorField": "TaskTags",
"ErrorCode": "AccessDeniedException",
"ErrorMessage": "User: arn:aws:sts::111122223333:assumed-role/ecsInstanceRole/i-0744a608689EXAMPLE is not authorized to perform: ecs:ListTagsForResource on resource: arn:aws:ecs:us-west-2:111122223333:task/default/9ef30e4b7aa44d0db562749cff4983f3",
"StatusCode": 400,
"RequestId": "862c5986-6cd2-4aa6-87cc-70be395531e1",
"ResourceARN": "arn:aws:ecs:us-west-2:111122223333:task/default/9ef30e4b7aa44d0db562749cff4983f3"
}
],
"LaunchType": "EC2",
"Containers": [
{
"DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38",
"Name": "~internal~ecs~pause",
"DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00",
"Image": "amazon/amazon-ecs-pause:0.1.0",
"ImageID": "",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "~internal~ecs~pause",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c",
"com.amazonaws.ecs.task-definition-family": "curltest",
"com.amazonaws.ecs.task-definition-version": "26"
},
"DesiredStatus": "RESOURCES_PROVISIONED",
"KnownStatus": "RESOURCES_PROVISIONED",
"Limits": {
"CPU": 0,
"Memory": 0
},
"CreatedAt": "2020-10-02T00:43:05.602352471Z",
"StartedAt": "2020-10-02T00:43:06.076707576Z",
"Type": "CNI_PAUSE",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.61"
],
"AttachmentIndex": 0,
"MACAddress": "0e:10:e2:01:bd:91",
"IPv4SubnetCIDRBlock": "10.0.2.0/24",
"PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "10.0.2.1/24"
}
]
},
{
"DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca",
"Name": "curl",
"DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00",
"Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest",
"ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c",
"com.amazonaws.ecs.task-definition-family": "curltest",
"com.amazonaws.ecs.task-definition-version": "26"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 10,
"Memory": 128
},
"CreatedAt": "2020-10-02T00:43:06.326590752Z",
"StartedAt": "2020-10-02T00:43:06.767535449Z",
"Type": "NORMAL",
"LogDriver": "awslogs",
"LogOptions": {
"awslogs-create-group": "true",
"awslogs-group": "/ecs/metadata",
"awslogs-region": "us-west-2",
"awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c"
},
"ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.61"
],
"AttachmentIndex": 0,
"MACAddress": "0e:10:e2:01:bd:91",
"IPv4SubnetCIDRBlock": "10.0.2.0/24",
"PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal",
"SubnetGatewayIpv4Address": "10.0.2.1/24"
}
]
}
]
}
```
## Respons statistik kontainer contoh
Ketika melakukan kueri terhadap titik akhir `${ECS_CONTAINER_METADATA_URI_V4}/stats`, metrik jaringan untuk kontainer dikembalikan kepada Anda. Untuk tugas Amazon ECS yang menggunakan mode `bridge` jaringan `awsvpc` atau yang dihosting di instans Amazon EC2 yang menjalankan setidaknya `1.43.0` versi agen penampung, akan ada statistik tarif jaringan tambahan yang disertakan dalam respons. Untuk semua tugas lainnya, respons hanya akan mencakup statistik jaringan kumulatif.
Berikut ini adalah contoh output dari tugas Amazon ECS di Amazon EC2 yang menggunakan mode jaringan`bridge`.
```
{
"read": "2020-10-02T00:51:13.410254284Z",
"preread": "2020-10-02T00:51:12.406202398Z",
"pids_stats": {
"current": 3
},
"blkio_stats": {
"io_service_bytes_recursive": [
],
"io_serviced_recursive": [
],
"io_queue_recursive": [
],
"io_service_time_recursive": [
],
"io_wait_time_recursive": [
],
"io_merged_recursive": [
],
"io_time_recursive": [
],
"sectors_recursive": [
]
},
"num_procs": 0,
"storage_stats": {
},
"cpu_stats": {
"cpu_usage": {
"total_usage": 360968065,
"percpu_usage": [
182359190,
178608875
],
"usage_in_kernelmode": 40000000,
"usage_in_usermode": 290000000
},
"system_cpu_usage": 13939680000000,
"online_cpus": 2,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"precpu_stats": {
"cpu_usage": {
"total_usage": 360968065,
"percpu_usage": [
182359190,
178608875
],
"usage_in_kernelmode": 40000000,
"usage_in_usermode": 290000000
},
"system_cpu_usage": 13937670000000,
"online_cpus": 2,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"memory_stats": {
"usage": 1806336,
"max_usage": 6299648,
"stats": {
"active_anon": 606208,
"active_file": 0,
"cache": 0,
"dirty": 0,
"hierarchical_memory_limit": 134217728,
"hierarchical_memsw_limit": 268435456,
"inactive_anon": 0,
"inactive_file": 0,
"mapped_file": 0,
"pgfault": 4185,
"pgmajfault": 0,
"pgpgin": 2926,
"pgpgout": 2778,
"rss": 606208,
"rss_huge": 0,
"total_active_anon": 606208,
"total_active_file": 0,
"total_cache": 0,
"total_dirty": 0,
"total_inactive_anon": 0,
"total_inactive_file": 0,
"total_mapped_file": 0,
"total_pgfault": 4185,
"total_pgmajfault": 0,
"total_pgpgin": 2926,
"total_pgpgout": 2778,
"total_rss": 606208,
"total_rss_huge": 0,
"total_unevictable": 0,
"total_writeback": 0,
"unevictable": 0,
"writeback": 0
},
"limit": 134217728
},
"name": "/ecs-curltest-26-curl-c2e5f6e0cf91b0bead01",
"id": "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af",
"networks": {
"eth0": {
"rx_bytes": 84,
"rx_packets": 2,
"rx_errors": 0,
"rx_dropped": 0,
"tx_bytes": 84,
"tx_packets": 2,
"tx_errors": 0,
"tx_dropped": 0
}
},
"network_rate_stats": {
"rx_bytes_per_sec": 0,
"tx_bytes_per_sec": 0
}
}
```
## Respons statistik tugas contoh
Ketika melakukan kueri terhadap titik akhir `${ECS_CONTAINER_METADATA_URI_V4}/task/stats`, metrik jaringan dari tugas yang berisi bagian kontainer dikembalikan kepada Anda. Berikut ini adalah output contoh.
```
{
"01999f2e5c6cf4df3873f28950e6278813408f281c54778efec860d0caad4854": {
"read": "2020-10-02T00:51:32.51467703Z",
"preread": "2020-10-02T00:51:31.50860463Z",
"pids_stats": {
"current": 1
},
"blkio_stats": {
"io_service_bytes_recursive": [
],
"io_serviced_recursive": [
],
"io_queue_recursive": [
],
"io_service_time_recursive": [
],
"io_wait_time_recursive": [
],
"io_merged_recursive": [
],
"io_time_recursive": [
],
"sectors_recursive": [
]
},
"num_procs": 0,
"storage_stats": {
},
"cpu_stats": {
"cpu_usage": {
"total_usage": 177232665,
"percpu_usage": [
13376224,
163856441
],
"usage_in_kernelmode": 0,
"usage_in_usermode": 160000000
},
"system_cpu_usage": 13977820000000,
"online_cpus": 2,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"precpu_stats": {
"cpu_usage": {
"total_usage": 177232665,
"percpu_usage": [
13376224,
163856441
],
"usage_in_kernelmode": 0,
"usage_in_usermode": 160000000
},
"system_cpu_usage": 13975800000000,
"online_cpus": 2,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"memory_stats": {
"usage": 532480,
"max_usage": 6279168,
"stats": {
"active_anon": 40960,
"active_file": 0,
"cache": 0,
"dirty": 0,
"hierarchical_memory_limit": 9223372036854771712,
"hierarchical_memsw_limit": 9223372036854771712,
"inactive_anon": 0,
"inactive_file": 0,
"mapped_file": 0,
"pgfault": 2033,
"pgmajfault": 0,
"pgpgin": 1734,
"pgpgout": 1724,
"rss": 40960,
"rss_huge": 0,
"total_active_anon": 40960,
"total_active_file": 0,
"total_cache": 0,
"total_dirty": 0,
"total_inactive_anon": 0,
"total_inactive_file": 0,
"total_mapped_file": 0,
"total_pgfault": 2033,
"total_pgmajfault": 0,
"total_pgpgin": 1734,
"total_pgpgout": 1724,
"total_rss": 40960,
"total_rss_huge": 0,
"total_unevictable": 0,
"total_writeback": 0,
"unevictable": 0,
"writeback": 0
},
"limit": 4073377792
},
"name": "/ecs-curltest-26-internalecspause-a6bcc3dbadfacfe85300",
"id": "01999f2e5c6cf4df3873f28950e6278813408f281c54778efec860d0caad4854",
"networks": {
"eth0": {
"rx_bytes": 84,
"rx_packets": 2,
"rx_errors": 0,
"rx_dropped": 0,
"tx_bytes": 84,
"tx_packets": 2,
"tx_errors": 0,
"tx_dropped": 0
}
},
"network_rate_stats": {
"rx_bytes_per_sec": 0,
"tx_bytes_per_sec": 0
}
},
"5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af": {
"read": "2020-10-02T00:51:32.512771349Z",
"preread": "2020-10-02T00:51:31.510597736Z",
"pids_stats": {
"current": 3
},
"blkio_stats": {
"io_service_bytes_recursive": [
],
"io_serviced_recursive": [
],
"io_queue_recursive": [
],
"io_service_time_recursive": [
],
"io_wait_time_recursive": [
],
"io_merged_recursive": [
],
"io_time_recursive": [
],
"sectors_recursive": [
]
},
"num_procs": 0,
"storage_stats": {
},
"cpu_stats": {
"cpu_usage": {
"total_usage": 379075681,
"percpu_usage": [
191355275,
187720406
],
"usage_in_kernelmode": 60000000,
"usage_in_usermode": 310000000
},
"system_cpu_usage": 13977800000000,
"online_cpus": 2,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"precpu_stats": {
"cpu_usage": {
"total_usage": 378825197,
"percpu_usage": [
191104791,
187720406
],
"usage_in_kernelmode": 60000000,
"usage_in_usermode": 310000000
},
"system_cpu_usage": 13975800000000,
"online_cpus": 2,
"throttling_data": {
"periods": 0,
"throttled_periods": 0,
"throttled_time": 0
}
},
"memory_stats": {
"usage": 1814528,
"max_usage": 6299648,
"stats": {
"active_anon": 606208,
"active_file": 0,
"cache": 0,
"dirty": 0,
"hierarchical_memory_limit": 134217728,
"hierarchical_memsw_limit": 268435456,
"inactive_anon": 0,
"inactive_file": 0,
"mapped_file": 0,
"pgfault": 5377,
"pgmajfault": 0,
"pgpgin": 3613,
"pgpgout": 3465,
"rss": 606208,
"rss_huge": 0,
"total_active_anon": 606208,
"total_active_file": 0,
"total_cache": 0,
"total_dirty": 0,
"total_inactive_anon": 0,
"total_inactive_file": 0,
"total_mapped_file": 0,
"total_pgfault": 5377,
"total_pgmajfault": 0,
"total_pgpgin": 3613,
"total_pgpgout": 3465,
"total_rss": 606208,
"total_rss_huge": 0,
"total_unevictable": 0,
"total_writeback": 0,
"unevictable": 0,
"writeback": 0
},
"limit": 134217728
},
"name": "/ecs-curltest-26-curl-c2e5f6e0cf91b0bead01",
"id": "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af",
"networks": {
"eth0": {
"rx_bytes": 84,
"rx_packets": 2,
"rx_errors": 0,
"rx_dropped": 0,
"tx_bytes": 84,
"tx_packets": 2,
"tx_errors": 0,
"tx_dropped": 0
}
},
"network_rate_stats": {
"rx_bytes_per_sec": 0,
"tx_bytes_per_sec": 0
}
}
}
```
# Titik akhir metadata tugas Amazon ECS versi 3
**penting**
Titik akhir metadata tugas versi 3 tidak lagi dipertahankan secara aktif. Kami menyarankan Anda memperbarui titik akhir metadata tugas versi 4 untuk mendapatkan informasi titik akhir metadata terbaru. Untuk informasi selengkapnya, lihat [Titik akhir metadata tugas Amazon ECS versi 4](task-metadata-endpoint-v4.md).
Jika Anda menggunakan tugas Amazon ECS yang dihosting AWS Fargate, lihat [titik akhir metadata tugas Amazon ECS versi 3 untuk](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v3-fargate.html) tugas di Fargate.
Dimulai dengan versi 1.21.0 dari agen kontainer Amazon ECS, agen menyuntikkan variabel lingkungan yang dipanggil `ECS_CONTAINER_METADATA_URI` ke setiap kontainer dalam tugas. Ketika Anda melakukan kueri terhadap titik akhir metadata tugas versi 3, berbagai metadata tugas dan [Statistik Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) tersedia untuk tugas. Untuk tugas yang menggunakan mode jaringan `bridge`, metrik jaringan tersedia ketika melakukan kueri terhadap titik akhir `/stats`.
Fitur titik akhir metadata tugas versi 3 diaktifkan secara default untuk tugas yang menggunakan Fargate pada platform versi v1.3.0 atau yang lebih baru dan tugas yang menggunakan EC2 dan diluncurkan di infrastruktur Amazon EC2 Linux yang menjalankan setidaknya versi 1.21.0 dari agen penampung Amazon ECS atau di infrastruktur Windows Amazon EC2 yang menjalankan setidaknya versi agen kontainer Amazon ECS dan menggunakan mode jaringan. `1.54.0` `awsvpc` Untuk informasi selengkapnya, lihat [Manajemen instans penampung Amazon ECS Linux](manage-linux.md).
Anda dapat menambahkan dukungan untuk fitur ini pada instans kontainer yang lebih lama dengan memperbarui agen ke versi terbaru. Untuk informasi selengkapnya, lihat [Memperbarui agen kontainer Amazon ECS](ecs-agent-update.md).
**penting**
Untuk tugas yang menggunakan Fargate dan versi platform sebelum v1.3.0, titik akhir metadata tugas versi 2 didukung. Untuk informasi selengkapnya, lihat [Titik akhir metadata tugas Amazon ECS versi 2](task-metadata-endpoint-v2.md).
## Jalur titik akhir Metadata Tugas versi 3
Titik akhir metadata tugas berikut tersedia untuk kontainer:
`${ECS_CONTAINER_METADATA_URI}`
Jalur ini mengembalikan JSON metadata untuk kontainer.
`${ECS_CONTAINER_METADATA_URI}/task`
Jalur ini mengembalikan metadata JSON untuk tugas, termasuk daftar wadah IDs dan nama untuk semua kontainer yang terkait dengan tugas. Untuk informasi selengkapnya tentang respons titik akhir ini, lihat [Metadata tugas Amazon ECS v3 respons JSON](task-metadata-endpoint-v3-response.md).
`${ECS_CONTAINER_METADATA_URI}/taskWithTags`
Jalur ini mengembalikan metadata pada tugas yang disertakan dalam titik akhir `/task` selain tugas dan tanda instans kontainer yang dapat diambil menggunakan API `ListTagsForResource`.
`${ECS_CONTAINER_METADATA_URI}/stats`
Jalur ini mengembalikan JSON statistik Docker pada kontainer Docker tertentu. Untuk informasi selengkapnya tentang masing-masing statistik yang dikembalikan, lihat [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)di dokumentasi Docker API.
`${ECS_CONTAINER_METADATA_URI}/task/stats`
Jalur ini mengembalikan JSON statistik Docker untuk semua kontainer yang terkait dengan tugas. Untuk informasi selengkapnya tentang masing-masing statistik yang dikembalikan, lihat [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)di dokumentasi Docker API.
# Metadata tugas Amazon ECS v3 respons JSON
Informasi berikut dikembalikan dari respons JSON titik akhir metadata tugas (`${ECS_CONTAINER_METADATA_URI}/task`).
`Cluster`
Nama Sumber Daya Amazon (ARN) atau nama pendek dari cluster Amazon ECS tempat tugas tersebut berada.
`TaskARN`
Nama Sumber Daya Amazon (ARN) dari tugas yang menjadi milik wadah tersebut.
`Family`
Keluarga definisi tugas Amazon ECS untuk tugas tersebut.
`Revision`
Revisi definisi tugas Amazon ECS untuk tugas tersebut.
`DesiredStatus`
Status yang diinginkan untuk tugas dari Amazon ECS.
`KnownStatus`
Status yang diketahui untuk tugas dari Amazon ECS.
`Limits`
Batas sumber daya yang ditentukan pada tingkat tugas, seperti CPU (dinyatakan dalam vCPUs) dan memori. Parameter ini dihilangkan jika tidak ada batasan sumber daya yang ditentukan.
`PullStartedAt`
Stempel waktu saat penarikan gambar kontainer pertama dimulai.
`PullStoppedAt`
Stempel waktu ketika penarikan gambar kontainer terakhir selesai.
`AvailabilityZone`
Availability Zone tempat tugas berada.
Metadata Availability Zone hanya tersedia untuk tugas Fargate menggunakan platform versi 1.4 atau yang lebih baru (Linux) atau 1.0.0 atau yang lebih baru (Windows).
`Containers`
Daftar metadata kontainer untuk setiap kontainer yang terkait dengan tugas.
`DockerId`
ID Docker untuk wadah.
`Name`
Nama wadah seperti yang ditentukan dalam definisi tugas.
`DockerName`
Nama wadah yang dipasok ke Docker. Agen penampung Amazon ECS menghasilkan nama unik untuk penampung untuk menghindari tabrakan nama saat beberapa salinan dari definisi tugas yang sama dijalankan pada satu instance.
`Image`
Gambar untuk wadah.
`ImageID`
Intisari SHA-256 dari manifes gambar. Ini adalah intisari yang dapat digunakan untuk menarik gambar menggunakan format`repository-url/image@sha256:digest`.
`Ports`
Port apa pun yang terbuka untuk wadah. Parameter ini dihilangkan jika tidak ada port yang terbuka.
`Labels`
Label apa pun diterapkan pada wadah. Parameter ini dihilangkan jika tidak ada label yang diterapkan.
`DesiredStatus`
Status yang diinginkan untuk wadah dari Amazon ECS.
`KnownStatus`
Status yang diketahui untuk wadah dari Amazon ECS.
`ExitCode`
Kode keluar untuk wadah. Parameter ini dihilangkan jika wadah belum keluar.
`Limits`
Batas sumber daya yang ditentukan pada tingkat kontainer, seperti CPU (dinyatakan dalam unit CPU) dan memori. Parameter ini dihilangkan jika tidak ada batasan sumber daya yang ditentukan.
`CreatedAt`
Cap waktu untuk saat wadah dibuat. Parameter ini dihilangkan jika wadah belum dibuat.
`StartedAt`
Cap waktu untuk saat wadah dimulai. Parameter ini dihilangkan jika wadah belum dimulai.
`FinishedAt`
Cap waktu untuk saat wadah berhenti. Parameter ini dihilangkan jika wadah belum berhenti.
`Type`
Jenis wadahnya. Wadah yang ditentukan dalam definisi tugas Anda adalah tipe`NORMAL`. Anda dapat mengabaikan jenis penampung lain, yang digunakan untuk penyediaan sumber daya tugas internal oleh agen penampung Amazon ECS.
`Networks`
Informasi jaringan untuk wadah, seperti mode jaringan dan alamat IP. Parameter ini dihilangkan jika tidak ada informasi jaringan yang didefinisikan.
`ClockDrift`
Informasi tentang perbedaan antara waktu referensi dan waktu sistem. Ini berlaku untuk sistem operasi Linux. Kemampuan ini menggunakan Amazon Time Sync Service untuk mengukur akurasi jam dan memberikan kesalahan jam yang terikat pada kontainer. Untuk informasi selengkapnya, lihat [Mengatur waktu untuk instans Linux Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) di *Panduan Pengguna Amazon EC2 untuk instans Linux*.
`ReferenceTime`
Dasar akurasi jam. Amazon ECS menggunakan standar global Coordinated Universal Time (UTC) melalui NTP, misalnya. `2021-09-07T16:57:44Z`
`ClockErrorBound`
Ukuran kesalahan jam, didefinisikan sebagai offset ke UTC. Kesalahan ini adalah perbedaan milidetik antara waktu referensi dan waktu sistem.
`ClockSynchronizationStatus`
Menunjukkan apakah upaya sinkronisasi terbaru antara waktu sistem dan waktu referensi berhasil.
Nilai yang valid adalah `SYNCHRONIZED` dan ` NOT_SYNCHRONIZED`.
`ExecutionStoppedAt`
Cap waktu untuk saat tugas `DesiredStatus` pindah ke`STOPPED`. Ini terjadi ketika wadah penting bergerak ke`STOPPED`.
# Contoh metadata tugas Amazon ECS v3
Contoh berikut menampilkan output sampel dari titik akhir metadata tugas.
## Respons metadata kontainer contoh
Ketika melakukan kueri terhadap titik akhir `${ECS_CONTAINER_METADATA_URI}`, hanya metadata kontainer tersebut yang dikembalikan kepada Anda. Berikut ini adalah output contoh.
```
{
"DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946",
"Name": "nginx-curl",
"DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901",
"Image": "nrdlngr/nginx-curl",
"ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "nginx-curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 512,
"Memory": 512
},
"CreatedAt": "2018-02-01T20:55:10.554941919Z",
"StartedAt": "2018-02-01T20:55:11.064236631Z",
"Type": "NORMAL",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
}
```
## Respons metadata tugas contoh
Ketika melakukan kueri terhadap titik akhir `${ECS_CONTAINER_METADATA_URI}/task`, metadata dari tugas yang berisi bagian kontainer dikembalikan kepada Anda. Berikut ini adalah output contoh.
Respons JSON berikut adalah untuk tugas kontainer tunggal.
```
{
"Cluster": "default",
"TaskARN": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"Family": "nginx",
"Revision": "5",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Containers": [
{
"DockerId": "731a0d6a3b4210e2448339bc7015aaa79bfe4fa256384f4102db86ef94cbbc4c",
"Name": "~internal~ecs~pause",
"DockerName": "ecs-nginx-5-internalecspause-acc699c0cbf2d6d11700",
"Image": "amazon/amazon-ecs-pause:0.1.0",
"ImageID": "",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "~internal~ecs~pause",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RESOURCES_PROVISIONED",
"KnownStatus": "RESOURCES_PROVISIONED",
"Limits": {
"CPU": 0,
"Memory": 0
},
"CreatedAt": "2018-02-01T20:55:08.366329616Z",
"StartedAt": "2018-02-01T20:55:09.058354915Z",
"Type": "CNI_PAUSE",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
},
{
"DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946",
"Name": "nginx-curl",
"DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901",
"Image": "nrdlngr/nginx-curl",
"ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "nginx-curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 512,
"Memory": 512
},
"CreatedAt": "2018-02-01T20:55:10.554941919Z",
"StartedAt": "2018-02-01T20:55:11.064236631Z",
"Type": "NORMAL",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
}
],
"PullStartedAt": "2018-02-01T20:55:09.372495529Z",
"PullStoppedAt": "2018-02-01T20:55:10.552018345Z",
"AvailabilityZone": "us-east-2b"
}
```
# Titik akhir metadata tugas Amazon ECS versi 2
**penting**
Titik akhir metadata tugas versi 2 tidak lagi dipertahankan secara aktif. Kami menyarankan Anda memperbarui titik akhir metadata tugas versi 4 untuk mendapatkan informasi titik akhir metadata terbaru. Untuk informasi selengkapnya, lihat [Titik akhir metadata tugas Amazon ECS versi 4](task-metadata-endpoint-v4.md).
Dimulai dengan versi 1.17.0 dari agen penampung Amazon ECS, berbagai metadata tugas dan [statistik Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) tersedia untuk tugas yang menggunakan mode `awsvpc` jaringan pada titik akhir HTTP yang disediakan oleh agen penampung Amazon ECS.
Semua kontainer milik tugas yang diluncurkan dengan mode `awsvpc` jaringan menerima IPv4 alamat lokal dalam rentang alamat link-lokal yang telah ditentukan. Saat kontainer menanyakan titik akhir metadata, agen penampung Amazon ECS dapat menentukan tugas mana yang dimiliki penampung berdasarkan alamat IP uniknya, serta metadata serta statistik untuk tugas tersebut dikembalikan.
## Mengaktifkan metadata tugas
**penting**
Titik akhir metadata tugas versi 2 tidak lagi dipertahankan secara aktif. Kami menyarankan Anda memperbarui titik akhir metadata tugas versi 4 untuk mendapatkan informasi titik akhir metadata terbaru. Untuk informasi selengkapnya, lihat [Titik akhir metadata tugas Amazon ECS versi 4](task-metadata-endpoint-v4.md).
Dimulai dengan versi 1.17.0 dari agen penampung Amazon ECS, berbagai metadata tugas dan [statistik Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) tersedia untuk tugas yang menggunakan mode `awsvpc` jaringan pada titik akhir HTTP yang disediakan oleh agen penampung Amazon ECS.
Semua kontainer milik tugas yang diluncurkan dengan mode `awsvpc` jaringan menerima IPv4 alamat lokal dalam rentang alamat link-lokal yang telah ditentukan. Saat kontainer menanyakan titik akhir metadata, agen penampung Amazon ECS dapat menentukan tugas mana yang dimiliki penampung berdasarkan alamat IP uniknya, serta metadata serta statistik untuk tugas tersebut dikembalikan.
### Mengaktifkan metadata tugas
Fitur metadata tugas versi 2 diaktifkan secara default untuk hal berikut:
+ Tugas menggunakan Fargate yang menggunakan platform versi v1.1.0 atau yang lebih baru. Untuk informasi selengkapnya, lihat [Versi platform Fargate untuk Amazon ECS](platform-fargate.md).
+ Tugas menggunakan EC2 yang juga menggunakan mode `awsvpc` jaringan dan diluncurkan pada infrastruktur Amazon EC2 Linux yang menjalankan setidaknya versi 1.17.0 dari agen penampung Amazon ECS atau di infrastruktur Windows Amazon EC2 yang menjalankan setidaknya `1.54.0` versi agen penampung Amazon ECS. Untuk informasi selengkapnya, lihat [Manajemen instans penampung Amazon ECS Linux](manage-linux.md).
Anda dapat menambahkan dukungan untuk fitur ini pada instans kontainer yang lebih lama dengan memperbarui agen ke versi terbaru. Untuk informasi selengkapnya, lihat [Memperbarui agen kontainer Amazon ECS](ecs-agent-update.md).
### Jalur titik akhir metadata tugas
Titik akhir API berikut tersedia untuk kontainer:
`169.254.170.2/v2/metadata`
Titik akhir ini mengembalikan metadata JSON untuk tugas, termasuk daftar penampung IDs dan nama untuk semua kontainer yang terkait dengan tugas. Untuk informasi selengkapnya tentang respons titik akhir ini, lihat [Respons JSON metadata tugas](#task-metadata-endpoint-v2-response).
`169.254.170.2/v2/metadata/`
Titik akhir ini mengembalikan JSON metadata untuk ID kontainer Docker ditentukan.
`169.254.170.2/v2/metadata/taskWithTags`
Jalur ini mengembalikan metadata pada tugas yang disertakan dalam titik akhir `/task` selain tugas dan tanda instans kontainer yang dapat diambil menggunakan API `ListTagsForResource`.
`169.254.170.2/v2/stats`
Titik akhir ini mengembalikan JSON statistik Docker pada semua kontainer yang terkait dengan tugas. Untuk informasi selengkapnya tentang masing-masing statistik yang dikembalikan, lihat [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)di dokumentasi Docker API.
`169.254.170.2/v2/stats/`
Titik akhir ini mengembalikan JSON statistik Docker untuk ID kontainer Docker tertentu. Untuk informasi selengkapnya tentang masing-masing statistik yang dikembalikan, lihat [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)di dokumentasi Docker API.
### Respons JSON metadata tugas
Informasi berikut dikembalikan dari respons JSON titik akhir metadata tugas (`169.254.170.2/v2/metadata`).
`Cluster`
Nama Sumber Daya Amazon (ARN) atau nama pendek dari cluster Amazon ECS tempat tugas tersebut berada.
`TaskARN`
Nama Sumber Daya Amazon (ARN) dari tugas yang menjadi milik wadah tersebut.
`Family`
Keluarga definisi tugas Amazon ECS untuk tugas tersebut.
`Revision`
Revisi definisi tugas Amazon ECS untuk tugas tersebut.
`DesiredStatus`
Status yang diinginkan untuk tugas dari Amazon ECS.
`KnownStatus`
Status yang diketahui untuk tugas dari Amazon ECS.
`Limits`
Batas sumber daya yang ditentukan pada tingkat tugas, seperti CPU (dinyatakan dalam vCPUs) dan memori. Parameter ini dihilangkan jika tidak ada batasan sumber daya yang ditentukan.
`PullStartedAt`
Stempel waktu saat penarikan gambar kontainer pertama dimulai.
`PullStoppedAt`
Stempel waktu ketika penarikan gambar kontainer terakhir selesai.
`AvailabilityZone`
Availability Zone tempat tugas berada.
Metadata Availability Zone hanya tersedia untuk tugas Fargate menggunakan platform versi 1.4 atau yang lebih baru (Linux) atau 1.0.0 atau yang lebih baru (Windows).
`Containers`
Daftar metadata kontainer untuk setiap kontainer yang terkait dengan tugas.
`DockerId`
ID Docker untuk wadah.
`Name`
Nama wadah seperti yang ditentukan dalam definisi tugas.
`DockerName`
Nama wadah yang dipasok ke Docker. Agen penampung Amazon ECS menghasilkan nama unik untuk penampung untuk menghindari tabrakan nama saat beberapa salinan dari definisi tugas yang sama dijalankan pada satu instance.
`Image`
Gambar untuk wadah.
`ImageID`
Intisari SHA-256 dari manifes gambar. Ini adalah intisari yang dapat digunakan untuk menarik gambar menggunakan format`repository-url/image@sha256:digest`.
`Ports`
Port apa pun yang terbuka untuk wadah. Parameter ini dihilangkan jika tidak ada port yang terbuka.
`Labels`
Label apa pun diterapkan pada wadah. Parameter ini dihilangkan jika tidak ada label yang diterapkan.
`DesiredStatus`
Status yang diinginkan untuk wadah dari Amazon ECS.
`KnownStatus`
Status yang diketahui untuk wadah dari Amazon ECS.
`ExitCode`
Kode keluar untuk wadah. Parameter ini dihilangkan jika wadah belum keluar.
`Limits`
Batas sumber daya yang ditentukan pada tingkat kontainer, seperti CPU (dinyatakan dalam unit CPU) dan memori. Parameter ini dihilangkan jika tidak ada batasan sumber daya yang ditentukan.
`CreatedAt`
Cap waktu untuk saat wadah dibuat. Parameter ini dihilangkan jika wadah belum dibuat.
`StartedAt`
Cap waktu untuk saat wadah dimulai. Parameter ini dihilangkan jika wadah belum dimulai.
`FinishedAt`
Cap waktu untuk saat wadah berhenti. Parameter ini dihilangkan jika wadah belum berhenti.
`Type`
Jenis wadahnya. Wadah yang ditentukan dalam definisi tugas Anda adalah tipe`NORMAL`. Anda dapat mengabaikan jenis penampung lain, yang digunakan untuk penyediaan sumber daya tugas internal oleh agen penampung Amazon ECS.
`Networks`
Informasi jaringan untuk wadah, seperti mode jaringan dan alamat IP. Parameter ini dihilangkan jika tidak ada informasi jaringan yang didefinisikan.
`ClockDrift`
Informasi tentang perbedaan antara waktu referensi dan waktu sistem. Ini berlaku untuk sistem operasi Linux. Kemampuan ini menggunakan Amazon Time Sync Service untuk mengukur akurasi jam dan memberikan kesalahan jam yang terikat pada kontainer. Untuk informasi selengkapnya, lihat [Mengatur waktu untuk instans Linux Anda](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) di *Panduan Pengguna Amazon EC2 untuk instans Linux*.
`ReferenceTime`
Dasar akurasi jam. Amazon ECS menggunakan standar global Coordinated Universal Time (UTC) melalui NTP, misalnya. `2021-09-07T16:57:44Z`
`ClockErrorBound`
Ukuran kesalahan jam, didefinisikan sebagai offset ke UTC. Kesalahan ini adalah perbedaan milidetik antara waktu referensi dan waktu sistem.
`ClockSynchronizationStatus`
Menunjukkan apakah upaya sinkronisasi terbaru antara waktu sistem dan waktu referensi berhasil.
Nilai yang valid adalah `SYNCHRONIZED` dan ` NOT_SYNCHRONIZED`.
`ExecutionStoppedAt`
Cap waktu untuk saat tugas `DesiredStatus` pindah ke`STOPPED`. Ini terjadi ketika wadah penting bergerak ke`STOPPED`.
### Respons metadata tugas contoh
Respons JSON berikut adalah untuk tugas kontainer tunggal.
```
{
"Cluster": "default",
"TaskARN": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"Family": "nginx",
"Revision": "5",
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Containers": [
{
"DockerId": "731a0d6a3b4210e2448339bc7015aaa79bfe4fa256384f4102db86ef94cbbc4c",
"Name": "~internal~ecs~pause",
"DockerName": "ecs-nginx-5-internalecspause-acc699c0cbf2d6d11700",
"Image": "amazon/amazon-ecs-pause:0.1.0",
"ImageID": "",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "~internal~ecs~pause",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RESOURCES_PROVISIONED",
"KnownStatus": "RESOURCES_PROVISIONED",
"Limits": {
"CPU": 0,
"Memory": 0
},
"CreatedAt": "2018-02-01T20:55:08.366329616Z",
"StartedAt": "2018-02-01T20:55:09.058354915Z",
"Type": "CNI_PAUSE",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
},
{
"DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946",
"Name": "nginx-curl",
"DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901",
"Image": "nrdlngr/nginx-curl",
"ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165",
"Labels": {
"com.amazonaws.ecs.cluster": "default",
"com.amazonaws.ecs.container-name": "nginx-curl",
"com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3",
"com.amazonaws.ecs.task-definition-family": "nginx",
"com.amazonaws.ecs.task-definition-version": "5"
},
"DesiredStatus": "RUNNING",
"KnownStatus": "RUNNING",
"Limits": {
"CPU": 512,
"Memory": 512
},
"CreatedAt": "2018-02-01T20:55:10.554941919Z",
"StartedAt": "2018-02-01T20:55:11.064236631Z",
"Type": "NORMAL",
"Networks": [
{
"NetworkMode": "awsvpc",
"IPv4Addresses": [
"10.0.2.106"
]
}
]
}
],
"PullStartedAt": "2018-02-01T20:55:09.372495529Z",
"PullStoppedAt": "2018-02-01T20:55:10.552018345Z",
"AvailabilityZone": "us-east-2b"
}
```