本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # CreateBatchInferenceJob 根据存储在 Amazon S3 中的物品或用户的列表生成批量建议，并将建议导出到 Amazon S3 桶。要生成批量建议，请指定解决方案版本的 ARN 以及输入和输出数据的 Amazon S3 URI。对于用户个性化、热门物品和个性化排名解决方案，批量推理作业会为输入文件中的每个用户 ID 生成建议物品列表。对于相关物品解决方案，该作业会为输入文件中的每个物品 ID 生成建议物品列表。有关更多信息，请参阅[创建批量推理作业](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html)。如果您使用 Similar-Items 配方，Amazon Personalize 可以向批量建议添加描述性主题。要生成主题，请将作业的模式设置为 `THEME_GENERATION`，并指定在输入数据中包含物品名称的字段的名称。有关生成主题的更多信息，请参阅[内容生成器中带有主题的批量建议](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html)。你无法通过 Trending-Now 或食谱获得批次推荐。 Next-Best-Action ## 请求语法 ``` { "batchInferenceJobConfig": { "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number } }, "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](#API_CreateBatchInferenceJob_RequestSyntax) ** 批量推理作业的配置详情。类型：[BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) 对象必需：否 ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) ** 批量推理作业的模式。要为一组相似的物品生成描述性主题，请将作业模式设置为 `THEME_GENERATION`。如果您不想生成主题，请使用默认 `BATCH_INFERENCE`。当您获得带有主题的批量建议时，将产生额外的成本。有关更多信息，请参阅 [Amazon Personalize 定价](https://aws.amazon.com/personalize/pricing/)。类型：字符串有效值：`BATCH_INFERENCE | THEME_GENERATION` 必需：否 ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) ** 要应用于批量推理作业的筛选器的 ARN。有关使用筛选器的更多信息，请参阅[筛选批量建议](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) ** 指向输入文件以作为建议的基础的 Amazon S3 路径。输入材料必须采用 JSON 格式。类型：[BatchInferenceJobInput](API_BatchInferenceJobInput.md) 对象是否必需：是 ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) ** 要创建的批量推理作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 是否必需：是 ** [jobOutput](#API_CreateBatchInferenceJob_RequestSyntax) ** 指向存储作业输出的 Amazon S3 存储桶的路径。类型：[BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) 对象是否必需：是 ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) ** 要检索的建议的数量。类型：整数必需：否 ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) ** 分别有权读取和写入您的输入和输出 Amazon S3 存储桶的 Amazon Identity and Access Management 角色的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 是否必需：是 ** [solutionVersionArn](#API_CreateBatchInferenceJob_RequestSyntax) ** 将用于生成批量推理建议的解决方案版本的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 是否必需：是 ** [tags](#API_CreateBatchInferenceJob_RequestSyntax) ** 要应用于批量推理作业的[标签](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)列表。类型：[Tag](API_Tag.md) 对象数组数组成员：最少 0 个物品。最多 200 项。必需：否 ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) ** 对于主题生成作业，请指定物品数据集中包含每个物品名称的列的名称。类型：[ThemeGenerationConfig](API_ThemeGenerationConfig.md) 对象必需：否 ## 响应语法 ``` { "batchInferenceJobArn": "string" } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [batchInferenceJobArn](#API_CreateBatchInferenceJob_ResponseSyntax) ** 批量推理作业的 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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchInferenceJob) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchInferenceJob)