ListRecommenders - Amazon Personalize

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

ListRecommenders

傳回指定 Domain 資料集群組中的建議程式清單。如果未指定網域資料集群組,則會列出與該帳戶相關聯的所有推薦人。回應會為每個推薦人提供屬性,包括 Amazon 資源名稱 (ARN)。如需推薦人的詳細資訊,請參閱CreateRecommender

請求語法

{ "datasetGroupArn": "string", "maxResults": number, "nextToken": "string" }

請求參數

請求接受採用 JSON 格式的下列資料。

datasetGroupArn

網域資料集群組的 Amazon 資源名稱 (ARN),以列出其推薦人。如果未指定網域資料集群組,則會列出與該帳戶相關聯的所有推薦人。

類型:字串

長度限制:長度上限為 256。

模式:arn:([a-z\d-]+):personalize:.*:.*:.+

必要:否

maxResults

要傳回的推薦人數上限。

類型:整數

有效範圍:最小值為 1。最大值為 100。

必要:否

nextToken

從上一次調用返回的令牌,用ListRecommenders於獲取下一組推薦人(如果它們存在)。

類型:字串

長度限制:最大長度為 1500。

模式:\p{ASCII}{0,1500}

必要:否

回應語法

{ "nextToken": "string", "recommenders": [ { "creationDateTime": number, "datasetGroupArn": "string", "lastUpdatedDateTime": number, "name": "string", "recipeArn": "string", "recommenderArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] } } }, "status": "string" } ] }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

nextToken

獲取下一組推薦人的令牌(如果存在)。

類型:字串

長度限制:最大長度為 1500。

模式:\p{ASCII}{0,1500}

recommenders

推薦人的清單。

類型:RecommenderSummary 物件陣列

陣列成員:最多 100 個項目。

錯誤

InvalidInputException

提供欄位或參數的有效值。

HTTP 狀態碼:400

InvalidNextTokenException

令牌無效。

HTTP 狀態碼:400

另請參閱

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