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.

# Cluster auflisten
<a name="list-clusters"></a>

Rufen Sie eine Liste vorhandener Cluster ab.

**Topics**
+ [Erforderliche Syntax](#list-clusters-request)
+ [Anforderungstext](#list-clusters-request-body)
+ [Antwortsyntax](#list-clusters-response)
+ [Antworttext](#list-clusters-response-body)
+ [Beispiel](#list-clusters-example)

## Erforderliche Syntax
<a name="list-clusters-request"></a>

```
GET /v3/clusters
{
  "clusterStatus": "string",
  "nextToken": "string",
  "region": "string"
}
```

## Anforderungstext
<a name="list-clusters-request-body"></a>

**ClusterStatus**  
Nach Clusterstatus filtern. Die Standardeinstellung ist „Alle Cluster“.  
Type: Zeichenkette  
Zulässige Werte: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED`  
Erforderlich: nein

**nextToken**  
Das Token für den nächsten Ergebnissatz.  
Type: Zeichenkette  
Erforderlich: Nein

**Region**  
Der AWS-Region der Cluster.  
Type: Zeichenkette  
Erforderlich: Nein

## Antwortsyntax
<a name="list-clusters-response"></a>

```
{
  "nextToken": "string",
  "clusters": [
    {
      "clusterName": "string",
      "region": "string",
      "version": "string",
      "cloudformationStackArn": "string",
      "cloudformationStackStatus": "CREATE_IN_PROGRESS",
      "clusterStatus": "CREATE_IN_PROGRESS",
      "scheduler": {
        "type": "string",
        "metadata": {
          "name": "string",
          "version": "string"
        }
      }
    }
  ]
}
```

## Antworttext
<a name="list-clusters-response-body"></a>

**Cluster**    
**cloudformationStackArn**  
Der Amazon-Ressourcenname (ARN) des CloudFormation Hauptstapels.  
Type: Zeichenkette  
**cloudformationStackStatus**  
Der CloudFormation Stack-Status.  
Type: Zeichenkette  
Zulässige Werte: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE`  
**Clustername**  
Der Name des Clusters  
Type: Zeichenkette  
**Clusterstatus**  
Der Clusterstatus.  
Type: Zeichenkette  
Zulässige Werte: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED`  
**Scheduler**    
**Metadaten**  
Die Scheduler-Metadaten.    
**Name**  
Der Name des Schedulers.  
Type: Zeichenkette  
**version**  
Die Scheduler-Version.  
Type: Zeichenkette  
**Typ**  
Der Typ des Schedulers.  
Type: Zeichenkette  
**Region**  
Der, AWS-Region in dem der Cluster erstellt wird.  
Type: Zeichenkette  
**version**  
Die AWS ParallelCluster Version, die zum Erstellen des Clusters verwendet wurde.  
Type: Zeichenkette

**nextToken**  
Ein Token, mit dem der nächste Ergebnissatzes abgerufen werden kann, bzw. `null`, wenn keine weiteren Ergebnisse vorliegen.  
Type: Zeichenkette

## Beispiel
<a name="list-clusters-example"></a>

------
#### [ Python ]

**Anforderung**

```
$ list_clusters()
```

**200 Antwort**

```
{
  'clusters': 
   [
      {
        'cloudformation_stack_arn': 'arn:aws:cloudformation:us-east-1:123456789012:stack/cluster_name_3x/16b49540-aee5-11ec-8e18-0ac1d712b241',
        'cloudformation_stack_status': 'CREATE_COMPLETE',
        'cluster_name': 'cluster_name_3x',
        'cluster_status': 'CREATE_COMPLETE',
        'region': 'us-east-1',
        'version': '3.2.1'
      },
      ...
   ]
}
```

------