ListRecommenders - Amazon Personalize

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

ListRecommenders

返回给定域数据集组中的推荐器列表。如果未指定域数据集组,则会列出与账户关联的所有推荐器。响应中将提供每个推荐器的属性,包括 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 的更多信息,请参阅以下内容: