本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
-
批处理段作业为每行输入数据生成的预测用户数。
类型: 整数
:必需 否
- roleArn
-
Amazon Identity and Access Management 角色的 ARN,分别有权读取和写入您的 Amazon S3 存储桶和输出 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
另请参阅
有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: