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.
ListFindingsV2
Récupère la 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 l'access-analyzer:ListFindingsaction.
Pour en savoir plus sur les clés de filtre que vous pouvez utiliser pour récupérer une liste de résultats, consultez la section Clés de filtre IAM Access Analyzer dans le guide de l'utilisateur IAM.
Syntaxe de la demande
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"
}
}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 les résultats seront extraits.
Type : Chaîne
Modèle :
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Obligatoire : oui
- filter
-
Un filtre permettant de faire correspondre les résultats à renvoyer.
Type : mappage de la chaîne à Criterion l'objet
Obligatoire : non
- maxResults
-
Le nombre maximum de résultats à renvoyer dans la réponse.
Type : Integer
Obligatoire : non
- nextToken
-
Un jeton utilisé pour la pagination des résultats renvoyés.
Type : chaîne
Obligatoire : non
- sort
-
Critères utilisés pour le tri.
Type : objet SortCriteria
Obligatoire : non
Syntaxe de la réponse
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"
}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 FindingSummaryV2
- 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 Types d'erreurs courants.
- AccessDeniedException
-
Vous ne disposez pas d’un accès suffisant pour effectuer cette action.
Code d’état HTTP : 403
- InternalServerException
-
Erreur de serveur interne.
- retryAfterSeconds
-
Les secondes à attendre avant de réessayer.
Code d’état HTTP : 500
- ResourceNotFoundException
-
La ressource spécifiée est introuvable.
- resourceId
-
ID de la ressource.
- resourceType
-
Type de la ressource.
Code d’état HTTP :404
- ThrottlingException
-
Erreur de dépassement de la limite d'étranglement.
- retryAfterSeconds
-
Les secondes à attendre avant de réessayer.
Code d’état HTTP : 429
- ValidationException
-
Erreur d'exception de validation.
- fieldList
-
Liste des champs qui n'ont pas été validés.
- reason
-
La raison de l'exception.
Code d’état HTTP : 400
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :
