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.

Jika Anda menggunakan tugas Amazon ECS yang dihosting AWS Fargate, lihat Titik akhir metadata tugas versi 3 di Panduan Pengguna Layanan Amazon Elastic Container untuk. AWS 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 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 jenis peluncuran Fargate pada platform versi v1.3.0 atau yang lebih baru dan tugas yang menggunakan tipe peluncuran 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 penampung Amazon ECS dan menggunakan mode jaringan. 1.54.0 awsvpc Untuk informasi selengkapnya, lihat Manajemen instans wadah Amazon ECS Linux.

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.

penting

Untuk tugas yang menggunakan tipe peluncuran 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.

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 JSON metadata untuk tugas, termasuk daftar ID kontainer dan nama semua kontainer yang terkait dengan tugas. Untuk informasi selengkapnya tentang respons titik akhir ini, lihat Metadata tugas Amazon ECS v3 respons JSON.

${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 ContainerStatsdi 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 ContainerStatsdi dokumentasi Docker API.