ListRecommenders - Amazon Personalize
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ListRecommenders

Renvoie une liste de recommandations dans un groupe de données de domaine donné. Lorsqu'aucun groupe de données de domaine n'est spécifié, tous les recommandateurs associés au compte sont répertoriés. La réponse fournit les propriétés de chaque recommandeur, y compris le Amazon Resource Name (ARN). Pour plus d'informations sur les recommandateurs, consultez CreateRecommender.

Syntaxe de la requête

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

Paramètres de demande

Cette demande accepte les données suivantes au format JSON.

datasetGroupArn

Nom de ressource Amazon (ARN) du groupe de données de domaine pour lequel répertorier les recommandeurs. Lorsqu'aucun groupe de données de domaine n'est spécifié, tous les recommandateurs associés au compte sont répertoriés.

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatoire : non

maxResults

Le nombre maximum de recommandations à renvoyer.

Type : entier

Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.

Obligatoire : non

nextToken

Un jeton renvoyé par l'appel précédent ListRecommenders pour obtenir le prochain ensemble de recommandations (s'ils existent).

Type : chaîne

Contraintes de longueur : longueur maximale de 1500.

Modèle : \p{ASCII}{0,1500}

Obligatoire : non

Syntaxe de la réponse

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

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

nextToken

Un jeton pour obtenir le prochain ensemble de recommandations (s'ils existent).

Type : chaîne

Contraintes de longueur : longueur maximale de 1500.

Modèle : \p{ASCII}{0,1500}

recommenders

Une liste des recommandateurs.

Type : tableau d’objets RecommenderSummary

Membres du tableau : nombre maximum de 100 éléments.

Erreurs

InvalidInputException

Entrez une valeur valide pour le champ ou le paramètre.

Code d’état HTTP : 400

InvalidNextTokenException

Le jeton n'est pas valide.

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :