CreateBatchSegmentJob - Amazon Personalize

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

CreateBatchSegmentJob

建立批次區段工作。該操作最多可以處理 5000 萬條記錄,並且輸入文件必須是 JSON 格式。如需詳細資訊,請參閱取得批次建議和使用者區段

請求語法

{ "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" } ] }

請求參數

請求接受採用 JSON 格式的下列資料。

filterArn

要套用至批次區段工作的篩選器 ARN。如需有關使用篩選器的詳細資訊,請參閱篩選批次建議

類型:字串

長度限制:長度上限為 256。

模式:arn:([a-z\d-]+):personalize:.*:.*:.+

必要:否

jobInput

用於產生批次區段任務之輸入資料的 Amazon S3 路徑。

類型:BatchSegmentJobInput 物件

必要:是

jobName

要建立的批次區段工作名稱。

類型:字串

長度限制:長度下限為 1。長度上限為 63。

模式:^[a-zA-Z0-9][a-zA-Z0-9\-_]*

必要:是

jobOutput

將存放任務輸出的儲存貯體的 Amazon S3 路徑。

類型:BatchSegmentJobOutput 物件

必要:是

numResults

批次區段工作針對每一行輸入資料產生的預測使用者數目。每個區段的使用者數目上限為 500 萬。

類型:整數

必要:否

roleArn

Amazon 身分和存取管理角色的 ARN,具有讀取和寫入您的輸入和輸出 Amazon S3 儲存貯體的權限。

類型:字串

長度限制:長度上限為 256。

模式:arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

必要:是

solutionVersionArn

您希望批次區段任務用來產生批次區段之解決方案版本的 Amazon 資源名稱 (ARN)。

類型:字串

長度限制:長度上限為 256。

模式:arn:([a-z\d-]+):personalize:.*:.*:.+

必要:是

tags

要套用至批次區段工作的標籤清單。

類型:Tag 物件陣列

陣列成員:項目數下限為 0。項目數上限為 200。

必要:否

回應語法

{ "batchSegmentJobArn": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

batchSegmentJobArn

批次區段工作的 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 SDK 中使用此 API 的詳細資訊,請參閱下列內容: