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

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

CreateBatchInferenceJob

创建批量推理作业。该操作最多可处理 5000 万条记录,输入文件必须采用 JSON 格式。有关更多信息,请参阅 。创建批量推理作业.

请求语法

{ "batchInferenceJobConfig": { "itemExplorationConfig": { "string" : "string" } }, "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "numResults": number, "roleArn": "string", "solutionVersionArn": "string" }

请求参数

请求接受采用 JSON 格式的以下数据。

batchInferenceJobConfig

批量推理作业的配置详细信息。

类型:BatchInferenceJobConfig 对象

:必需 否

filterArn

要应用于批量推理作业的筛选器的 ARN。有关使用筛选器的更多信息,请参阅筛选批量建议.

类型: 字符串

约束:长度上限为 256。

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

:必需 否

jobInput

指向作为建议基础的输入文件的 Amazon S3 路径。输入材料必须采用 JSON 格式。

类型:BatchInferenceJobInput 对象

:必需 是

jobName

要创建的批量推理作业的名称。

类型: 字符串

约束:最小长度为 1。长度上限为 63。

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

:必需 是

jobOutput

将存储作业输出的 Amazon S3 存储桶的路径。

类型:BatchInferenceJobOutput 对象

:必需 是

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:.*:.*:.+

:必需 是

响应语法

{ "batchInferenceJobArn": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

batchInferenceJobArn

批量推理作业的 ARN。

类型: 字符串

约束:长度上限为 256。

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

错误

InvalidInputException

为字段或参数提供有效值。

HTTP 状态代码:400

LimitExceededException

已超过每秒请求数的限制。

HTTP 状态代码:400

ResourceAlreadyExistsException

已存在指定的资源。

HTTP 状态代码:400

ResourceInUseException

正在使用指定的资源。

HTTP 状态代码:400

ResourceNotFoundException

找不到指定的资源。

HTTP 状态代码:400

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: