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.

# ListFindings
<a name="API_ListFindings"></a>

Récupère une liste des résultats générés par l'analyseur spécifié. ListFindings et ListFindings V2 sont tous deux utilisés `access-analyzer:ListFindings` dans l'`Action`élément d'une déclaration de politique IAM. Vous devez être autorisé à effectuer cette `access-analyzer:ListFindings` action.

Pour en savoir plus sur les clés de filtre que vous pouvez utiliser pour récupérer une liste de résultats, voir les [clés de filtre d'IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-reference-filter-keys.html) dans le guide de l'utilisateur d'**IAM**.

**Note**  
ListFindings n'est pris en charge que pour les analyseurs d'accès externes. Vous devez utiliser la ListFindings version V2 pour les analyseurs d'accès internes et non utilisés.

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

```
POST /finding HTTP/1.1
Content-type: application/json

{
   "analyzerArn": "string",
   "filter": { 
      "string" : { 
         "contains": [ "string" ],
         "eq": [ "string" ],
         "exists": boolean,
         "neq": [ "string" ]
      }
   },
   "maxResults": number,
   "nextToken": "string",
   "sort": { 
      "attributeName": "string",
      "orderBy": "string"
   }
}
```

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

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_ListFindings_RequestBody"></a>

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

 ** [analyzerArn](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-analyzerArn"></a>
L'[ARN de l'analyseur](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources) à partir duquel récupérer les résultats.  
Type : Chaîne  
Modèle : `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
Obligatoire : oui

 ** [filter](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-filter"></a>
Un filtre correspondant aux résultats à renvoyer.  
Type : mappage entre chaîne et [Criterion](API_Criterion.md) objet  
Obligatoire : non

 ** [maxResults](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-maxResults"></a>
Le nombre maximum de résultats à renvoyer dans la réponse.  
Type : Integer  
Obligatoire : non

 ** [nextToken](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-nextToken"></a>
Un jeton utilisé pour la pagination des résultats renvoyés.  
Type : chaîne  
Obligatoire : non

 ** [sort](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-sort"></a>
Ordre de tri des résultats renvoyés.  
Type : objet [SortCriteria](API_SortCriteria.md)  
Obligatoire : non

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

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

{
   "findings": [ 
      { 
         "action": [ "string" ],
         "analyzedAt": "string",
         "condition": { 
            "string" : "string" 
         },
         "createdAt": "string",
         "error": "string",
         "id": "string",
         "isPublic": boolean,
         "principal": { 
            "string" : "string" 
         },
         "resource": "string",
         "resourceControlPolicyRestriction": "string",
         "resourceOwnerAccount": "string",
         "resourceType": "string",
         "sources": [ 
            { 
               "detail": { 
                  "accessPointAccount": "string",
                  "accessPointArn": "string"
               },
               "type": "string"
            }
         ],
         "status": "string",
         "updatedAt": "string"
      }
   ],
   "nextToken": "string"
}
```

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

 ** [findings](#API_ListFindings_ResponseSyntax) **   <a name="accessanalyzer-ListFindings-response-findings"></a>
Liste des résultats extraits de l'analyseur qui correspondent aux critères de filtre spécifiés, le cas échéant.  
Type : tableau d’objets [FindingSummary](API_FindingSummary.md)

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

## Erreurs
<a name="API_ListFindings_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_ListFindings_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/ListFindings) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/ListFindings)