CreateRecommender - Amazon Personalize
請求語法請求參數回應語法回應元素錯誤另請參閱

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

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然後向推薦人詢問建議。

相關 API

請求語法

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

必要：否

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

ResourceInUseException

指定的資源正在使用中。

HTTP 狀態碼：400

ResourceNotFoundException

找不到指定的資源。

HTTP 狀態碼：400

TooManyTagsException

您已超過可套用至此資源的標籤數目上限。

HTTP 狀態碼：400

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：