View a markdown version of this page

CreateDatasetExportJob - 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.

CreateDatasetExportJob

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 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, 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

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

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

datasetArn

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

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

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

Jalur ke bucket Amazon S3 tempat output pekerjaan disimpan.

Tipe: Objek DatasetExportJobOutput

Wajib: Ya

roleArn

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

Daftar tag yang akan diterapkan pada pekerjaan ekspor dataset.

Tipe: Array objek Tag

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

Wajib: Tidak

Sintaksis Respons

{
   "datasetExportJobArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

datasetExportJobArn

Nama Sumber Daya Amazon (ARN) dari pekerjaan ekspor dataset.

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: