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
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 en la Guía del usuario de IAM.
Sintaxis de la solicitud
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
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- analyzerArn
-
El ARN del analizador del que se van a recuperar los resultados.
Tipo: String
Patrón:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Obligatorio: sí
- filter
-
Un filtro que se adapta a los resultados obtenidos.
Tipo: mapa de cadena a objeto Criterion.
Obligatorio: no
- maxResults
-
El número máximo de resultados que se devolverán en la respuesta.
Tipo: entero
Obligatorio: no
- nextToken
-
Un token que se utiliza para la paginación de los resultados devueltos.
Tipo: cadena
Requerido: no
- sort
-
El orden de clasificación de los resultados devueltos.
Tipo: objeto SortCriteria
Obligatorio: no
Sintaxis de la respuesta
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",
"resourceOwnerAccount": "string",
"resourceType": "string",
"sources": [
{
"detail": {
"accessPointAccount": "string",
"accessPointArn": "string"
},
"type": "string"
}
],
"status": "string",
"updatedAt": "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 recuperados del analizador que coinciden con los criterios de filtro especificados, si los hubiera.
Tipo: matriz de objetos FindingSummary
- nextToken
-
Un token que se utiliza 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 Errores comunes.
- AccessDeniedException
-
No tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403
- InternalServerException
-
Error interno de servicio
Código de estado HTTP: 500
- ResourceNotFoundException
-
No se ha encontrado el recurso especificado.
Código de estado HTTP: 404
- ThrottlingException
-
Error al superar el límite de regulación.
Código de estado HTTP: 429
- ValidationException
-
Error en la excepción de validació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:
