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电。

注意

等到推荐器的 statusACTIVE 时,再向推荐器询问建议。

请求语法

{ "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 的更多信息,请参阅以下内容: