

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.

# GetFindingRecommendation
<a name="API_GetFindingRecommendation"></a>

Récupère les informations relatives à une recommandation de recherche pour l'analyseur spécifié.

## Syntaxe de la demande
<a name="API_GetFindingRecommendation_RequestSyntax"></a>

```
GET /recommendation/id?analyzerArn=analyzerArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [analyzerArn](#API_GetFindingRecommendation_RequestSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-request-uri-analyzerArn"></a>
L'[ARN de l'analyseur](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources) utilisé pour générer la recommandation de recherche.  
Modèle : `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
Obligatoire : oui

 ** [id](#API_GetFindingRecommendation_RequestSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-request-uri-id"></a>
ID unique de la recommandation de recherche.  
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 2048.  
Obligatoire : oui

 ** [maxResults](#API_GetFindingRecommendation_RequestSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-request-uri-maxResults"></a>
Le nombre maximum de résultats à renvoyer dans la réponse.  
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.

 ** [nextToken](#API_GetFindingRecommendation_RequestSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-request-uri-nextToken"></a>
Un jeton utilisé pour la pagination des résultats renvoyés.

## Corps de la requête
<a name="API_GetFindingRecommendation_RequestBody"></a>

La demande n’a pas de corps de requête.

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

```
HTTP/1.1 200
Content-type: application/json

{
   "completedAt": "string",
   "error": { 
      "code": "string",
      "message": "string"
   },
   "nextToken": "string",
   "recommendationType": "string",
   "recommendedSteps": [ 
      { ... }
   ],
   "resourceArn": "string",
   "startedAt": "string",
   "status": "string"
}
```

## Eléments de réponse
<a name="API_GetFindingRecommendation_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.

 ** [completedAt](#API_GetFindingRecommendation_ResponseSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-response-completedAt"></a>
Heure à laquelle la récupération de la recommandation de recherche a été terminée.  
Type : Timestamp

 ** [error](#API_GetFindingRecommendation_ResponseSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-response-error"></a>
Informations détaillées sur la raison pour laquelle la récupération d'une recommandation pour le résultat a échoué.  
Type : objet [RecommendationError](API_RecommendationError.md)

 ** [nextToken](#API_GetFindingRecommendation_ResponseSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-response-nextToken"></a>
Un jeton utilisé pour la pagination des résultats renvoyés.  
Type : Chaîne

 ** [recommendationType](#API_GetFindingRecommendation_ResponseSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-response-recommendationType"></a>
Type de recommandation pour le résultat.  
Type : Chaîne  
Valeurs valides : `UnusedPermissionRecommendation` 

 ** [recommendedSteps](#API_GetFindingRecommendation_ResponseSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-response-recommendedSteps"></a>
Ensemble d'étapes recommandées pour la recherche.  
Type : tableau d’objets [RecommendedStep](API_RecommendedStep.md)

 ** [resourceArn](#API_GetFindingRecommendation_ResponseSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-response-resourceArn"></a>
L'ARN de la ressource à l'origine de la découverte.  
Type : Chaîne  
Modèle : `arn:[^:]*:[^:]*:[^:]*:[^:]*:.*` 

 ** [startedAt](#API_GetFindingRecommendation_ResponseSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-response-startedAt"></a>
Heure à laquelle la récupération de la recommandation de recherche a commencé.  
Type : Timestamp

 ** [status](#API_GetFindingRecommendation_ResponseSyntax) **   <a name="accessanalyzer-GetFindingRecommendation-response-status"></a>
État de la récupération de la recommandation de recherche.  
Type : Chaîne  
Valeurs valides : `SUCCEEDED | FAILED | IN_PROGRESS` 

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

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** AccessDeniedException **   
Vous ne disposez pas d’un accès suffisant pour effectuer cette action.  
Code d’état HTTP : 403

 ** InternalServerException **   
Erreur de serveur interne.    
 ** retryAfterSeconds **   
Les secondes à attendre pour réessayer.
Code d’état HTTP : 500

 ** ResourceNotFoundException **   
La ressource spécifiée est introuvable.    
 ** resourceId **   
ID de la ressource.  
 ** resourceType **   
Type de la ressource.
Code d’état HTTP :404

 ** ThrottlingException **   
Erreur de dépassement de la limite d'étranglement.    
 ** retryAfterSeconds **   
Les secondes à attendre pour réessayer.
Code d’état HTTP : 429

 ** ValidationException **   
Erreur d'exception de validation.    
 ** fieldList **   
Liste des champs qui n'ont pas été validés.  
 ** reason **   
La raison de cette exception.
Code d’état HTTP : 400

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

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/GetFindingRecommendation) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/GetFindingRecommendation) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/GetFindingRecommendation) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/GetFindingRecommendation) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/GetFindingRecommendation) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/GetFindingRecommendation) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/GetFindingRecommendation) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/GetFindingRecommendation) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/GetFindingRecommendation) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/GetFindingRecommendation) 