DescribeEvents - Amazon DocumentDB

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

DescribeEvents

Restituisce eventi relativi a istanze, gruppi di sicurezza, istantanee e gruppi di parametri DB degli ultimi 14 giorni. È possibile ottenere eventi specifici per una particolare istanza DB, gruppo di sicurezza, snapshot o gruppo di parametri fornendo il nome come parametro. Per impostazione predefinita, vengono restituiti gli eventi dell'ultima ora.

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

Duration

Il numero di minuti per il quale recuperare gli eventi.

Impostazione predefinita: 60

Tipo: integer

Campo obbligatorio: no

EndTime

La fine dell'intervallo di tempo per il quale recuperare gli eventi, specificato nel formato ISO 8601.

Esempio: 2009-07-08T18:00Z

Tipo: Timestamp

Campo obbligatorio: no

EventCategories. EventCategoryN.

Un elenco di categorie di eventi che attivano le notifiche per un abbonamento alla notifica di eventi.

Tipo: matrice di stringhe

Campo obbligatorio: no

Filtri.Filter.N

Questo parametro non è attualmente supportato.

Tipo: matrice di oggetti Filter

Campo obbligatorio: no

Marker

Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da MaxRecords.

Tipo: string

Campo obbligatorio: no

MaxRecords

Numero massimo di record da includere nella risposta. Se esistono più record rispetto al MaxRecords valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.

Impostazione predefinita: 100

Vincoli: minimo 20, massimo 100.

Tipo: integer

Campo obbligatorio: no

SourceIdentifier

L'identificatore dell'origine dell'evento in base a cui vengono restituiti gli eventi. Se non è specificato, tutte le origini sono incluse nella risposta.

Vincoli:

  • Se SourceIdentifier fornito, SourceType deve essere fornito anche.

  • Se il tipo di sorgente èDBInstance, DBInstanceIdentifier deve essere fornito un.

  • Se il tipo di fonte èDBSecurityGroup, DBSecurityGroupName deve essere fornito a.

  • Se il tipo di fonte èDBParameterGroup, DBParameterGroupName deve essere fornito a.

  • Se il tipo di fonte èDBSnapshot, DBSnapshotIdentifier deve essere fornito a.

  • Non può terminare con un trattino o contenere due trattini consecutivi.

Tipo: string

Campo obbligatorio: no

SourceType

L'origine eventi per la quale recuperare gli eventi. Se non viene specificato alcun valore, tutti gli eventi vengono restituiti.

Tipo: stringa

Valori validi: db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot

Campo obbligatorio: no

StartTime

L'inizio dell'intervallo di tempo per il quale recuperare gli eventi, specificato nel formato ISO 8601.

Esempio: 2009-07-08T18:00Z

Tipo: Timestamp

Campo obbligatorio: no

Elementi di risposta

I seguenti elementi vengono restituiti dal servizio.

Events.Event.N

Informazioni dettagliate su uno o più eventi.

Tipo: matrice di oggetti Event

Marker

Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da MaxRecords.

Tipo: stringa

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: