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.
ListFindingsV2
Recupera una lista de los hallazgos generados por el analizador especificado. ListFindings y ListFindings V2 se utilizan access-analyzer:ListFindings en el Action elemento de una declaración de política de IAM. Debe tener permiso para realizar la access-analyzer:ListFindings acción.
Para obtener información sobre las claves de filtro que puede usar para recuperar una lista de hallazgos, consulte las claves de filtro de IAM Access Analyzer en la Guía del usuario de IAM.
Sintaxis de la solicitud
POST /findingv2 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 extraerán los resultados.
Tipo: cadena
Patrón:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Obligatorio: sí
- filter
-
Un filtro que coincida con los resultados que se obtendrán.
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
- sort
-
Los criterios utilizados para ordenar.
Tipo: objeto SortCriteria
Obligatorio: no
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"findings": [
{
"analyzedAt": "string",
"createdAt": "string",
"error": "string",
"findingType": "string",
"id": "string",
"resource": "string",
"resourceOwnerAccount": "string",
"resourceType": "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 hallazgos recuperados del analizador que coinciden con los criterios de filtro especificados, si los hay.
Tipo: matriz de objetos FindingSummaryV2
- 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
- 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:
