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.
GetFindingV2
Récupère les informations relatives à la découverte spécifiée. GetFinding et GetFinding V2 sont tous deux utilisés access-analyzer:GetFinding dans l'Actionélément d'une déclaration de politique IAM. Vous devez être autorisé à effectuer l'access-analyzer:GetFindingaction.
Syntaxe de la demande
GET /findingv2/id?analyzerArn=analyzerArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1
Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- analyzerArn
-
L'ARN de l'analyseur qui a généré le résultat.
Modèle :
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Obligatoire : oui
- id
-
L'ID de la découverte à récupérer.
Obligatoire : oui
- maxResults
-
Le nombre maximum de résultats à renvoyer dans la réponse.
- nextToken
-
Un jeton utilisé pour la pagination des résultats renvoyés.
Corps de la requête
La demande n’a pas de corps de requête.
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"analyzedAt": "string",
"createdAt": "string",
"error": "string",
"findingDetails": [
{ ... }
],
"findingType": "string",
"id": "string",
"nextToken": "string",
"resource": "string",
"resourceOwnerAccount": "string",
"resourceType": "string",
"status": "string",
"updatedAt": "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.
- analyzedAt
-
Heure à laquelle la politique basée sur les ressources ou l'entité IAM qui a généré le résultat a été analysée.
Type : Timestamp
- createdAt
-
Heure à laquelle la découverte a été créée.
Type : Timestamp
- error
-
Une erreur.
Type : Chaîne
- findingDetails
-
Un message localisé qui explique le résultat et fournit des conseils sur la manière d'y remédier.
Type : tableau d’objets FindingDetails
- findingType
-
Type du résultat . Pour les analyseurs d’accès externes, le type est
ExternalAccess. Pour les analyseurs d’accès non utilisés, le type peut êtreUnusedIAMRole,UnusedIAMUserAccessKey,UnusedIAMUserPasswordouUnusedPermission. Pour les analyseurs d’accès internes, le type estInternalAccess.Type : Chaîne
Valeurs valides :
ExternalAccess | UnusedIAMRole | UnusedIAMUserAccessKey | UnusedIAMUserPassword | UnusedPermission | InternalAccess - id
-
L'ID de la découverte à récupérer.
Type : Chaîne
- nextToken
-
Un jeton utilisé pour la pagination des résultats renvoyés.
Type : Chaîne
- resource
-
La ressource qui a généré la découverte.
Type : Chaîne
- resourceOwnerAccount
-
Compte AWS ID propriétaire de la ressource.
Type : Chaîne
- resourceType
-
Type de ressource identifié dans le résultat.
Type : Chaîne
Valeurs valides :
AWS::S3::Bucket | AWS::IAM::Role | AWS::SQS::Queue | AWS::Lambda::Function | AWS::Lambda::LayerVersion | AWS::KMS::Key | AWS::SecretsManager::Secret | AWS::EFS::FileSystem | AWS::EC2::Snapshot | AWS::ECR::Repository | AWS::RDS::DBSnapshot | AWS::RDS::DBClusterSnapshot | AWS::SNS::Topic | AWS::S3Express::DirectoryBucket | AWS::DynamoDB::Table | AWS::DynamoDB::Stream | AWS::IAM::User - status
-
L'état de la découverte.
Type : Chaîne
Valeurs valides :
ACTIVE | ARCHIVED | RESOLVED - updatedAt
-
Heure à laquelle les résultats ont été mis à jour.
Type : Timestamp
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 :
