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 kumpulan data Anda ke bucket Amazon S3. Untuk mengizinkan Amazon Personalize mengekspor data pelatihan, Anda harus menentukan peran IAM terkait layanan yang memberikan izin Amazon PutObject
Personalize untuk bucket Amazon S3 Anda. Untuk selengkapnya, lihat Mengekspor kumpulan data di panduan developer Amazon Personalize.
Status
Pekerjaan ekspor dataset dapat berada di salah satu negara bagian berikut:
-
BUAT TERTUNDA > BUAT IN_PROGRESS> AKTIF -atau- BUAT GAGAL
Untuk mendapatkan status pekerjaan ekspor, hubungi DescribeDatasetExportJob, dan tentukan Nama Sumber Daya Amazon (ARN) dari pekerjaan ekspor kumpulan data. Ekspor kumpulan data 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 kumpulan data yang berisi data yang akan diekspor.
Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):personalize:.*:.*:.+
Diperlukan: Ya
- ingestionMode
-
Data yang akan diekspor, berdasarkan cara Anda mengimpor data. Anda dapat memilih untuk mengekspor hanya
BULK
data yang diimpor menggunakan pekerjaan impor kumpulan data, hanyaPUT
data yang Anda impor secara bertahap (menggunakan konsol PutEvents, PutUsers dan PutItems operasi), atauALL
untuk kedua jenis. Nilai default-nya adalahPUT
.Jenis: String
Nilai yang Valid:
BULK | PUT | ALL
Diperlukan: Tidak
- jobName
-
Nama untuk pekerjaan ekspor dataset.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.
Pola:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*
Diperlukan: 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.
Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+
Diperlukan: Ya
-
Daftar tag untuk diterapkan ke pekerjaan ekspor dataset.
Tipe: Array objek Tag
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
Diperlukan: 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.
Jenis: 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 maksimum tag yang dapat Anda terapkan ke sumber daya ini.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: