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

# ListClusters
<a name="API_elastic_ListClusters"></a>

Restituisce informazioni sui cluster elastici di Amazon DocumentDB forniti.

## Sintassi della richiesta
<a name="API_elastic_ListClusters_RequestSyntax"></a>

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

## Parametri della richiesta URI
<a name="API_elastic_ListClusters_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_elastic_ListClusters_RequestSyntax) **   <a name="documentdb-elastic_ListClusters-request-uri-maxResults"></a>
Il numero massimo di risultati di snapshot del cluster elastico da ricevere nella risposta.  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.

 ** [nextToken](#API_elastic_ListClusters_RequestSyntax) **   <a name="documentdb-elastic_ListClusters-request-uri-nextToken"></a>
Un token di impaginazione fornito da una richiesta precedente. Se viene specificato questo parametro, la risposta include solo i record oltre questo token, fino al valore specificato da`max-results`.  
Se non ci sono più dati nella risposta, non `nextToken` verrà restituita.

## Corpo della richiesta
<a name="API_elastic_ListClusters_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_ListClusters_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

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

## Elementi di risposta
<a name="API_elastic_ListClusters_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [clusters](#API_elastic_ListClusters_ResponseSyntax) **   <a name="documentdb-elastic_ListClusters-response-clusters"></a>
Un elenco di cluster elastici di Amazon DocumentDB.  
Tipo: matrice di oggetti [ClusterInList](API_elastic_ClusterInList.md)

 ** [nextToken](#API_elastic_ListClusters_ResponseSyntax) **   <a name="documentdb-elastic_ListClusters-response-nextToken"></a>
Un token di impaginazione fornito da una richiesta precedente. Se viene specificato questo parametro, la risposta include solo i record oltre questo token, fino al valore specificato da`max-results`.  
Se non ci sono più dati nella risposta, non `nextToken` verrà restituita.  
Tipo: String

## Errori
<a name="API_elastic_ListClusters_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

## Vedi anche
<a name="API_elastic_ListClusters_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ListClusters)