CreateRecommender - Amazon Personalize
请求语法请求参数响应语法响应元素错误另请参阅

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

CreateRecommender

通过您指定的食谱（域数据集组使用案例）创建推荐器。您可以为域数据集组创建推荐器，并在提出请求时指定推荐人的亚马逊资源名称 (ARN)。GetRecommendations

最低每秒建议请求数

重要

高 minRecommendationRequestsPerSecond 会增加您的账单费用。我们建议从 1 开始设置 minRecommendationRequestsPerSecond（默认值）。使用 Amazon CloudWatch 指标跟踪您的使用情况，并在必要minRecommendationRequestsPerSecond时增加使用量。

创建推荐器时，您可以配置推荐器的每秒最低建议请求数。每秒最低建议请求数 (minRecommendationRequestsPerSecond) 指定了 Amazon Personalize 预调配的基准建议请求吞吐量。默认值 minRecommendationRequestsPerSecond 为1。建议请求是单个 GetRecommendations 操作。请求吞吐量以每秒请求数来衡量，Amazon Personalize 使用每秒请求数来计算每小时请求数和推荐器使用量的价格。

如果您的每秒请求数增加到超过 minRecommendationRequestsPerSecond，则 Amazon Personalize 会自动纵向扩展和缩减预调配容量，但永远不会低于 minRecommendationRequestsPerSecond。增加容量时会有短时间延迟，这可能会导致请求丢失。

您的账单是每小时最低请求数（基于 minRecommendationRequestsPerSecond）或实际请求数中的较大值。实际使用的请求吞吐量按照一小时时段内的平均请求数/秒来计算。我们建议从默认值开始minRecommendationRequestsPerSecond，使用 Amazon CloudWatch 指标跟踪您的使用情况，然后minRecommendationRequestsPerSecond根据需要增加使用量。

状态

推荐器可处于以下一种状态：

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE - 或 - CREATE FAILED

  • STOP PENDING > STOP IN_PROGRESS > INACTIVE > START PENDING > START IN_PROGRESS > ACTIVE

  • DELETE PENDING > DELETE IN_PROGRESS

要获取推荐人状态，请致DescribeRecommender电。

注意

等到推荐器的 status 为 ACTIVE 时，再向推荐器询问建议。

相关 API

请求语法

{
   "datasetGroupArn": "string",
   "name": "string",
   "recipeArn": "string",
   "recommenderConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "minRecommendationRequestsPerSecond": number,
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

请求参数

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

datasetGroupArn

推荐器目标域数据集组的 Amazon 资源名称 (ARN)。

类型：字符串

长度约束：最大长度为 256。

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

必需：是

name

推荐器的名称。

类型：字符串

长度限制：最小长度为 1。最大长度为 63。

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

必需：是

recipeArn

推荐器将使用的食谱的 Amazon 资源名称 (ARN)。对于推荐器，食谱是域数据集组使用案例。只能使用域数据集组使用案例来创建推荐器。有关使用案例的信息，请参阅选择推荐器使用案例。

类型：字符串

长度约束：最大长度为 256。

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

必需：是

recommenderConfig

推荐器的配置详细信息。

类型：RecommenderConfig 对象

必需：否

tags

要应用于推荐器的标签列表。

类型：Tag 对象数组

数组成员：最少 0 个物品。最多 200 项。

必需：否

响应语法

{
   "recommenderArn": "string"
}

响应元素

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

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

recommenderArn

推荐器的 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

另请参阅

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