Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# CreateTask
<a name="API_devicemanagement_CreateTask"></a>

Menginstruksikan satu atau beberapa perangkat untuk memulai tugas, seperti membuka kunci atau me-reboot.

## Minta Sintaks
<a name="API_devicemanagement_CreateTask_RequestSyntax"></a>

```
POST /task HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "command": { ... },
   "description": "string",
   "tags": { 
      "string" : "string" 
   },
   "targets": [ "string" ]
}
```

## Parameter Permintaan URI
<a name="API_devicemanagement_CreateTask_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_devicemanagement_CreateTask_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [clientToken](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-clientToken"></a>
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](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-command"></a>
Tugas yang harus dilakukan. Hanya satu tugas yang dijalankan pada perangkat pada satu waktu.  
Tipe: Objek [Command](API_devicemanagement_Command.md)  
 **Catatan:** Objek ini adalah Union. Hanya satu anggota objek ini yang dapat ditentukan atau dikembalikan.  
Wajib: Ya

 ** [description](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-description"></a>
Deskripsi tugas dan targetnya.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.  
Pola: `[A-Za-z0-9 _.,!#]*`   
Wajib: Tidak

 ** [tags](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-tags"></a>
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](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-targets"></a>
Daftar perangkat terkelola IDs.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 10 item.  
Wajib: Ya

## Sintaksis Respons
<a name="API_devicemanagement_CreateTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "taskArn": "string",
   "taskId": "string"
}
```

## Elemen Respons
<a name="API_devicemanagement_CreateTask_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [taskArn](#API_devicemanagement_CreateTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_CreateTask-response-taskArn"></a>
Nama Sumber Daya Amazon (ARN) dari tugas yang Anda buat.  
Tipe: String

 ** [taskId](#API_devicemanagement_CreateTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_CreateTask-response-taskId"></a>
ID tugas yang Anda buat.  
Tipe: String

## Kesalahan
<a name="API_devicemanagement_CreateTask_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** 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
<a name="API_devicemanagement_CreateTask_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snow-device-management-2021-08-04/CreateTask)