選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料,以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用,但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意,AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定,並顯示相關內容,包括相關廣告。若要接受或拒絕所有非必要 Cookie,請按一下「接受」或「拒絕」。若要進行更詳細的選擇,請按一下「自訂」。

CreateRecommender - Amazon Personalize

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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 物件

必要:否

tags

要套用至建議程式的標籤清單。

類型: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 的詳細資訊,請參閱以下內容:

隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。