本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateRecommender 使用您指定的配方 （網域資料集群組使用案例） 建立推薦者。您可以為網域資料集群組建立推薦者，並在提出 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 請求時指定推薦者的 Amazon Resource Name (ARN)。 **每秒最低建議請求數** **重要** 較高的 `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\$1PROGRESS > ACTIVE -or- CREATE FAILED + 停止待定 > 停止 IN\$1PROGRESS > 非作用中 > 啟動待定 > 啟動 IN\$1PROGRESS > 作用中 + DELETE PENDING > DELETE IN\$1PROGRESS 若要取得推薦者狀態，請呼叫 [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html)。 **注意** 請等到`status`建議者的 變成 ，`ACTIVE`再向建議者要求建議。 **相關 API** + [ListRecommenders](https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) + [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) + [UpdateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) + [DeleteRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) ## 請求語法 ``` { "datasetGroupArn": "string", "name": "string", "recipeArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [datasetGroupArn](#API_CreateRecommender_RequestSyntax) ** 建議者目的地網域資料集群組的 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必要：是 ** [name](#API_CreateRecommender_RequestSyntax) ** 建議者的名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 63。 模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必要：是 ** [recipeArn](#API_CreateRecommender_RequestSyntax) ** 建議者將使用之配方的 Amazon Resource Name (ARN)。對於推薦者，配方是網域資料集群組使用案例。只有網域資料集群組使用案例可用於建立建議程式。如需使用案例的相關資訊，請參閱[選擇推薦者使用案例](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html)。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必要：是 ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** 建議者的組態詳細資訊。 類型：[RecommenderConfig](API_RecommenderConfig.md) 物件 必要：否 ** [tags](#API_CreateRecommender_RequestSyntax) ** 要套用至建議者的[標籤](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)清單。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 200。 必要：否 ## 回應語法 ``` { "recommenderArn": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [recommenderArn](#API_CreateRecommender_ResponseSyntax) ** 建議者的 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 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateRecommender) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender)