ListAccessPreviewFindings - Analyseur d'accès

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.

ListAccessPreviewFindings

Récupère la liste des résultats d'aperçu d'accès générés par l'aperçu d'accès spécifié.

Syntaxe de la demande

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

Paramètres de demande URI 

La demande utilise les paramètres d'URI suivants.

accessPreviewId

ID unique de l'aperçu de l'accès.

Modèle : ^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Obligatoire : oui

Corps de la demande

Cette requête accepte les données suivantes au format JSON.

analyzerArn

ARN de l'analyseur utilisé pour générer l'accès.

Type : chaîne

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

Obligatoire : oui

filtre

Critères de filtrage des résultats renvoyés.

Type : mappage Criterion chaîne/objet

Requis : non

maxResults

Nombre maximal de résultats à renvoyer dans la réponse.

Type : entier

Requis : non

nextToken

Jeton utilisé pour la pagination des résultats renvoyés.

Type : chaîne

Requis : non

Syntaxe de la réponse

HTTP/1.1 200 Content-type: application/json { "findings": [ { "action": [ "string" ], "changeType": "string", "condition": { "string" : "string" }, "createdAt": number, "error": "string", "existingFindingId": "string", "existingFindingStatus": "string", "id": "string", "isPublic": boolean, "principal": { "string" : "string" }, "resource": "string", "resourceOwnerAccount": "string", "resourceType": "string", "sources": [ { "detail": { "accessPointArn": "string" }, "type": "string" } ], "status": "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 d'aperçu d'accès qui correspondent aux critères de filtre spécifiés.

Type : tableau AccessPreviewFinding d'objets

nextToken

Jeton utilisé pour la pagination des résultats renvoyés.

Type : chaîne

Errors

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

AccessDeniedException

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

HTTP Status Code: 403

ConflictException

Erreur d'exception de conflit.

HTTP Status Code: 409

InternalServerException

Erreur de serveur interne.

Code d'état HTTP : 500

ResourceNotFoundException

La ressource spécifiée est introuvable.

HTTP Status Code: 404

ThrottlingException

Erreur de dépassement de limite.

HTTP Status Code: 429

ValidationException

Erreur d'exception de validation.

HTTP Status Code: 400

Voir aussi

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