CreateRecommender - Amazon Personalize
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

CreateRecommender

使用您指定的方法(域数据集组用例)创建推荐者。您可以为域数据集组创建推荐者,并 ARN 创建GetRecommendations请求.

每秒的最低推荐请求数

当你创建推荐者时,你可以配置推荐者每秒的最低推荐请求。每秒最低推荐请求量 (minRecommendationRequestsPerSecond) 指定 Amazon Personalize 化预配的基准建议请求吞吐量。每秒默认的最小推荐请求数为1. 推荐请求只是单个GetRecommendationsoperation. 请求吞吐量以每秒请求数计量,Amazon Personalize 使用您的每秒请求数来计算您的每小时请求数和推荐者使用价格。

如果你的每秒请求增加超过minRecommendationRequestsPerSecond,Amazon Personalize 化自动扩展预配置容量,但永远不会低于minRecommendationRequestsPerSecond. 容量增加时会有很短的延迟,这可能会导致请求丢失。

您的账单要么是每小时的最低请求数(基于每秒 minMinRequestsRequestsSpers)或实际请求数中的较大者。使用的实际请求吞吐量按一小时窗口内的平均请求/秒计算。我们建议从默认值开始minRecommendationRequestsPerSecond中,使用亚马逊跟踪您的使用 CloudWatch 指标,然后增加minRecommendationRequestsPerSecond必要。

状态

推荐者可以处于以下状态之一:

  • 创建待处理 > 创建进度 > 活动-或-创建失败

  • 删除待处理 > 删除正在进行

要获得推荐者状态,请致电描述 SCRIBE 推荐者.

注意

等到status的推荐者是ACTIVE然后向推荐人征求建议。

请求语法

{ "datasetGroupArn": "string", "name": "string", "recipeArn": "string", "recommenderConfig": { "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number }, "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

ResourceNotFoundException

找不到指定的资源。

HTTP 状态代码:400

TooManyTagsException

您已超出您可以应用于此资源的最大标签数量。

HTTP 状态代码:400

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: