本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # CreateRecommender 通过您指定的食谱（域数据集组使用案例）创建推荐器。您可以为域数据集组创建推荐器，并在提出请求时指定推荐人的亚马逊资源名称 (ARN)。[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) **最低每秒建议请求数** **重要** 高 `minRecommendationRequestsPerSecond` 会增加您的账单费用。我们建议从 1 开始设置 `minRecommendationRequestsPerSecond`（默认值）。使用 Amazon CloudWatch 指标跟踪您的使用情况，并在必要`minRecommendationRequestsPerSecond`时增加使用量。 创建推荐器时，您可以配置推荐器的每秒最低建议请求数。每秒最低建议请求数 (`minRecommendationRequestsPerSecond`) 指定了 Amazon Personalize 预调配的基准建议请求吞吐量。默认值 minRecommendationRequestsPerSecond 为`1`。建议请求是单个 `GetRecommendations` 操作。请求吞吐量以每秒请求数来衡量，Amazon Personalize 使用每秒请求数来计算每小时请求数和推荐器使用量的价格。 如果您的每秒请求数增加到超过 `minRecommendationRequestsPerSecond`，则 Amazon Personalize 会自动纵向扩展和缩减预调配容量，但永远不会低于 `minRecommendationRequestsPerSecond`。增加容量时会有短时间延迟，这可能会导致请求丢失。 您的账单是每小时最低请求数（基于 minRecommendationRequestsPerSecond）或实际请求数中的较大值。使用的实际请求吞吐量按一小时窗口 requests/second 内的平均值计算。我们建议从默认值开始`minRecommendationRequestsPerSecond`，使用 Amazon CloudWatch 指标跟踪您的使用情况，然后`minRecommendationRequestsPerSecond`根据需要增加使用量。 **状态** 推荐器可处于以下一种状态： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS 要获取推荐人状态，请致[DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html)电。 **注意** 等到推荐器的 `status` 为 `ACTIVE` 时，再向推荐器询问建议。 **相关 APIs** + [ListRecommenders](https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) + [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) + [UpdateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) + [DeleteRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) ## 请求语法 ``` { "datasetGroupArn": "string", "name": "string", "recipeArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [datasetGroupArn](#API_CreateRecommender_RequestSyntax) ** 推荐器目标域数据集组的 Amazon 资源名称 (ARN)。 类型：字符串 长度约束：最大长度为 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 是否必需：是 ** [name](#API_CreateRecommender_RequestSyntax) ** 推荐器的名称。 类型：字符串 长度限制：最小长度为 1。最大长度为 63。 模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 是否必需：是 ** [recipeArn](#API_CreateRecommender_RequestSyntax) ** 推荐器将使用的食谱的 Amazon 资源名称 (ARN)。对于推荐器，食谱是域数据集组使用案例。只能使用域数据集组使用案例来创建推荐器。有关使用案例的信息，请参阅[选择推荐器使用案例](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html)。 类型：字符串 长度约束：最大长度为 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 是否必需：是 ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** 推荐器的配置详细信息。 类型：[RecommenderConfig](API_RecommenderConfig.md) 对象 必需：否 ** [tags](#API_CreateRecommender_RequestSyntax) ** 要应用于推荐器的[标签](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)列表。 类型：[Tag](API_Tag.md) 对象数组 数组成员：最少 0 个物品。最多 200 项。 必需：否 ## 响应语法 ``` { "recommenderArn": "string" } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回以下数据。 ** [recommenderArn](#API_CreateRecommender_ResponseSyntax) ** 推荐器的 Amazon 资源名称 (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/CreateRecommender) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender)