本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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:.*:.*:.+
必要:是
-
要套用至批次區段工作的標籤清單。
類型: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 的詳細資訊,請參閱下列內容: