ListRecommenders - Amazon Personalize

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

ListRecommenders

Devuelve una lista de los recomendadores de un grupo de conjuntos de datos de dominio determinado. Cuando no se especifica un grupo de conjuntos de datos de dominio, se muestran todos los recomendadores asociados a la cuenta. La respuesta proporciona las propiedades de cada recomendador, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre los recomendantes, consulte CreateRecommender.

Sintaxis de la solicitud

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

Parámetros de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

datasetGroupArn

El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos de dominio para el que se van a enumerar los recomendadores. Cuando no se especifica un grupo de conjuntos de datos de dominio, se muestran todos los recomendadores asociados a la cuenta.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatorio: no

maxResults

El número máximo de recomendadores que se devolverán.

Tipo: entero

Rango válido: valor mínimo de 1. Valor máximo de 100.

Obligatorio: no

nextToken

Un token devuelto por la llamada anterior a ListRecommenders para obtener el siguiente conjunto de recomendadores (si existen).

Tipo: cadena

Limitaciones de longitud: longitud máxima de 1500 caracteres.

Patrón: \p{ASCII}{0,1500}

Obligatorio: no

Sintaxis de la respuesta

{ "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" } ] }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

nextToken

Un token para obtener el siguiente conjunto de recomendaciones (si existen).

Tipo: cadena

Limitaciones de longitud: longitud máxima de 1500 caracteres.

Patrón: \p{ASCII}{0,1500}

recommenders

Una lista de los recomendadores.

Tipo: matriz de objetos RecommenderSummary

Miembros de la matriz: número máximo de 100 elementos.

Errores

InvalidInputException

Proporcione un valor válido para el campo o el parámetro.

Código de estado HTTP: 400

InvalidNextTokenException

El token no es válido.

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: