本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CreateRecommender
使用您指定的方案 (網域資料集群組使用案例) 建立建議程式。您可以為網域資料集群組建立推薦人,並在提出請求時指定推薦人的 Amazon 資源名稱 (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 -or- CREATE FAILED
-
停止擱置中 > 停止進行中 > 非作用中 > 開始擱置 > 啟動進度 > 作用中
-
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
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: