Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Recupera una lista de los resultados generados por el analizador especificado. ListFindings y ListFindings V2 se utilizan como `Action` elemento `access-analyzer:ListFindings` de una declaración de política de IAM. Debe tener permiso para realizar la `access-analyzer:ListFindings` acción.

Para obtener más información sobre las claves de filtro que puede utilizar para recuperar una lista de resultados, consulte las [claves de filtro de IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-reference-filter-keys.html) en la Guía del usuario de **IAM**.

**nota**  
ListFindings solo es compatible con analizadores de acceso externos. Debe utilizar la ListFindings versión 2 para los analizadores de acceso internos y los no utilizados.

## Sintaxis de la solicitud
<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"
   }
}
```

## Parámetros de solicitud del URI
<a name="API_ListFindings_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_ListFindings_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [analyzerArn](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-analyzerArn"></a>
El [ARN del analizador del](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources) que se van a recuperar los resultados.  
Tipo: cadena  
Patrón: `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
Obligatorio: sí

 ** [filter](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-filter"></a>
Un filtro que se adapta a los resultados obtenidos.  
Tipo: mapa de cadena a objeto [Criterion](API_Criterion.md).  
Obligatorio: no

 ** [maxResults](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-maxResults"></a>
El número máximo de resultados que se devolverán en la respuesta.  
Tipo: entero  
Obligatorio: no

 ** [nextToken](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-nextToken"></a>
Un token que se utiliza para la paginación de los resultados devueltos.  
Tipo: cadena  
Requerido: no

 ** [sort](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-sort"></a>
El orden de clasificación de los resultados devueltos.  
Tipo: objeto [SortCriteria](API_SortCriteria.md)  
Obligatorio: no

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_ListFindings_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [findings](#API_ListFindings_ResponseSyntax) **   <a name="accessanalyzer-ListFindings-response-findings"></a>
Una lista de los resultados recuperados del analizador que coinciden con los criterios de filtro especificados, si los hubiera.  
Tipo: matriz de objetos [FindingSummary](API_FindingSummary.md)

 ** [nextToken](#API_ListFindings_ResponseSyntax) **   <a name="accessanalyzer-ListFindings-response-nextToken"></a>
Un token que se utiliza para la paginación de los resultados devueltos.  
Tipo: cadena

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.  
Código de estado HTTP: 403

 ** InternalServerException **   
Error interno de servicio    
 ** retryAfterSeconds **   
Los segundos que hay que esperar para volver a intentarlo.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.    
 ** resourceId **   
El ID del recurso.  
 ** resourceType **   
El tipo de recurso.
Código de estado HTTP: 404

 ** ThrottlingException **   
Error al superar el límite de aceleración.    
 ** retryAfterSeconds **   
Los segundos que hay que esperar para volver a intentarlo.
Código de estado HTTP: 429

 ** ValidationException **   
Error de excepción de validación.    
 ** fieldList **   
Una lista de campos que no se validaron.  
 ** reason **   
El motivo de la excepción.
Código de estado HTTP: 400

## Véase también
<a name="API_ListFindings_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/ListFindings)