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.

# DescribeRecommender
<a name="API_DescribeRecommender"></a>

Décrit le recommandateur donné, y compris son statut.

Un recommandateur peut se trouver dans l'un des états suivants :
+ CREATE PENDING > CREATE IN\_PROGRESS > ACTIVE -ou- CREATE FAILED
+ ARRÊTER EN ATTENTE > ARRÊTER EN COURS > INACTIF > DÉMARRER EN ATTENTE > DÉMARRER EN COURS > ACTIF
+ DELETE PENDING > DELETE IN\_PROGRESS

Lorsque `status` c'est`CREATE FAILED`, la réponse inclut la `failureReason` clé, qui décrit pourquoi.

La `modelMetrics` clé est nulle lorsque le recommandateur est créé ou supprimé.

Pour plus d'informations sur les recommandateurs, consultez [ CreateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html).

## Syntaxe de la requête
<a name="API_DescribeRecommender_RequestSyntax"></a>

```
{
   "recommenderArn": "{{string}}"
}
```

## Paramètres de demande
<a name="API_DescribeRecommender_RequestParameters"></a>

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

 ** [recommenderArn](#API_DescribeRecommender_RequestSyntax) **   <a name="personalize-DescribeRecommender-request-recommenderArn"></a>
Le nom de ressource Amazon (ARN) du recommandateur à décrire.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_DescribeRecommender_ResponseSyntax"></a>

```
{
   "recommender": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "failureReason": "string",
      "lastUpdatedDateTime": number,
      "latestRecommenderUpdate": { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "recommenderConfig": { 
            "enableMetadataWithRecommendations": boolean,
            "itemExplorationConfig": { 
               "string" : "string" 
            },
            "minRecommendationRequestsPerSecond": number,
            "trainingDataConfig": { 
               "excludedDatasetColumns": { 
                  "string" : [ "string" ]
               },
               "includedDatasetColumns": { 
                  "string" : [ "string" ]
               }
            }
         },
         "status": "string"
      },
      "modelMetrics": { 
         "string" : number 
      },
      "name": "string",
      "recipeArn": "string",
      "recommenderArn": "string",
      "recommenderConfig": { 
         "enableMetadataWithRecommendations": boolean,
         "itemExplorationConfig": { 
            "string" : "string" 
         },
         "minRecommendationRequestsPerSecond": number,
         "trainingDataConfig": { 
            "excludedDatasetColumns": { 
               "string" : [ "string" ]
            },
            "includedDatasetColumns": { 
               "string" : [ "string" ]
            }
         }
      },
      "status": "string"
   }
}
```

## Eléments de réponse
<a name="API_DescribeRecommender_ResponseElements"></a>

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.

 ** [recommender](#API_DescribeRecommender_ResponseSyntax) **   <a name="personalize-DescribeRecommender-response-recommender"></a>
Les propriétés du recommandeur.  
Type : objet [Recommender](API_Recommender.md)

## Erreurs
<a name="API_DescribeRecommender_Errors"></a>

 ** InvalidInputException **   
Fournissez une valeur valide pour le champ ou le paramètre.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Impossible de trouver la ressource spécifiée.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_DescribeRecommender_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :
+  [AWS Interface de ligne de commande V2 ](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK pour .NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK pour C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK pour Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK pour Java V2 ](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK pour Kotlin ](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK pour PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK pour Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK pour Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeRecommender)