Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateBatchInferenceJob
Menghasilkan rekomendasi batch berdasarkan daftar item atau pengguna yang disimpan di Amazon S3 dan mengekspor rekomendasi ke bucket Amazon S3.
Untuk menghasilkan rekomendasi batch, tentukan ARN versi solusi dan URI Amazon S3 untuk data input dan output. Untuk personalisasi pengguna, item populer, dan solusi peringkat yang dipersonalisasi, pekerjaan inferensi batch menghasilkan daftar item yang direkomendasikan untuk setiap ID pengguna dalam file input. Untuk solusi item terkait, pekerjaan menghasilkan daftar item yang direkomendasikan untuk setiap ID item dalam file input.
Untuk informasi selengkapnya, lihat Membuat pekerjaan inferensi batch.
Jika Anda menggunakan resep Similar-Items, Amazon Personalize dapat menambahkan tema deskriptif ke rekomendasi batch. Untuk menghasilkan tema, atur mode pekerjaan ke THEME_GENERATION
dan tentukan nama bidang yang berisi nama item dalam data input.
Untuk informasi selengkapnya tentang membuat tema, lihat Rekomendasi Batch dengan tema dari Content Generator.
Anda tidak bisa mendapatkan rekomendasi batch dengan resep Trending-Now atau Next-Best-Action.
Sintaksis Permintaan
{
"batchInferenceJobConfig": {
"itemExplorationConfig": {
"string
" : "string
"
}
},
"batchInferenceJobMode": "string
",
"filterArn": "string
",
"jobInput": {
"s3DataSource": {
"kmsKeyArn": "string
",
"path": "string
"
}
},
"jobName": "string
",
"jobOutput": {
"s3DataDestination": {
"kmsKeyArn": "string
",
"path": "string
"
}
},
"numResults": number
,
"roleArn": "string
",
"solutionVersionArn": "string
",
"tags": [
{
"tagKey": "string
",
"tagValue": "string
"
}
],
"themeGenerationConfig": {
"fieldsForThemeGeneration": {
"itemName": "string
"
}
}
}
Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- batchInferenceJobConfig
-
Detail konfigurasi pekerjaan inferensi batch.
Tipe: Objek BatchInferenceJobConfig
Diperlukan: Tidak
- batchInferenceJobMode
-
Mode pekerjaan inferensi batch. Untuk menghasilkan tema deskriptif untuk grup item serupa, atur mode pekerjaan ke
THEME_GENERATION
. Jika Anda tidak ingin menghasilkan tema, gunakan defaultBATCH_INFERENCE
.Ketika Anda mendapatkan rekomendasi batch dengan tema, Anda akan dikenakan biaya tambahan. Untuk informasi selengkapnya, lihat Harga Amazon Personalisasi
. Jenis: String
Nilai yang Valid:
BATCH_INFERENCE | THEME_GENERATION
Diperlukan: Tidak
- filterArn
-
ARN filter untuk diterapkan pada pekerjaan inferensi batch. Untuk informasi selengkapnya tentang penggunaan filter, lihat Memfilter rekomendasi batch.
Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):personalize:.*:.*:.+
Diperlukan: Tidak
- jobInput
-
Jalur Amazon S3 yang mengarah ke file input untuk mendasarkan rekomendasi Anda. Materi input harus dalam format JSON.
Tipe: Objek BatchInferenceJobInput
Wajib: Ya
- jobName
-
Nama pekerjaan inferensi batch yang akan dibuat.
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 akan disimpan.
Tipe: Objek BatchInferenceJobOutput
Wajib: Ya
- numResults
-
Jumlah rekomendasi untuk diambil.
Tipe: Integer
Wajib: Tidak
- roleArn
-
ARN dari peran Amazon Identity and Access Management yang memiliki izin untuk membaca dan menulis ke bucket Amazon S3 masukan dan keluaran Anda masing-masing.
Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+
Diperlukan: Ya
- solutionVersionArn
-
Nama Sumber Daya Amazon (ARN) dari versi solusi yang akan digunakan untuk menghasilkan rekomendasi inferensi batch.
Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):personalize:.*:.*:.+
Diperlukan: Ya
-
Daftar tag untuk diterapkan ke pekerjaan inferensi batch.
Tipe: Array objek Tag
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
Diperlukan: Tidak
- themeGenerationConfig
-
Untuk pekerjaan pembuatan tema, tentukan nama kolom di kumpulan data Item Anda yang berisi nama setiap item.
Tipe: Objek ThemeGenerationConfig
Wajib: Tidak
Sintaksis Respons
{
"batchInferenceJobArn": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- batchInferenceJobArn
-
ARN dari pekerjaan inferensi batch.
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: