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.
GetFindingRecommendation
Récupère les informations relatives à une recommandation de recherche pour l'analyseur spécifié.
Syntaxe de la demande
GET /recommendation/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 utilisé pour générer la recommandation de découverte.
Modèle :
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Obligatoire : oui
- id
-
L'identifiant unique de la recommandation de recherche.
Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximale de 2048.
Obligatoire : oui
- maxResults
-
Le nombre maximum de résultats à renvoyer dans la réponse.
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.
- 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
{
"completedAt": "string",
"error": {
"code": "string",
"message": "string"
},
"nextToken": "string",
"recommendationType": "string",
"recommendedSteps": [
{ ... }
],
"resourceArn": "string",
"startedAt": "string",
"status": "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.
- completedAt
-
Heure à laquelle la récupération de la recommandation de résultats a été terminée.
Type : Timestamp
- error
-
Informations détaillées sur la raison pour laquelle la récupération d'une recommandation pour la découverte a échoué.
Type : objet RecommendationError
- nextToken
-
Un jeton utilisé pour la pagination des résultats renvoyés.
Type : Chaîne
- recommendationType
-
Type de recommandation pour la découverte.
Type : Chaîne
Valeurs valides :
UnusedPermissionRecommendation - recommendedSteps
-
Un ensemble d'étapes recommandées pour la découverte.
Type : tableau d’objets RecommendedStep
- resourceArn
-
L'ARN de la ressource à l'origine de la découverte.
Type : Chaîne
Modèle :
arn:[^:]*:[^:]*:[^:]*:[^:]*:.* - startedAt
-
Heure à laquelle la récupération de la recommandation de résultats a commencé.
Type : Timestamp
- status
-
État de la récupération de la recommandation de découverte.
Type : Chaîne
Valeurs valides :
SUCCEEDED | FAILED | IN_PROGRESS
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 :
