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.

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

Créez un cluster géré dans un Région AWS.

**Topics**
+ [Syntaxe de demande](#create-cluster-request)
+ [Corps de la demande](#create-cluster-request-body)
+ [Syntaxe de réponse](#create-cluster-response)
+ [Corps de la réponse](#create-cluster-response-body)
+ [Exemple](#create-cluster-example)

## Syntaxe de demande
<a name="create-cluster-request"></a>

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

## Corps de la demande
<a name="create-cluster-request-body"></a>

**Configuration du cluster**  
La configuration du cluster sous forme de document YAML.  
Type : chaîne  
Obligatoire : oui

**Nom du cluster**  
Nom du cluster à créer.  
Le nom doit commencer par un caractère alphabétique. Le nom peut comporter jusqu'à 60 caractères. Si la Slurm comptabilité est activée, le nom peut comporter jusqu'à 40 caractères.  
Type : chaîne  
Obligatoire : oui

**run à sec**  
Si ce paramètre est défini sur`true`, effectuez uniquement la validation des demandes, mais ne créez aucune ressource. Utilisez ce paramètre pour valider la configuration du cluster. L’argument par défaut est `false`.  
Type : valeur booléenne  
Obligatoire : non

**region**  
Le dans Région AWS lequel se trouve le cluster.  
Type : chaîne  
Obligatoire : non

**rollbackOnFailure**  
Si cette valeur est définie sur`true`, la restauration de la pile du cluster se produit si le cluster ne parvient pas à être créé. L’argument par défaut est `true`.  
Type : valeur booléenne  
Obligatoire : non

**Supprimer les validateurs**  
Identifiez un ou plusieurs validateurs de configuration à supprimer.  
Type : liste de chaînes  
Format : `(ALL|type:[A-Za-z0-9]+)`  
Obligatoire : non

**validationFailureLevel**  
Le niveau de validation minimal qui entraîne l'échec de la création du cluster. L’argument par défaut est `ERROR`.  
Type : chaîne  
Valeurs valides : `INFO | WARNING | ERROR`  
Obligatoire : non

## Syntaxe de réponse
<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"
    }
  ]
}
```

## Corps de la réponse
<a name="create-cluster-response-body"></a>

**Nom du cluster**  
Nom du cluster.  
Type : chaîne

**cloudformationStackArn**  
Le nom de ressource Amazon (ARN) de la CloudFormation pile principale.  
Type : chaîne

**cloudformationStackStatus**  
Type : chaîne  
Valeurs valides : `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`

**État du cluster**  
Type : chaîne  
Valeurs valides : `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED`

**region**  
Le dans Région AWS lequel le cluster est créé.  
Type : chaîne

**planificateur**    
**métadonnées**  
Les métadonnées du planificateur    
**name**  
Nom du planificateur.  
Type : chaîne  
**version**  
Version du planificateur.  
Type : chaîne  
**type**  
Type de planificateur.  
Type : chaîne

**version**  
 AWS ParallelCluster Version utilisée pour créer le cluster.  
Type : chaîne

**messages\$1de validation**  
Liste des messages dont le niveau de validation est inférieur à`validationFailureLevel`. La liste des messages est collectée lors de la validation de la configuration.    
**id**  
L'ID du validateur.  
Type : chaîne  
**level**  
Type : chaîne  
Valeurs valides : `INFO | WARNING | ERROR`  
**message**  
Un message de validation.  
Type : chaîne  
**type**  
Type du validateur.  
Type : chaîne

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

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

**Demande**

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

**Réponse 200**

```
{
  "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"
  }
}
```

------