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
Recupera una lista de los resultados de la vista previa de acceso generados por la vista previa de acceso especificada.
Sintaxis de la solicitud
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
La solicitud utiliza los siguientes parámetros URI.
- accessPreviewId
-
El identificador único de la vista previa de 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
La solicitud acepta los siguientes datos en formato JSON.
- analyzerArn
-
El ARN del analizador utilizado para generar el acceso.
Tipo: cadena
Patrón:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Obligatorio: sí
- filter
-
Criterios para filtrar los hallazgos devueltos.
Tipo: mapa de cadena a objeto Criterion.
Obligatorio: no
- maxResults
-
El número máximo de resultados que se devolverá en la respuesta.
Tipo: entero
Obligatorio: no
- nextToken
-
Un token utilizado para la paginación de los resultados devueltos.
Tipo: cadena
Requerido: no
Sintaxis de la respuesta
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
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- findings
-
Una lista de los resultados de la vista previa de Access que coinciden con los criterios de filtro especificados.
Tipo: matriz de objetos AccessPreviewFinding
- nextToken
-
Un token utilizado para la paginación de los resultados devueltos.
Tipo: cadena
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Tipos de errores comunes.
- AccessDeniedException
-
No tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403
- ConflictException
-
Un 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 de espera 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 de superación del límite de velocidad.
- retryAfterSeconds
-
Los segundos de espera 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 han validado.
- reason
-
El motivo de la excepción.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
