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

**Clustername**  
Der Name des zu erstellenden Clusters.  
Der Name muss mit einem alphabetischen Zeichen beginnen. Der Name kann bis zu 60 Zeichen lang sein. Wenn die Slurm Kontoführung 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 validieren. Der Standardwert ist `false`.  
Typ: Boolesch  
Erforderlich: Nein

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

**rollbackOnFailure**  
Wenn diese Option auf gesetzt ist`true`, erfolgt ein Rollback des Cluster-Stacks, wenn der Cluster nicht erstellt werden kann. Der Standardwert ist `true`.  
Typ: Boolesch  
Erforderlich: Nein

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

**validationFailureLevel**  
Die Mindestvalidierungsstufe, 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

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

**cloudformationStackStatus**  
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  
**Typ**  
Der Scheduler-Typ.  
Type: Zeichenkette

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

**validation\_messages**  
Eine Liste von Nachrichten mit einer Validierungsstufe unter. `validationFailureLevel` Die Liste der Nachrichten wird während der Konfigurationsvalidierung gesammelt.    
**id**  
Die ID des Validators.  
Type: Zeichenkette  
**level**  
Type: Zeichenkette  
Zulässige Werte: `INFO | WARNING | ERROR`  
**Nachricht**  
Eine Bestätigungsnachricht.  
Type: Zeichenkette  
**Typ**  
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"
  }
}
```

------