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.
DescribeEvents
Renvoie les événements liés aux clusters, aux groupes de sécurité et aux groupes de paramètres. Vous pouvez obtenir des événements spécifiques à un cluster, un groupe de sécurité ou un groupe de paramètres en particulier en fournissant le nom en tant que paramètre. Par défaut, seuls les événements survenus au cours de la dernière heure sont renvoyés ; toutefois, vous pouvez récupérer jusqu'à 14 jours d'événements si nécessaire.
Syntaxe de la requête
{
"Duration": number
,
"EndTime": number
,
"MaxResults": number
,
"NextToken": "string
",
"SourceName": "string
",
"SourceType": "string
",
"StartTime": number
}
Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- Duration
-
Le nombre de minutes d'événements à récupérer.
Type : entier
Obligatoire : non
- EndTime
-
Fin de l'intervalle de temps pour lequel récupérer les événements au format ISO 8601. Exemple : 2017-03-30T 07:03:49.555 Z
Type : Timestamp
Obligatoire : non
- MaxResults
-
Nombre maximal d'enregistrements à inclure dans la réponse. S'il existe plus d'enregistrements que la MaxResults valeur spécifiée, un jeton est inclus dans la réponse afin que les résultats restants puissent être récupérés.
Type : entier
Obligatoire : non
- NextToken
-
Argument facultatif à transmettre si le nombre total d'enregistrements dépasse la valeur de MaxResults. Si NextToken est renvoyé, d'autres résultats sont disponibles. La valeur de NextToken est un jeton de pagination unique pour chaque page. Réappelez en utilisant le jeton renvoyé pour récupérer la page suivante. Gardez tous les autres arguments inchangés.
Type : chaîne
Obligatoire : non
- SourceName
-
Identifiant de la source de l'événement pour laquelle les événements sont renvoyés. Si elles ne sont pas spécifiées, toutes les sources sont incluses dans la réponse.
Type : chaîne
Obligatoire : non
- SourceType
-
Source de l'événement pour laquelle récupérer les événements. Si aucune valeur n'est spécifiée, tous les événements sont renvoyés.
Type : chaîne
Valeurs valides :
node | parameter-group | subnet-group | cluster | user | acl
Obligatoire : non
- StartTime
-
Début de l'intervalle de temps pour lequel récupérer les événements au format ISO 8601. Exemple : 2017-03-30T 07:03:49.555 Z
Type : Timestamp
Obligatoire : non
Syntaxe de la réponse
{
"Events": [
{
"Date": number,
"Message": "string",
"SourceName": "string",
"SourceType": "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.
- Events
-
Une liste d'événements. Chaque élément de la liste contient des informations détaillées sur un événement.
Type : tableau d’objets Event
- NextToken
-
Argument facultatif à transmettre si le nombre total d'enregistrements dépasse la valeur de MaxResults. Si NextToken est renvoyé, d'autres résultats sont disponibles. La valeur de NextToken est un jeton de pagination unique pour chaque page. Réappelez en utilisant le jeton renvoyé pour récupérer la page suivante. Gardez tous les autres arguments inchangés.
Type : chaîne
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InvalidParameterCombinationException
-
Code d’état HTTP : 400
- InvalidParameterValueException
-
Code d’état HTTP : 400
- ServiceLinkedRoleNotFoundFault
-
Code d’état HTTP : 400
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :