DescribeEvents - Amazon DocumentDB

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 relatifs aux instances, aux groupes de sécurité, aux instantanés et aux groupes de paramètres de base de données des 14 derniers jours. Vous pouvez obtenir des événements spécifiques à une instance de base de données, à un groupe de sécurité, à un instantané ou à un groupe de paramètres en fournissant le nom en tant que paramètre. Par défaut, les événements de l'heure passée sont renvoyés.

Paramètres de demande

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.

Duration

Nombre de minutes pour lesquelles récupérer les événements.

Par défaut : 60

Type : entier

Obligatoire : non

EndTime

Fin de l'intervalle de temps pour lequel récupérer les événements au format ISO 8601.

Exemple : 2009-07-08T18:00Z

Type : Timestamp

Obligatoire : non

EventCategories. EventCategoryN.

Liste des catégories d'événements qui déclenchent des notifications pour un abonnement aux notifications d'événements.

Type : tableau de chaînes

Obligatoire : non

Filtres.Filter.N

Ce paramètre n'est actuellement pas pris en charge.

Type : tableau d’objets Filter

Obligatoire : non

Marker

Jeton de pagination facultatif fourni par une demande précédente. Si ce paramètre est spécifié, la réponse inclut uniquement des enregistrements supérieurs au marqueur, jusqu'à la valeur spécifiée par MaxRecords.

Type : chaîne

Obligatoire : non

MaxRecords

Nombre maximal d'enregistrements à inclure dans la réponse. S'il existe plus d'enregistrements que la MaxRecords valeur spécifiée, un jeton de pagination (marqueur) est inclus dans la réponse afin que les résultats restants puissent être récupérés.

Par défaut : 100

Contraintes : Minimum 20, maximum 100.

Type : entier

Obligatoire : non

SourceIdentifier

Identifiant de la source de l'événement pour laquelle les événements sont renvoyés. Si la valeur n'est pas spécifiée, toutes les sources sont incluses dans la réponse.

Contraintes :

  • S'il SourceIdentifier est fourni, SourceType il doit également être fourni.

  • Si le type de source estDBInstance, un DBInstanceIdentifier doit être fourni.

  • Si le type de source estDBSecurityGroup, un DBSecurityGroupName doit être fourni.

  • Si le type de source estDBParameterGroup, un DBParameterGroupName doit être fourni.

  • Si le type de source estDBSnapshot, un DBSnapshotIdentifier doit être fourni.

  • Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.

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 : db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot

Obligatoire : non

StartTime

Début de l'intervalle de temps pour lequel récupérer les événements au format ISO 8601.

Exemple : 2009-07-08T18:00Z

Type : Timestamp

Obligatoire : non

Éléments de réponse

Les éléments suivants sont renvoyés par le service.

Événements.Événement.N

Informations détaillées sur un ou plusieurs événements.

Type : tableau d’objets Event

Marker

Jeton de pagination facultatif fourni par une demande précédente. Si ce paramètre est spécifié, la réponse inclut uniquement des enregistrements supérieurs au marqueur, jusqu'à la valeur spécifiée par MaxRecords.

Type : chaîne

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

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 :