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 au résultat spécifié. GetFinding et GetFinding V2 sont tous deux utilisés access-analyzer:GetFinding dans l'Actionélément d'une déclaration de IAM politique. Vous devez être autorisé à effectuer cette access-analyzer:GetFinding action.
Syntaxe de la requête
GET /findingv2/id?analyzerArn=analyzerArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1
URIParamètres de demande
La demande utilise les URI paramètres suivants.
- analyzerArn
-
Le ARNde l'analyseur qui a généré le résultat.
Modèle :
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Obligatoire : oui
- id
-
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 sous JSON forme formatée par le service.
- analyzedAt
-
Heure à laquelle la politique ou l'IAMentité basée sur les ressources qui a généré le résultat a été analysée.
Type : Timestamp
- createdAt
-
Heure à laquelle le résultat a été créé.
Type : Timestamp
- error
-
C'est une erreur.
Type : String
- 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,UnusedIAMUserAccessKeyUnusedIAMUserPassword, ouUnusedPermission.Type : String
Valeurs valides :
ExternalAccess | UnusedIAMRole | UnusedIAMUserAccessKey | UnusedIAMUserPassword | UnusedPermission - id
-
ID de la découverte à récupérer.
Type : String
- nextToken
-
Un jeton utilisé pour la pagination des résultats renvoyés.
Type : String
- resource
-
La ressource qui a généré le résultat.
Type : String
- resourceOwnerAccount
-
L' Compte AWS ID propriétaire de la ressource.
Type : String
- resourceType
-
Type de ressource identifié dans le résultat.
Type : String
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
-
État de la découverte.
Type : String
Valeurs valides :
ACTIVE | ARCHIVED | RESOLVED - updatedAt
-
Heure à laquelle le résultat a été mis à jour.
Type : Timestamp
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.
HTTPCode de statut : 403
- InternalServerException
-
Erreur de serveur interne.
HTTPCode de statut : 500
- ResourceNotFoundException
-
La ressource spécifiée est introuvable.
HTTPCode de statut : 404
- ThrottlingException
-
Erreur de dépassement de la limite d'étranglement.
HTTPCode de statut : 429
- ValidationException
-
Erreur d'exception de validation.
HTTPCode de statut : 400
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
