CreateBatchSegmentJob - Amazon Personalize
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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 的更多信息,请参阅以下内容: