ListFindings - IAM Access Analyzer

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ListFindings

Récupère une liste des résultats générés par l'analyseur spécifié. ListFindings et ListFindings V2 sont tous deux utilisés access-analyzer:ListFindings dans l'Actionélément d'une déclaration de politique IAM. Vous devez être autorisé à effectuer cette access-analyzer:ListFindings action.

Pour en savoir plus sur les clés de filtre que vous pouvez utiliser pour récupérer une liste de résultats, voir les clés de filtre d'IAM Access Analyzer dans le guide de l'utilisateur d'IAM.

Syntaxe de la demande

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" } }

Paramètres de demande URI

La demande n’utilise pas de paramètres URI.

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

analyzerArn

L'ARN de l'analyseur à partir duquel récupérer les résultats.

Type : chaîne

Modèle : [^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}

Obligatoire : oui

filter

Un filtre correspondant aux résultats à renvoyer.

Type : mappage entre chaîne et Criterion objet

Obligatoire : non

maxResults

Le nombre maximum de résultats à renvoyer dans la réponse.

Type : entier

Obligatoire : non

nextToken

Un jeton utilisé pour la pagination des résultats renvoyés.

Type : chaîne

Obligatoire : non

sort

Ordre de tri des résultats renvoyés.

Type : objet SortCriteria

Obligatoire : non

Syntaxe de la réponse

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" }

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

findings

Liste des résultats extraits de l'analyseur qui correspondent aux critères de filtre spécifiés, le cas échéant.

Type : tableau d’objets FindingSummary

nextToken

Un jeton utilisé pour la pagination des résultats renvoyés.

Type : chaîne

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

AccessDeniedException

Vous ne disposez pas d'un accès suffisant pour effectuer cette action.

Code d’état HTTP : 403

InternalServerException

Erreur de serveur interne.

Code d’état HTTP : 500

ResourceNotFoundException

La ressource spécifiée est introuvable.

Code d’état HTTP : 404

ThrottlingException

Erreur de dépassement de la limite d'étranglement.

Code d’état HTTP : 429

ValidationException

Erreur d'exception de validation.

Code d’état HTTP : 400

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :