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

# CreateDataDeletionJob
<a name="API_CreateDataDeletionJob"></a>

Membuat pekerjaan batch yang menghapus semua referensi ke pengguna tertentu dari grup kumpulan data Amazon Personalize dalam batch. Anda menentukan pengguna yang akan dihapus dalam file CSV UserIds di bucket Amazon S3. Setelah pekerjaan selesai, Amazon Personalize tidak lagi melatih data pengguna dan tidak lagi mempertimbangkan pengguna saat membuat segmen pengguna. Untuk informasi selengkapnya tentang membuat pekerjaan penghapusan data, lihat [Menghapus](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html) pengguna.
+ File input Anda harus berupa file CSV dengan kolom USER\$1ID tunggal yang mencantumkan pengguna. IDs Untuk informasi selengkapnya tentang menyiapkan file CSV, lihat [Mempersiapkan file penghapusan data Anda dan mengunggahnya ke Amazon](https://docs.aws.amazon.com/personalize/latest/dg/prepare-deletion-input-file.html) S3.
+ Untuk memberikan izin Amazon Personalize untuk mengakses file CSV input userIds, Anda harus menentukan peran layanan IAM yang memiliki izin untuk membaca dari sumber data. Peran ini membutuhkan `GetObject` dan `ListBucket` izin untuk bucket dan kontennya. Izin ini sama dengan mengimpor data. Untuk informasi tentang pemberian akses ke bucket Amazon S3, [lihat Memberikan Amazon Personalisasi Akses ke Sumber Daya Amazon](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html) S3. 

 Setelah Anda membuat pekerjaan, dibutuhkan waktu hingga satu hari untuk menghapus semua referensi ke pengguna dari kumpulan data dan model. Sampai pekerjaan selesai, Amazon Personalize terus menggunakan data saat pelatihan. Dan jika Anda menggunakan resep Segmentasi Pengguna, pengguna mungkin muncul di segmen pengguna. 

 **Status** 

Pekerjaan penghapusan data dapat memiliki salah satu status berikut:
+ TERTUNDA > IN\$1PROGRESS> SELESAI -atau- GAGAL

Untuk mendapatkan status pekerjaan penghapusan data, panggil operasi [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html)API dan tentukan Nama Sumber Daya Amazon (ARN) pekerjaan tersebut. Jika statusnya GAGAL, respons menyertakan `failureReason` kunci, yang menjelaskan mengapa pekerjaan gagal.

**Terkait APIs**
+  [ListDataDeletionJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDataDeletionJobs.html) 
+  [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) 

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

```
{
   "datasetGroupArn": "string",
   "dataSource": { 
      "dataLocation": "string"
   },
   "jobName": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

Permintaan menerima data berikut dalam format JSON.

 ** [datasetGroupArn](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-datasetGroupArn"></a>
Nama Sumber Daya Amazon (ARN) dari grup kumpulan data yang memiliki kumpulan data yang ingin Anda hapus catatan.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Ya

 ** [dataSource](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-dataSource"></a>
Bucket Amazon S3 yang berisi daftar userIds pengguna yang akan dihapus.  
Tipe: Objek [DataSource](API_DataSource.md)  
Wajib: Ya

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

 ** [roleArn](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-roleArn"></a>
Nama Sumber Daya Amazon (ARN) dari peran IAM yang memiliki izin untuk membaca dari sumber data Amazon S3.  
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_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-tags"></a>
Daftar [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) untuk diterapkan ke pekerjaan penghapusan data.  
Tipe: Array objek [Tag](API_Tag.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.  
Wajib: Tidak

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

```
{
   "dataDeletionJobArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [dataDeletionJobArn](#API_CreateDataDeletionJob_ResponseSyntax) **   <a name="personalize-CreateDataDeletionJob-response-dataDeletionJobArn"></a>
Nama Sumber Daya Amazon (ARN) dari pekerjaan penghapusan data.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Kesalahan
<a name="API_CreateDataDeletionJob_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 maksimum tag yang dapat Anda terapkan ke sumber daya ini.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_CreateDataDeletionJob_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/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataDeletionJob)