本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
时,再向推荐器询问建议。
请求语法
{
"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 对象
必需:否
-
要应用于推荐器的标签列表。
类型: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
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: