Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateTask
Menginstruksikan satu atau beberapa perangkat untuk memulai tugas, seperti membuka kunci atau me-reboot.
Minta Sintaks
POST /task HTTP/1.1
Content-type: application/json
{
"clientToken": "string",
"command": { ... },
"description": "string",
"tags": {
"string" : "string"
},
"targets": [ "string" ]
}Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- clientToken
-
Token yang memastikan bahwa tindakan dipanggil hanya sekali dengan detail yang ditentukan.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola:
[!-~]+Wajib: Tidak
- command
-
Tugas yang harus dilakukan. Hanya satu tugas yang dijalankan pada perangkat pada satu waktu.
Tipe: Objek Command
Catatan: Objek ini adalah Union. Hanya satu anggota objek ini yang dapat ditentukan atau dikembalikan.
Wajib: Ya
- description
-
Deskripsi tugas dan targetnya.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola:
[A-Za-z0-9 _.,!#]*Wajib: Tidak
-
Metadata opsional yang Anda tetapkan ke sumber daya. Anda dapat menggunakan tag untuk mengkategorikan sumber daya dengan cara yang berbeda, seperti berdasarkan tujuan, pemilik, atau lingkungan.
Tipe: Peta antar string
Wajib: Tidak
- targets
-
Daftar ID perangkat terkelola.
Tipe: Array string
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 10 item.
Wajib: Ya
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"taskArn": "string",
"taskId": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
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
- ServiceQuotaExceededException
-
Permintaan akan menyebabkan kuota layanan terlampaui.
Kode Status HTTP: 402
- 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:
