本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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:.*:.*:.+
必需:是
-
要应用于批量推理作业的标签列表。
类型: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 的更多信息,请参阅以下内容: