

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Recupera un elenco di risultati generati dall'analizzatore specificato. ListFindings e ListFindings V2 vengono entrambi utilizzati `access-analyzer:ListFindings` nell'`Action`elemento di una dichiarazione di policy IAM. È necessario disporre dell'autorizzazione per eseguire l'`access-analyzer:ListFindings`azione.

Per ulteriori informazioni sulle chiavi di filtro che puoi utilizzare per recuperare un elenco di risultati, consulta le [chiavi di filtro di IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-reference-filter-keys.html) nella **IAM User Guide**.

**Nota**  
ListFindings è supportato solo per gli analizzatori di accesso esterni. È necessario utilizzare ListFindings V2 per gli analizzatori di accesso interni e non utilizzati.

## Sintassi della richiesta
<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"
   }
}
```

## Parametri della richiesta URI:
<a name="API_ListFindings_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_ListFindings_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [analyzerArn](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-analyzerArn"></a>
L'[ARN dell'analizzatore da cui](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources) recuperare i risultati.  
Tipo: stringa  
Modello: `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
Obbligatorio: sì

 ** [filter](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-filter"></a>
Un filtro da abbinare per i risultati da restituire.  
Tipo: mappa da stringa a [Criterion](API_Criterion.md) oggetto  
Obbligatorio: no

 ** [maxResults](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-maxResults"></a>
Il numero massimo di risultati da restituire nella risposta.  
Tipo: Integer  
Obbligatorio: no

 ** [nextToken](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-nextToken"></a>
Un token utilizzato per l'impaginazione dei risultati restituiti.  
▬Tipo: stringa  
Obbligatorio: no

 ** [sort](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-sort"></a>
Il criterio di ordinamento dei risultati restituiti.  
Tipo: oggetto [SortCriteria](API_SortCriteria.md)  
Obbligatorio: no

## Sintassi della risposta
<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"
}
```

## Elementi di risposta
<a name="API_ListFindings_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [findings](#API_ListFindings_ResponseSyntax) **   <a name="accessanalyzer-ListFindings-response-findings"></a>
Un elenco di risultati recuperati dall'analizzatore che corrispondono ai criteri di filtro specificati, se presenti.  
Tipo: matrice di oggetti [FindingSummary](API_FindingSummary.md)

 ** [nextToken](#API_ListFindings_ResponseSyntax) **   <a name="accessanalyzer-ListFindings-response-nextToken"></a>
Un token utilizzato per l'impaginazione dei risultati restituiti.  
Tipo: String

## Errori
<a name="API_ListFindings_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.  
Codice di stato HTTP: 403

 ** InternalServerException **   
Errore interno del server.    
 ** retryAfterSeconds **   
I secondi di attesa per riprovare.
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
La risorsa specificata non è stata trovata.    
 ** resourceId **   
L'ID della risorsa.  
 ** resourceType **   
Il tipo di risorsa.
Codice di stato HTTP: 404

 ** ThrottlingException **   
Errore di limitazione superato.    
 ** retryAfterSeconds **   
I secondi di attesa per riprovare.
Codice di stato HTTP: 429

 ** ValidationException **   
Errore di eccezione di convalida.    
 ** fieldList **   
Un elenco di campi che non sono stati convalidati.  
 ** reason **   
Il motivo dell'eccezione.
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListFindings_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/ListFindings) 