

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.

# ListAccessPreviewFindings
<a name="API_ListAccessPreviewFindings"></a>

Recupera una lista de los resultados de la vista previa de acceso generados por la vista previa de acceso especificada.

## Sintaxis de la solicitud
<a name="API_ListAccessPreviewFindings_RequestSyntax"></a>

```
POST /access-preview/accessPreviewId HTTP/1.1
Content-type: application/json

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

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

La solicitud utiliza los siguientes parámetros URI.

 ** [accessPreviewId](#API_ListAccessPreviewFindings_RequestSyntax) **   <a name="accessanalyzer-ListAccessPreviewFindings-request-uri-accessPreviewId"></a>
El identificador único de la vista previa del acceso.  
Patrón: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Obligatorio: sí

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [analyzerArn](#API_ListAccessPreviewFindings_RequestSyntax) **   <a name="accessanalyzer-ListAccessPreviewFindings-request-analyzerArn"></a>
El [ARN del analizador utilizado para generar el](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources) acceso.  
Tipo: cadena  
Patrón: `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
Obligatorio: sí

 ** [filter](#API_ListAccessPreviewFindings_RequestSyntax) **   <a name="accessanalyzer-ListAccessPreviewFindings-request-filter"></a>
Criterios para filtrar los resultados devueltos.  
Tipo: mapa de cadena a objeto [Criterion](API_Criterion.md).  
Obligatorio: no

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

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

## Sintaxis de la respuesta
<a name="API_ListAccessPreviewFindings_ResponseSyntax"></a>

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

{
   "findings": [ 
      { 
         "action": [ "string" ],
         "changeType": "string",
         "condition": { 
            "string" : "string" 
         },
         "createdAt": "string",
         "error": "string",
         "existingFindingId": "string",
         "existingFindingStatus": "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"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListAccessPreviewFindings_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_ListAccessPreviewFindings_ResponseSyntax) **   <a name="accessanalyzer-ListAccessPreviewFindings-response-findings"></a>
Una lista de los resultados de la vista previa de acceso que coinciden con los criterios de filtro especificados.  
Tipo: matriz de objetos [AccessPreviewFinding](API_AccessPreviewFinding.md)

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

## Errores
<a name="API_ListAccessPreviewFindings_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

 ** ConflictException **   
Error de excepción de conflicto.    
 ** resourceId **   
El ID del recurso.  
 ** resourceType **   
El tipo de recurso.
Código de estado HTTP: 409

 ** 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_ListAccessPreviewFindings_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/ListAccessPreviewFindings) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/ListAccessPreviewFindings) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/ListAccessPreviewFindings) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/ListAccessPreviewFindings) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/ListAccessPreviewFindings) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/ListAccessPreviewFindings) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/ListAccessPreviewFindings) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/ListAccessPreviewFindings) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/ListAccessPreviewFindings) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/ListAccessPreviewFindings) 