DescribeGlobalClusters - Amazon DocumentDB
Paramètres de demandeÉléments de réponseErreursconsultez aussi

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.

DescribeGlobalClusters

Renvoie des informations sur les clusters globaux Amazon DocumentDB. Cette API prend en charge la pagination.

Note

Cette action s'applique uniquement aux clusters Amazon DocumentDB.

Paramètres de demande

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

Filtres.Filter.N

Filtre qui spécifie un ou plusieurs clusters de bases de données globaux à décrire.

Filtres pris en charge : db-cluster-id accepte les identifiants de cluster et les Amazon Resource Names (ARN) des clusters. La liste des résultats inclura uniquement des informations sur les clusters identifiés par ces ARN.

Type : tableau d’objets Filter

Obligatoire : non

GlobalClusterIdentifier

L'identifiant de cluster fourni par l'utilisateur. Si ce paramètre est spécifié, les informations provenant uniquement du cluster spécifique sont renvoyées. Ce paramètre n'est pas sensible à la casse.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255.

Modèle : [A-Za-z][0-9A-Za-z-:._]*

Obligatoire : non

Marker

Jeton de pagination facultatif fourni par une demande DescribeGlobalClusters 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 appelé marqueur est inclus dans la réponse afin que vous puissiez récupérer les résultats restants.

Type : entier

Obligatoire : non

Éléments de réponse

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

GlobalClusters. GlobalClusterMemberN.

Type : tableau d’objets GlobalCluster

Marker

Type : chaîne

Erreurs

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

GlobalClusterNotFoundFault

GlobalClusterIdentifierCela ne fait pas référence à un cluster mondial existant.

Code d’état HTTP : 404

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 :