DescribeEvents - Amazon DocumentDB

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

DescribeEvents

Gibt Ereignisse zurück, die sich auf Instances, Sicherheitsgruppen, Snapshots und DB-Parametergruppen der letzten 14 Tage beziehen. Sie können Ereignisse abrufen, die für eine bestimmte DB-Instance, Sicherheitsgruppe, einen Snapshot oder eine Parametergruppe spezifisch sind, indem Sie den Namen als Parameter angeben. Standardmäßig werden die Ereignisse der letzten Stunde zurückgegeben.

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Duration

Die Anzahl der Minuten, in denen Ereignisse abgerufen werden sollen.

Standard: 60

Typ: Ganzzahl

Erforderlich: Nein

EndTime

Das Ende des Zeitintervalls, für das Ereignisse abgerufen werden sollen, angegeben im ISO 8601-Format.

Beispiel: 2009-07-08T18:00Z

Typ: Zeitstempel

Erforderlich: Nein

EventCategories. EventCategoryN

Eine Liste von Ereigniskategorien, die Benachrichtigungen für ein Abonnement für Ereignisbenachrichtigungen auslösen.

Typ: Zeichenfolgen-Array

Erforderlich: Nein

Filter.Filter.N

Dieser Parameter wird derzeit nicht unterstützt.

Typ: Array von Filter-Objekten

Erforderlich: Nein

Marker

Ein optionales Paginierungstoken, das von einer vorherigen Anforderung bereitgestellt wird. Wenn Sie diesen Parameter angeben, enthält die Antwort nur die Datensätze zwischen der Markierung und dem durch MaxRecords angegebenen Wert.

Typ: Zeichenfolge

Erforderlich: Nein

MaxRecords

Die maximale Anzahl der in der Antwort zurückgegebenen Datensätze. Wenn mehr Datensätze als der angegebene MaxRecords Wert vorhanden sind, ist ein Paginierungstoken (Markierung) in der Antwort enthalten, sodass die verbleibenden Ergebnisse abgerufen werden können.

Standard: 100

Einschränkungen: Mindestwert 20, Höchstwert 100.

Typ: Ganzzahl

Erforderlich: Nein

SourceIdentifier

ID der Ereignisquelle, für die Ereignisse zurückgegeben werden. Wenn nicht angegeben, werden alle Quellen zur Antwort hinzugefügt.

Einschränkungen:

  • Wenn SourceIdentifier angegeben, SourceType muss es auch angegeben werden.

  • Wenn der Quelltyp istDBInstance, DBInstanceIdentifier muss a angegeben werden.

  • Wenn der Quelltyp istDBSecurityGroup, DBSecurityGroupName muss a angegeben werden.

  • Wenn der Quelltyp istDBParameterGroup, DBParameterGroupName muss a angegeben werden.

  • Wenn der Quelltyp istDBSnapshot, DBSnapshotIdentifier muss a angegeben werden.

  • Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.

Typ: Zeichenfolge

Erforderlich: Nein

SourceType

Die Ereignisquelle zum Abrufen von Ereignissen. Wenn kein Wert angegeben ist, werden alle Ereignisse zurückgegeben.

Typ: Zeichenfolge

Zulässige Werte: db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot

Erforderlich: Nein

StartTime

Der Beginn des Zeitintervalls, für das Ereignisse abgerufen werden sollen, angegeben im ISO 8601-Format.

Beispiel: 2009-07-08T18:00Z

Typ: Zeitstempel

Erforderlich: Nein

Antwortelemente

Die folgenden Elemente werden vom Dienst zurückgegeben.

Events.Event.N

Detaillierte Informationen zu einer oder mehreren Veranstaltungen.

Typ: Array von Event-Objekten

Marker

Ein optionales Paginierungstoken, das von einer vorherigen Anforderung bereitgestellt wird. Wenn Sie diesen Parameter angeben, enthält die Antwort nur die Datensätze zwischen der Markierung und dem durch MaxRecords angegebenen Wert.

Typ: Zeichenfolge

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: