View a markdown version of this page

CreateDataDeletionJob - Amazon Personalize
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

CreateDataDeletionJob

Membuat pekerjaan batch yang menghapus semua referensi ke pengguna tertentu dari grup dataset Amazon Personalize secara batch. Anda menentukan pengguna yang akan dihapus dalam file CSV UserID 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 pengguna.

  • File input Anda harus berupa file CSV dengan kolom USER_ID tunggal yang mencantumkan ID pengguna. Untuk informasi selengkapnya tentang menyiapkan file CSV, lihat Mempersiapkan file penghapusan data dan mengunggahnya ke Amazon S3.

  • Untuk memberikan izin Amazon Personalize untuk mengakses file CSV input UserID Anda, Anda harus menentukan peran layanan IAM yang memiliki izin untuk membaca dari sumber data. Peran ini membutuhkan GetObject dan ListBucket izin untuk bucket dan isinya. Izin ini sama dengan mengimpor data. Untuk informasi tentang pemberian akses ke bucket Amazon S3 Anda, lihat Mem berikan Akses Personalisasi Amazon ke Sumber Daya Amazon S3.

Setelah Anda membuat pekerjaan, diperlukan 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:

  • MENUNGGU > IN_PROGRESS > SELESAI -atau- GAGAL

Untuk mendapatkan status pekerjaan penghapusan data, panggil operasi DescribeDataDeletionJob API dan tentukan Nama Sumber Daya Amazon (ARN) dari pekerjaan tersebut. Jika statusnya GAGAL, respons menyertakan failureReason kunci, yang menjelaskan mengapa pekerjaan gagal.

API Terkait

Sintaksis Permintaan

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

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

datasetGroupArn

Nama Sumber Daya Amazon (ARN) dari grup dataset yang memiliki kumpulan data yang ingin Anda hapus catatannya.

Tipe: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Wajib: Ya

dataSource

Bucket Amazon S3 yang berisi daftar userID pengguna yang akan dihapus.

Tipe: Objek DataSource

Wajib: Ya

jobName

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

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

Daftar tag untuk diterapkan pada pekerjaan penghapusan data.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.

Wajib: Tidak

Sintaksis Respons

{
   "dataDeletionJobArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

dataDeletionJobArn

Nama Sumber Daya Amazon (ARN) dari pekerjaan penghapusan data.

Tipe: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Kesalahan

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

Untuk informasi selengkapnya tentang menggunakan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: