CreateBatchInferenceJob - Amazon Personalize

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

CreateBatchInferenceJob

根据存储在 Amazon S3 中的物品或用户的列表生成批量建议,并将建议导出到 Amazon S3 桶。

要生成批量建议,请指定解决方案版本的 ARN 以及输入和输出数据的 Amazon S3 URI。对于用户个性化、热门物品和个性化排名解决方案,批量推理作业会为输入文件中的每个用户 ID 生成建议物品列表。对于相关物品解决方案,该作业会为输入文件中的每个物品 ID 生成建议物品列表。

有关更多信息,请参阅创建批量推理作业

如果您使用 Similar-Items 配方,Amazon Personalize 可以向批量建议添加描述性主题。要生成主题,请将作业的模式设置为 THEME_GENERATION,并指定在输入数据中包含物品名称的字段的名称。

有关生成主题的更多信息,请参阅内容生成器中带有主题的批量建议

您无法通过 Trending-Now 或 Next-Best-Action 配方获得批量建议。

请求语法

{ "batchInferenceJobConfig": { "itemExplorationConfig": { "string" : "string" } }, "batchInferenceJobMode": "string", "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" } ], "themeGenerationConfig": { "fieldsForThemeGeneration": { "itemName": "string" } } }

请求参数

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

batchInferenceJobConfig

批量推理作业的配置详情。

类型:BatchInferenceJobConfig 对象

必需:否

batchInferenceJobMode

批量推理作业的模式。要为一组相似的物品生成描述性主题,请将作业模式设置为 THEME_GENERATION。如果您不想生成主题,请使用默认 BATCH_INFERENCE

当您获得带有主题的批量建议时,将产生额外的成本。有关更多信息,请参阅 Amazon Personalize 定价

类型:字符串

有效值:BATCH_INFERENCE | THEME_GENERATION

必需:否

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 S3 存储桶的 Amazon Identity and Access Management 角色的 ARN。

类型:字符串

长度约束:最大长度为 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 项。

必需:否

themeGenerationConfig

对于主题生成作业,请指定物品数据集中包含每个物品名称的列的名称。

类型:ThemeGenerationConfig 对象

必需:否

响应语法

{ "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

TooManyTagsException

您已超出您可以应用到此资源的最大标签数量。

HTTP 状态代码:400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: