本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateBatchSegmentJob
建立批次區段任務。操作最多可處理 5，000 萬筆記錄，且輸入檔案必須是 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 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。
必要：否
回應語法
{
"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 SDKs中使用此 API 的詳細資訊，請參閱下列內容：
