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

# CreateBatchInferenceJob
<a name="API_CreateBatchInferenceJob"></a>

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](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html).

 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](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html). 

Anda tidak bisa mendapatkan rekomendasi batch dengan Trending-Now atau resep. Next-Best-Action

## Sintaksis Permintaan
<a name="API_CreateBatchInferenceJob_RequestSyntax"></a>

```
{
   "batchInferenceJobConfig": { 
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      }
   },
   "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
<a name="API_CreateBatchInferenceJob_RequestParameters"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [batchInferenceJobConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobConfig"></a>
Detail konfigurasi pekerjaan inferensi batch.  
Tipe: Objek [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md)  
Wajib: Tidak

 ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobMode"></a>
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 default`BATCH_INFERENCE`.  
 Ketika Anda mendapatkan rekomendasi batch dengan tema, Anda akan dikenakan biaya tambahan. Untuk informasi selengkapnya, lihat [Harga Amazon Personalisasi](https://aws.amazon.com/personalize/pricing/).   
Tipe: String  
Nilai yang Valid: `BATCH_INFERENCE | THEME_GENERATION`   
Wajib: Tidak

 ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-filterArn"></a>
ARN filter untuk diterapkan pada pekerjaan inferensi batch. Untuk informasi selengkapnya tentang penggunaan filter, lihat [Memfilter rekomendasi batch](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html).  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Tidak

 ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobInput"></a>
Jalur Amazon S3 yang mengarah ke file input untuk mendasarkan rekomendasi Anda. Materi input harus dalam format JSON.  
Tipe: Objek [BatchInferenceJobInput](API_BatchInferenceJobInput.md)  
Wajib: Ya

 ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobName"></a>
Nama pekerjaan inferensi batch yang akan dibuat.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.  
Pola: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Wajib: Ya

 ** [jobOutput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobOutput"></a>
Jalur ke bucket Amazon S3 tempat output pekerjaan akan disimpan.  
Tipe: Objek [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md)  
Wajib: Ya

 ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-numResults"></a>
Jumlah rekomendasi untuk diambil.  
Tipe: Integer  
Wajib: Tidak

 ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-roleArn"></a>
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.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Wajib: Ya

 ** [solutionVersionArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-solutionVersionArn"></a>
Nama Sumber Daya Amazon (ARN) dari versi solusi yang akan digunakan untuk menghasilkan rekomendasi inferensi batch.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Ya

 ** [tags](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-tags"></a>
Daftar [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) untuk diterapkan ke pekerjaan inferensi batch.  
Tipe: Array objek [Tag](API_Tag.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.  
Wajib: Tidak

 ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-themeGenerationConfig"></a>
Untuk pekerjaan pembuatan tema, tentukan nama kolom di kumpulan data Item Anda yang berisi nama setiap item.  
Tipe: Objek [ThemeGenerationConfig](API_ThemeGenerationConfig.md)  
Wajib: Tidak

## Sintaksis Respons
<a name="API_CreateBatchInferenceJob_ResponseSyntax"></a>

```
{
   "batchInferenceJobArn": "string"
}
```

## Elemen Respons
<a name="API_CreateBatchInferenceJob_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [batchInferenceJobArn](#API_CreateBatchInferenceJob_ResponseSyntax) **   <a name="personalize-CreateBatchInferenceJob-response-batchInferenceJobArn"></a>
ARN dari pekerjaan inferensi batch.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Kesalahan
<a name="API_CreateBatchInferenceJob_Errors"></a>

 ** 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
<a name="API_CreateBatchInferenceJob_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchInferenceJob)