ListClusters - Amazon DocumentDB
Syntaxe de la demandeParamètres de demande URICorps de la requêteSyntaxe de la réponseElé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.

ListClusters

Renvoie des informations sur les clusters élastiques Amazon DocumentDB provisionnés.

Syntaxe de la demande

GET /clusters?maxResults=maxResults&nextToken=nextToken HTTP/1.1

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

maxResults

Nombre maximal de résultats de capture instantanée du cluster élastique à recevoir dans la réponse.

Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.

nextToken

Un jeton de pagination fourni par une demande précédente. Si ce paramètre est spécifié, la réponse inclut uniquement les enregistrements situés au-delà de ce jeton, jusqu'à la valeur spécifiée parmax-results.

S'il n'y a plus de données dans la réponse, elles ne nextToken seront pas renvoyées.

Corps de la requête

La demande n’a pas de corps de requête.

Syntaxe de la réponse

HTTP/1.1 200
Content-type: application/json

{
   "clusters": [ 
      { 
         "clusterArn": "string",
         "clusterName": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

clusters

Liste des clusters élastiques Amazon DocumentDB.

Type : tableau d’objets ClusterInList

nextToken

Un jeton de pagination fourni par une demande précédente. Si ce paramètre est spécifié, la réponse inclut uniquement les enregistrements situés au-delà de ce jeton, jusqu'à la valeur spécifiée parmax-results.

S'il n'y a plus de données dans la réponse, elles ne nextToken seront pas renvoyées.

Type : chaîne

Erreurs

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

AccessDeniedException

Exception qui se produit lorsque les autorisations ne sont pas suffisantes pour effectuer une action.

Code d’état HTTP : 403

InternalServerException

Une erreur interne du serveur s'est produite.

Code d’état HTTP : 500

ThrottlingException

ThrottlingException sera lancé lorsque la demande a été refusée en raison de la limitation des demandes.

Code d’état HTTP : 429

ValidationException

Structure définissant une exception de validation.

Code d’état HTTP : 400

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 :