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 beschreiben
<a name="describe-cluster"></a>

Holen Sie sich detaillierte Informationen zu einem vorhandenen Cluster.

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

## Erforderliche Syntax
<a name="describe-cluster-request"></a>

```
GET /v3/clusters/{{{clusterName}}}
{
  "region": "string"
}
```

## Anforderungstext
<a name="describe-cluster-request-body"></a>

**Clustername**  
Der Name des Clusters  
Type: Zeichenkette  
Erforderlich: Ja

**Region**  
Der AWS-Region , in dem sich der Cluster befindet.  
Type: Zeichenkette  
Erforderlich: Nein

## Antwortsyntax
<a name="describe-cluster-response"></a>

**Anmerkung**  
`failureReason`wurde auf `failures` AWS ParallelCluster Version 3.5.0 umgestellt.

```
{
  "clusterName": "string",
  "region": "string",
  "version": "string",
  "cloudFormationStackStatus": "CREATE_IN_PROGRESS",
  "clusterStatus": "CREATE_IN_PROGRESS",
  "scheduler": {
    "type": "string",
    "metadata": {
      "name": "string",
      "version": "string"
    }
  },
  "cloudformationStackArn": "string",
  "creationTime": "2019-08-24T14:15:22Z",
  "lastUpdatedTime": "2019-08-24T14:15:22Z",
  "clusterConfiguration": {
    "url": "string"
  },
  "computeFleetStatus": "START_REQUESTED",
  "tags": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "headNode": {
    "instanceId": "string",
    "instanceType": "string",
    "launchTime": "2019-08-24T14:15:22Z",
    "privateIpAddress": "string",
    "publicIpAddress": "string",
    "state": "pending"
  },
  "failures": [
    {
      "failureCode": "string",
      "failureReason": "string"
    }
  ],
  "loginNodes": {      
    "status": "string",
    "address": "string",
    "poolName": "string",
    "scheme": "string",
    "healthyNodes": integer,
    "unhealthyNodes": integer
  }
}
```

## Antworttext
<a name="describe-cluster-response-body"></a>

**Clustername**  
Der Name des Clusters  
Type: Zeichenkette

**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`

**Cluster-Konfiguration**    
**URL**  
Die URL der Cluster-Konfigurationsdatei.  
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`

**computeFleetStatus**  
Der Status der Rechenflotte.  
Type: Zeichenkette  
Zulässige Werte: `START_REQUESTED | STARTING | RUNNING | PROTECTED | STOP_REQUESTED | STOPPING | STOPPED | UNKNOWN | ENABLED | DISABLED`

**creationTime**  
Zeitstempel für die Erstellung des Clusters.  
Typ: DateTime

**lastUpdatedTime**  
Zeitstempel für die letzte Aktualisierung des Clusters.  
Typ: DateTime

**Region**  
Der, AWS-Region in dem der Cluster erstellt wurde.  
Type: Zeichenkette

**tags**  
Die Liste der Tags, die dem Cluster zugeordnet sind.    
**Schlüssel**  
Tag-Name.  
Type: Zeichenkette  
**Tag**  
Tag-Wert.  
Type: Zeichenkette

**version**  
Die AWS ParallelCluster Version, die zum Erstellen des Clusters verwendet wurde.  
Type: Zeichenkette

**failures**  
Die Liste der Fehler, wenn sich der Cluster-Stack im `CREATE_FAILED` Status befindet.    
**Fehlercode**  
Der Fehlercode, wenn sich der Cluster-Stack im `CREATE_FAILED` Status befindet.  
Type: Zeichenkette  
**Grund des Fehlers**  
Der Grund für den Fehler, wenn sich der Cluster-Stack im Status befindet. `CREATE_FAILED`  
Type: Zeichenkette

**head\_node**  
Der Cluster-Kopfknoten.    
**instanceId**  
Die EC2 Amazon-Instance-ID.  
Type: Zeichenkette  
**instanceType**  
Der EC2 Amazon-Instance-Typ.  
Type: Zeichenkette  
**launchTime**  
Der Zeitpunkt, zu dem die EC2 Amazon-Instance gestartet wurde.  
Typ: DateTime  
**privateIpAddress**  
Die private Cluster-IP-Adresse.  
Type: Zeichenkette  
**publicIpAddress**  
Die öffentliche Cluster-IP-Adresse.  
Type: Zeichenkette  
**state**  
Der Instanzstatus des Hauptknotens.  
Type: Zeichenkette  
Zulässige Werte: `pending | running | shutting-down | terminated | stopping | stopped`

**Scheduler**    
**Metadaten**  
Die Scheduler-Metadaten.    
**Name**  
Der Name des Schedulers.  
Type: Zeichenkette  
**version**  
Die Scheduler-Version.  
Type: Zeichenkette

**LoginNodes**    
Status  
Der Status des Anmeldeknotens.  
Type: Zeichenkette  
Zulässige Werte: `PENDING | FAILED | ACTIVE`  
address  
Die Adresse des Anmeldeknotens.  
Type: Zeichenkette  
Pool-Name  
Der Poolname des Anmeldeknotens.  
Type: Zeichenkette  
scheme  
Das Anmeldeknotenschema.  
Type: Zeichenkette  
Gesunde Knoten  
Die Anzahl der gesunden Knoten.  
Typ: Ganzzahl  
Ungesunde Knoten  
Die Anzahl der fehlerhaften Knoten.  
Typ: Ganzzahl

**Typ**  
Der Scheduler-Typ.  
Type: Zeichenkette

## Beispiel
<a name="describe-cluster-example"></a>

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

**Anforderung**

```
$ describe_cluster({{cluster_name_3x}})
```

**200 Antwort**

```
{
  "cloud_formation_stack_status": "CREATE_COMPLETE",
  "cloudformation_stack_arn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster_name_3x/16b49540-aee5-11ec-8e18-0ac1d712b241",
  "cluster_configuration": {
    "url": "https://parallelcluster-...."
  },
  "cluster_name": "cluster_name_3x",
  "cluster_status": "CREATE_COMPLETE",
  "compute_fleet_status": "RUNNING",
  "creation_time": datetime.datetime(2022, 3, 28, 22, 19, 9, 661000, tzinfo=tzlocal()),
  "head_node": {
    "instance_id": "i-abcdef01234567890",
    "instance_type": "t2.micro",
    "launch_time": datetime.datetime(2022, 3, 28, 22, 21, 56, tzinfo=tzlocal()),
    "private_ip_address": "172.31.56.3",
    "public_ip_address": "107.23.100.164",
    "state": "running"
  },
  "last_updated_time": datetime.datetime(2022, 3, 28, 22, 19, 9, 661000, tzinfo=tzlocal()),
  "region": "us-east-1",
  "tags": [
    {
      "key": "parallelcluster:version", "value": "3.2.1"
    }
  ],
  "version": "3.2.1"
}
```

------