本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateBatchInferenceJob
根據存放在 Amazon S3 中的項目或使用者清單產生批次建議，並將建議匯出至 Amazon S3 儲存貯體。
若要產生批次建議，請為輸入和輸出資料指定解決方案版本的 ARN 和 Amazon S3 URI。對於使用者個人化、熱門項目和個人化排名解決方案，批次推論任務會為輸入檔案中的每個使用者 ID 產生建議項目清單。對於相關項目解決方案，任務會為輸入檔案中的每個項目 ID 產生建議項目清單。
如需詳細資訊，請參閱建立批次推論任務 。
如果您使用類似項目配方，Amazon Personalize 可以將描述性主題新增至批次建議。若要產生主題，請將任務的模式設定為 ，THEME_GENERATION並指定在輸入資料中包含項目名稱的欄位名稱。
如需產生佈景主題的詳細資訊，請參閱 Content Generator 中的批次建議與佈景主題。
您無法透過 Trending-Now 或 Next-Best-Action 配方取得批次建議。
請求語法
{
"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"
}
}
}請求參數
請求接受採用 JSON 格式的下列資料。
- batchInferenceJobConfig
-
批次推論任務的組態詳細資訊。
類型：BatchInferenceJobConfig 物件
必要：否
- batchInferenceJobMode
-
批次推論任務的模式。若要產生類似項目群組的描述性主題，請將任務模式設定為
THEME_GENERATION。如果您不想產生主題，請使用預設BATCH_INFERENCE。當您收到含有主題的批次建議時，會產生額外費用。如需詳細資訊，請參閱 Amazon Personalize 定價
。 類型：字串
有效值:
BATCH_INFERENCE | THEME_GENERATION必要：否
- filterArn
-
要套用至批次推論任務的篩選條件 ARN。如需使用篩選條件的詳細資訊，請參閱篩選批次建議。
類型：字串
長度限制：長度上限為 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+必要：否
- jobInput
-
Amazon S3 路徑，導致輸入檔案以您的建議為基礎。輸入資料必須是 JSON 格式。
類型：BatchInferenceJobInput 物件
必要：是
- jobName
-
要建立的批次推論任務名稱。
類型：字串
長度限制：長度下限為 1。長度上限為 63。
模式：
^[a-zA-Z0-9][a-zA-Z0-9\-_]*必要：是
- jobOutput
-
存放任務輸出的 Amazon S3 儲存貯體路徑。
類型：BatchInferenceJobOutput 物件
必要：是
- numResults
-
要擷取的建議數目。
類型：整數
必要：否
- roleArn
-
Amazon Identity and Access Management 角色的 ARN，具有分別讀取和寫入輸入和輸出 Amazon S3 儲存貯體的許可。
類型：字串
長度限制：長度上限為 256。
模式：
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+必要：是
- solutionVersionArn
-
將用於產生批次推論建議的 解決方案版本的 Amazon Resource Name (ARN)。
類型：字串
長度限制：長度上限為 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+必要：是
-
要套用至批次推論任務的標籤清單。
類型：Tag 物件陣列
陣列成員：項目數下限為 0。項目數上限為 200。
必要：否
- themeGenerationConfig
-
對於主題產生任務，請在包含每個項目名稱的項目資料集中指定資料欄的名稱。
類型：ThemeGenerationConfig 物件
必要：否
回應語法
{
"batchInferenceJobArn": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- batchInferenceJobArn
-
批次推論任務的 ARN。
類型：字串
長度限制：長度上限為 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+
錯誤
- InvalidInputException
-
提供欄位或參數的有效值。
HTTP 狀態碼：400
- LimitExceededException
-
已超過每秒請求數的限制。
HTTP 狀態碼：400
- ResourceAlreadyExistsException
-
指定的資源已存在。
HTTP 狀態碼：400
- ResourceInUseException
-
指定的資源正在使用中。
HTTP 狀態碼：400
- ResourceNotFoundException
-
找不到指定的資源。
HTTP 狀態碼：400
- TooManyTagsException
-
您已超過可套用至此資源的標籤數量上限。
HTTP 狀態碼：400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容：
