Titik akhir metadata tugas versi 3

penting

Titik akhir metadata tugas versi 3 tidak lagi dipelihara secara aktif. Sebaiknya perbarui endpoint metadata tugas versi 4 untuk mendapatkan informasi endpoint metadata terbaru. Untuk informasi selengkapnya, lihat Titik akhir metadata tugas versi 4.

Dimulai dengan versi platform Fargate1.1.0, sebuah variabel lingkungan bernamaECS_CONTAINER_METADATA_URI dimasukkan 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.

Mengaktifkan Metadata Tugas

Fitur titik akhir metadata tugas diaktifkan secara default untuk tugas Amazon ECS yang di-host di Fargate yang menggunakan versi platform1.1.0 atau yang lebih baru. Untuk informasi selengkapnya, lihat AWSVersi platform Fargate.

Jalur Titik Akhir Metadata Tugas

Titik akhir API 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 Respons JSON Metadata Tugas.

${ECS_CONTAINER_METADATA_URI}/stats

Jalur ini mengembalikan JSON statistik Docker untuk kontainer Docker tertentu. Untuk informasi selengkapnya tentang masing-masing statistik yang dikembalikan, lihat ContainerStatsdalam dokumentasi API Docker.

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

Respons JSON Metadata Tugas

Informasi berikut dikembalikan dari respons JSON titik akhir metadata tugas (${ECS_CONTAINER_METADATA_URI}/task).

Cluster

Amazon Resource Name (ARN) atau nama pendek dari klaster Amazon ECS tempat tugas menjadi bagiannya.

TaskARN

Nama lrngkap Amazon Resource Name (ARN) dari tugas milik kontainer.

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 dikenal untuk tugas dari Amazon ECS.

Limits

Batas sumber daya yang ditentukan pada tingkat tugas (seperti CPU dan memori). Parameter ini dihilangkan jika tidak ada batasan sumber daya yang ditentukan.

PullStartedAt

Stempel waktu ketika tarikan gambar kontainer pertama dimulai.

PullStoppedAt

Stempel waktu ketika gambar kontainer terakhir menarik selesai.

AvailabilityZone

Availability Zone tugas berada di.

catatan

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 kontainer.

Name

Nama kontainer seperti yang ditentukan dalam ketentuan tugas.

DockerName

Nama wadah yang dipasok ke Docker. Agen kontainer Amazon ECS menghasilkan nama unik untuk kontainer untuk menghindari tabrakan nama ketika beberapa salinan definisi tugas yang sama dijalankan pada satu instans.

Image

Citra untuk kontainer.

ImageID

Intisari SHA-256 untuk gambar.

Ports

Port apa pun yang terbuka untuk kontainer. Parameter ini dihilangkan jika tidak ada port yang terbuka.

Labels

Label apa pun yang diterapkan pada wadah. Parameter ini dihilangkan jika tidak ada label yang diterapkan.

DesiredStatus

Status yang diinginkan untuk kontainer dari Amazon ECS.

KnownStatus

Status yang dikenal untuk kontainer 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 dan memori). Parameter ini dihilangkan jika tidak ada batasan sumber daya yang ditentukan.

CreatedAt

Cap waktu saat kontainer dibuat. Parameter ini dihilangkan jika kontainer belum dibuat.

StartedAt

Cap waktu saat kontainer dimulai. Parameter ini dihilangkan jika kontainer belum dimulai.

FinishedAt

Cap waktu saat kontainer berhenti. Parameter ini dihilangkan jika kontainer belum berhenti.

Type

Jenis kontainer. Kontainer yang ditentukan dalam ketentuan tugas Anda adalah tipeNORMAL. Anda dapat mengabaikan jenis kontainer lain, yang digunakan untuk penyediaan sumber daya tugas internal oleh agen kontainer Amazon ECS.

Networks

Informasi jaringan untuk kontainer, 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.

ReferenceTime

Dasar akurasi jam. Amazon ECS menggunakan standar global Coordinated Universal Time (UTC) melalui NTP, misalnya2021-09-07T16:57:44Z.

ClockErrorBound

Ukuran kesalahan jam, didefinisikan sebagai offset ke UTC. Kesalahan ini adalah perbedaan dalam 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 ketika tugasDesiredStatus pindah keSTOPPED. Hal ini terjadi ketika wadah penting pindah keSTOPPED.

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"
}