DescribeGlobalClusters - 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.

DescribeGlobalClusters

Gibt Informationen über globale Amazon DocumentDB-Cluster zurück. Diese API unterstützt Paginierung.

Anmerkung

Diese Aktion gilt nur für Amazon DocumentDB-Cluster.

Anforderungsparameter

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

Filters.Filter.N

Ein Filter, der einen oder mehrere globale DB-Cluster spezifiziert, die beschrieben werden sollen.

Unterstützte Filter: db-cluster-id akzeptiert Cluster-Identifikatoren und Cluster-Amazon-Ressourcennamen (ARNs). Die Ergebnisliste enthält nur Informationen zu den Clustern, die durch diese ARNs identifiziert wurden.

Typ: Array von Filter-Objekten

Erforderlich: Nein

GlobalClusterIdentifier

Die vom Benutzer angegebene Cluster-ID. Wenn dieser Parameter angegeben ist, werden nur Informationen aus dem spezifischen Cluster zurückgegeben. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen.

Pattern: [A-Za-z][0-9A-Za-z-:._]*

Erforderlich: Nein

Marker

Ein optionales Paginierungstoken, das von einer vorherigen DescribeGlobalClusters-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, das als Markierung bezeichnet wird, in der Antwort enthalten, sodass Sie die verbleibenden Ergebnisse abrufen können.

Typ: Ganzzahl

Erforderlich: Nein

Antwortelemente

Die folgenden Elemente werden vom Dienst zurückgegeben.

GlobalClusters. GlobalClusterMemberN

Typ: Array von GlobalCluster-Objekten

Marker

Typ: Zeichenfolge

Fehler

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

GlobalClusterNotFoundFault

Das bezieht sich GlobalClusterIdentifier nicht auf einen vorhandenen globalen Cluster.

HTTP Status Code: 404

Weitere Informationen finden Sie unter:

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