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
<a name="API_ListClusters"></a>

Renvoie un tableau de`ClusterListEntry`objets de la longueur spécifiée. EACH`ClusterListEntry`contient l'état d'un cluster, l'ID d'un cluster et d'autres informations importantes sur l'état.

## Syntaxe de la demande
<a name="API_ListClusters_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## Paramètres de demande
<a name="API_ListClusters_RequestParameters"></a>

Pour plus d'informations sur les paramètres communs à toutes les actions, voir[Paramètres courants](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [MaxResults](#API_ListClusters_RequestSyntax) **   <a name="Snowball-ListClusters-request-MaxResults"></a>
Le nombre d'`ClusterListEntry`objets à renvoyer.  
Type : Entier  
Plage valide : La valeur minimale est 0. Valeur maximale fixée à 100.  
Obligatoire Non

 ** [NextToken](#API_ListClusters_RequestSyntax) **   <a name="Snowball-ListClusters-request-NextToken"></a>
Les requêtes HTTP sont sans état. Identifier quel objet vient « suivant » dans la liste des`ClusterListEntry`, vous avez la possibilité de spécifier`NextToken`comme point de départ pour votre liste renvoyée.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `.*`   
Obligatoire Non

## Syntaxe de la réponse
<a name="API_ListClusters_ResponseSyntax"></a>

```
{
   "ClusterListEntries": [ 
      { 
         "ClusterId": "string",
         "ClusterState": "string",
         "CreationDate": number,
         "Description": "string"
      }
   ],
   "NextToken": "string"
}
```

## Eléments de réponse
<a name="API_ListClusters_ResponseElements"></a>

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.

 ** [ClusterListEntries](#API_ListClusters_ResponseSyntax) **   <a name="Snowball-ListClusters-response-ClusterListEntries"></a>
EACH`ClusterListEntry`contient l'état d'un cluster, l'ID d'un cluster et d'autres informations importantes sur l'état.  
Type : Tableau d'[ClusterListEntry](API_ClusterListEntry.md)objets

 ** [NextToken](#API_ListClusters_ResponseSyntax) **   <a name="Snowball-ListClusters-response-NextToken"></a>
Les requêtes HTTP sont sans état. Si vous utilisez le module généré automatiquement`NextToken`valeur dans votre prochain`ClusterListEntry`, la liste des clusters renvoyés commencera à partir de ce point du tableau.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `.*` 

## Erreurs
<a name="API_ListClusters_Errors"></a>

Pour plus d'informations sur les erreurs communes à toutes les actions, voir[Erreurs courantes](CommonErrors.md).

 ** InvalidNextTokenException **   
Le`NextToken`chaîne a été modifiée de façon inattendue et l'opération s'est arrêtée. Exécutez l'opération sans modifier le paramètre`NextToken`String, et réessayez.  
Code d'état HTTP : 400

## Voir aussi
<a name="API_ListClusters_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/snowball-2016-06-30/ListClusters) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/ListClusters) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/ListClusters) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snowball-2016-06-30/ListClusters) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/ListClusters) 
+  [Kit AWS SDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snowball-2016-06-30/ListClusters) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/ListClusters) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/ListClusters) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/ListClusters)