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.
Sintaks Permintaan
POST /task HTTP/1.1
Content-type: application/json
{
"clientToken": "string",
"command": { ... },
"description": "string",
"tags": {
"string" : "string"
},
"targets": [ "string" ]
}URIParameter Permintaan
Permintaan tidak menggunakan URI parameter apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam JSON format.
- clientToken
-
Token yang memastikan bahwa tindakan dipanggil hanya sekali dengan detail yang ditentukan.
Tipe: 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.
Tipe: 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 berbagai cara, seperti berdasarkan tujuan, pemilik, atau lingkungan.
Tipe: Peta antar string
Wajib: Tidak
- targets
-
Daftar perangkat yang dikelolaIDs.
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.
Data berikut dikembalikan dalam JSON format oleh layanan.
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- AccessDeniedException
-
Anda tidak memiliki akses yang cukup untuk melakukan tindakan ini.
HTTPKode Status: 403
- InternalServerException
-
Terjadi kesalahan tak terduga saat memproses permintaan.
HTTPKode Status: 500
- ResourceNotFoundException
-
Permintaan mereferensikan sumber daya yang tidak ada.
HTTPKode Status: 404
- ServiceQuotaExceededException
-
Permintaan akan menyebabkan kuota layanan terlampaui.
HTTPKode Status: 402
- ThrottlingException
-
Permintaan ditolak karena throttling permintaan.
HTTPKode Status: 429
- ValidationException
-
Input gagal memenuhi kendala yang ditentukan oleh layanan. AWS
HTTPKode Status: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
