Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
DescribeTask
Memeriksa metadata untuk tugas yang diberikan pada perangkat.
Minta Sintaks
POST /task/taskId
HTTP/1.1
Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
- taskId
-
ID tugas yang akan dijelaskan.
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Wajib: Ya
Isi Permintaan
Permintaan tidak memiliki isi permintaan.
Sintaks Respons
HTTP/1.1 200
Content-type: application/json
{
"completedAt": number,
"createdAt": number,
"description": "string",
"lastUpdatedAt": number,
"state": "string",
"tags": {
"string" : "string"
},
"targets": [ "string" ],
"taskArn": "string",
"taskId": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- completedAt
-
Ketika tugas selesai.
Tipe: Timestamp
- createdAt
-
Ketika
CreateTask
operasi dipanggil.Tipe: Timestamp
- description
-
Deskripsi yang diberikan tentang tugas dan perangkat yang dikelola.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola:
[A-Za-z0-9 _.,!#]*
- lastUpdatedAt
-
Ketika status tugas terakhir diperbarui.
Tipe: Timestamp
- state
-
Keadaan tugas saat ini.
Jenis: String
Nilai yang Valid:
IN_PROGRESS | CANCELED | COMPLETED
-
Metadata opsional yang Anda tetapkan ke sumber daya. Anda dapat menggunakan tag untuk mengkategorikan sumber daya dengan berbagai cara, seperti berdasarkan tujuan, pemilik, atau lingkungan.
Tipe: Peta string ke string
- targets
-
Perangkat terkelola tempat tugas dikirim.
Tipe: Array string
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 10 item.
- taskArn
-
Amazon Resource Name (ARN) tugas.
Jenis: String
- taskId
-
ID tugas.
Jenis: String
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- AccessDeniedException
-
Anda tidak memiliki akses yang cukup untuk melakukan tindakan ini.
Kode Status HTTP: 403
- InternalServerException
-
Terjadi kesalahan tak terduga saat memproses permintaan.
Kode Status HTTP: 500
- ResourceNotFoundException
-
Permintaan mereferensikan sumber daya yang tidak ada.
Kode Status HTTP: 404
- ThrottlingException
-
Permintaan ditolak karena throttling permintaan.
Kode Status HTTP: 429
- ValidationException
-
Input gagal memenuhi kendala yang ditentukan oleh layanan. AWS
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: