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.

# createCluster
<a name="create-cluster"></a>

Erstellen Sie einen verwalteten Cluster in einem AWS-Region.

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

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

```
POST /v3/clusters
{
  "clusterName": "string",
  "clusterConfiguration": "string",
  "dryrun": boolean,
  "region": "string",
  "rollbackOnFailure", boolean,
  "suppressValidators": [ "string" ],
  "validationFailureLevel": "string"
}
```

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

**Cluster-Konfiguration**  
Die Cluster-Konfiguration als YAML-Dokument.  
Type: Zeichenkette  
Erforderlich: Ja

**Cluster-Name**  
Der Name des zu erstellenden Clusters.  
Der Name muss mit einem alphabetischen Zeichen beginnen. Der Name kann bis zu 60 Zeichen lang sein. Wenn Slurm Accounting aktiviert ist, kann der Name bis zu 40 Zeichen lang sein.  
Type: Zeichenkette  
Erforderlich: Ja

**Trockenlauf**  
Wenn auf gesetzt`true`, wird nur eine Anforderungsvalidierung durchgeführt, aber keine Ressource erstellt. Verwenden Sie diesen Parameter, um die Clusterkonfiguration zu überprüfen. Der Standardwert ist `false`.  
Typ: Boolesch  
Erforderlich: Nein

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

**Rollback OnFailure**  
Wenn auf gesetzt`true`, erfolgt ein Cluster-Stack-Rollback, wenn der Cluster nicht erstellt werden kann. Der Standardwert ist `true`.  
Typ: Boolesch  
Erforderlich: Nein

**Validatoren unterdrücken**  
Identifizieren Sie einen oder mehrere Konfigurationsvalidatoren, die unterdrückt werden sollen.  
Typ: Liste von Zeichenketten  
Format: `(ALL|type:[A-Za-z0-9]+)`  
Erforderlich: Nein

**Validierung FailureLevel**  
Die minimale Validierungsstufe, die dazu führt, dass die Clustererstellung fehlschlägt. Der Standardwert ist `ERROR`.  
Type: Zeichenkette  
Zulässige Werte: `INFO | WARNING | ERROR`  
Erforderlich: Nein

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

```
{
  "cluster": {
    "clusterName": "string",
    "region": "string",
    "version": "string",
    "cloudformationStackArn": "string",
    "cloudformationStackStatus": "CREATE_IN_PROGRESS",
    "clusterStatus": "CREATE_IN_PROGRESS",
    "scheduler": {
      "type": "string",
      "metadata": {
        "name": "string",
        "version": "string"
      }
    }
  },
  "validationMessages": [
    {
      "id": "string",
      "type": "string",
      "level": "INFO",
      "message": "string"
    }
  ]
}
```

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

**ClusterName**  
Der Name des Clusters.  
Type: Zeichenkette

**Wolkenbildung StackArn**  
Der Amazon-Ressourcenname (ARN) des CloudFormation Hauptstapels.  
Type: Zeichenkette

**Wolkenbildung StackStatus**  
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-Status**  
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`

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

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

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

**validation\_messages**  
Eine Liste von Nachrichten mit einer Validierungsstufe unter. `validationFailureLevel` Die Liste der Nachrichten wird bei der Konfigurationsüberprüfung erfasst.    
**id**  
Die ID des Validators.  
Type: Zeichenkette  
**level**  
Type: Zeichenkette  
Zulässige Werte: `INFO | WARNING | ERROR`  
**Nachricht**  
Eine Bestätigungsnachricht.  
Type: Zeichenkette  
**type**  
Der Typ des Validators.  
Type: Zeichenkette

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

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

**Anforderung**

```
$ create_cluster({{cluster_name_3x}}, {{cluster-config.yaml}})
```

**200 Antwort **

```
{
  "cluster": {
    "cloudformation_stack_arn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-3x/e0462730-50b5-11ed-99a3-0a5ddc4a34c7",
    "cloudformation_stack_status": "CREATE_IN_PROGRESS",
    "cluster_name": "cluster-3x",
    "cluster_status": "CREATE_IN_PROGRESS",
    "region": "us-east-1",
    "scheduler": {
      "type": "slurm"
    },
    "version": "3.2.1"
  }
}
```

------