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

# CreateDatasetExportJob
<a name="API_CreateDatasetExportJob"></a>

 Membuat pekerjaan yang mengekspor data dari dataset Anda ke bucket Amazon S3. Untuk mengizinkan Amazon Personalize mengekspor data pelatihan, Anda harus menentukan peran IAM terkait layanan yang memberikan `PutObject` izin Amazon Personalize untuk bucket Amazon S3 Anda. Untuk informasi, lihat Meng [ ekspor kumpulan data ](https://docs.aws.amazon.com/personalize/latest/dg/export-data.html) di panduan pengembang Amazon Personalisasi. 

 **Status ** 

Pekerjaan ekspor dataset dapat berada di salah satu status berikut:
+ BUAT TERTUNDA > BUAT IN\_PROGRESS > AKTIF -atau- BUAT GAGAL

 Untuk mendapatkan status pekerjaan ekspor, panggil [ DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html), dan tentukan Nama Sumber Daya Amazon (ARN) dari pekerjaan ekspor dataset. Ekspor dataset selesai ketika status ditampilkan sebagai AKTIF. Jika status ditampilkan sebagai CREATE FAILED, respons menyertakan `failureReason` kunci, yang menjelaskan mengapa pekerjaan gagal. 

## Sintaksis Permintaan
<a name="API_CreateDatasetExportJob_RequestSyntax"></a>

```
{
   "datasetArn": "{{string}}",
   "ingestionMode": "{{string}}",
   "jobName": "{{string}}",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "{{string}}",
         "path": "{{string}}"
      }
   },
   "roleArn": "{{string}}",
   "tags": [ 
      { 
         "tagKey": "{{string}}",
         "tagValue": "{{string}}"
      }
   ]
}
```

## Parameter Permintaan
<a name="API_CreateDatasetExportJob_RequestParameters"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [datasetArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-datasetArn"></a>
Nama Sumber Daya Amazon (ARN) dari dataset yang berisi data untuk diekspor.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Ya

 ** [ingestionMode](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-ingestionMode"></a>
Data yang akan diekspor, berdasarkan cara Anda mengimpor data. Anda dapat memilih untuk mengekspor hanya `BULK` data yang Anda impor menggunakan tugas impor dataset, hanya `PUT` data yang Anda impor secara bertahap (menggunakan konsol, PutEvents, PutUsers dan PutItems operasi), atau `ALL` untuk kedua jenis. Nilai default-nya adalah `PUT`.   
Tipe: String  
Nilai yang Valid: `BULK | PUT | ALL`   
Wajib: Tidak

 ** [jobName](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobName"></a>
Nama untuk pekerjaan ekspor dataset.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.  
Pola: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Wajib: Ya

 ** [jobOutput](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobOutput"></a>
Jalur ke bucket Amazon S3 tempat output pekerjaan disimpan.  
Tipe: Objek [DatasetExportJobOutput](API_DatasetExportJobOutput.md)  
Wajib: Ya

 ** [roleArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-roleArn"></a>
Nama Sumber Daya Amazon (ARN) dari peran layanan IAM yang memiliki izin untuk menambahkan data ke bucket Amazon S3 keluaran Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Wajib: Ya

 ** [tags](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-tags"></a>
Daftar [ tag yang ](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) akan diterapkan pada pekerjaan ekspor dataset.  
Tipe: Array objek [Tag](API_Tag.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.  
Wajib: Tidak

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

```
{
   "datasetExportJobArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [datasetExportJobArn](#API_CreateDatasetExportJob_ResponseSyntax) **   <a name="personalize-CreateDatasetExportJob-response-datasetExportJobArn"></a>
Nama Sumber Daya Amazon (ARN) dari pekerjaan ekspor dataset.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Berikan nilai yang valid untuk bidang atau parameter.  
Kode Status HTTP: 400

 ** LimitExceededException **   
Batas jumlah permintaan per detik telah terlampaui.  
Kode Status HTTP: 400

 ** ResourceAlreadyExistsException **   
Sumber daya yang ditentukan sudah ada.  
Kode Status HTTP: 400

 ** ResourceInUseException **   
Sumber daya yang ditentukan sedang digunakan.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Tidak dapat menemukan sumber daya yang ditentukan.  
Kode Status HTTP: 400

 ** TooManyTagsException **   
Anda telah melampaui jumlah tag maksimum yang dapat Anda terapkan ke sumber daya ini.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_CreateDatasetExportJob_SeeAlso"></a>

Untuk informasi selengkapnya tentang menggunakan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2 ](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK untuk.NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK untuk C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK untuk Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK untuk Java V2 ](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK untuk JavaScript V3 ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Kotlin ](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK untuk Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetExportJob)