本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CreateRecommender
使用您指定的配方 (網域資料集群組使用案例) 建立推薦者。您可以為網域資料集群組建立推薦者,並在提出 GetRecommendations 請求時指定推薦者的 Amazon Resource Name (ARN)。
每秒最低建議請求數
重要
較高的 minRecommendationRequestsPerSecond
會增加您的帳單。對於 minRecommendationRequestsPerSecond
(預設值),我們建議從 1 開始。使用 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
-
停止擱置中 > 停止 IN_PROGRESS > 非作用中 > 啟動擱置中 > 啟動 IN_PROGRESS > 作用中
-
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 Resource Name (ARN)。
類型:字串
長度限制:長度上限為 256。
模式:
arn:([a-z\d-]+):personalize:.*:.*:.+
必要:是
- name
-
建議程式的名稱。
類型:字串
長度限制:長度下限為 1。長度上限為 63。
模式:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*
必要:是
- recipeArn
-
建議者將使用之配方的 Amazon Resource Name (ARN)。對於推薦者,配方是網域資料集群組使用案例。只有網域資料集群組使用案例可用於建立建議程式。如需使用案例的相關資訊,請參閱選擇推薦者使用案例。
類型:字串
長度限制:長度上限為 256。
模式:
arn:([a-z\d-]+):personalize:.*:.*:.+
必要:是
- recommenderConfig
-
建議程式的組態詳細資訊。
類型:RecommenderConfig 物件
必要:否
-
要套用至建議程式的標籤清單。
類型:Tag 物件陣列
陣列成員:項目數下限為 0。項目數上限為 200。
必要:否
回應語法
{
"recommenderArn": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- recommenderArn
-
建議程式的 Amazon Resource Name (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 SDKs中使用此 API 的詳細資訊,請參閱以下內容: