Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateBatchSegmentJob
Membuat pekerjaan segmen batch. Operasi dapat menangani hingga 50 juta catatan dan file input harus dalam format JSON. Untuk informasi selengkapnya, lihat Mendapatkan rekomendasi batch dan segmen pengguna.
Sintaksis Permintaan
{
"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"
}
]
}Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- filterArn
-
ARN filter untuk diterapkan ke pekerjaan segmen 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 untuk data input yang digunakan untuk menghasilkan pekerjaan segmen batch.
Tipe: Objek BatchSegmentJobInput
Wajib: Ya
- jobName
-
Nama pekerjaan segmen 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 Amazon S3 untuk bucket tempat output pekerjaan akan disimpan.
Tipe: Objek BatchSegmentJobOutput
Wajib: Ya
- numResults
-
Jumlah pengguna yang diprediksi dihasilkan oleh pekerjaan segmen batch untuk setiap baris data input. Jumlah maksimum pengguna per segmen adalah 5 juta.
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 Anda inginkan untuk digunakan oleh tugas segmen batch untuk menghasilkan segmen batch.
Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):personalize:.*:.*:.+Diperlukan: Ya
-
Daftar tag untuk diterapkan ke pekerjaan segmen batch.
Tipe: Array objek Tag
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.
Diperlukan: Tidak
Sintaksis Respons
{
"batchSegmentJobArn": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- batchSegmentJobArn
-
ARN dari pekerjaan segmen 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:
