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 requête](#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 requête
<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**  
Le nom du cluster à créer.  
Le nom doit commencer par un caractère alphabétique. Le nom peut comporter jusqu'à 60 caractères. Si Slurm la comptabilité est activée, le nom peut comporter jusqu'à 40 caractères.  
Type : chaîne  
Obligatoire : oui

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

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

**revenir en arrière OnFailure**  
Si ce paramètre est défini sur`true`, l'annulation de la pile de clusters se produit si le cluster ne parvient pas à être créé. La valeur 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

**validation FailureLevel**  
Le niveau de validation minimum qui entraîne l'échec de la création du cluster. La valeur 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**  
Le nom du cluster.  
Type : chaîne

**formation des nuages StackArn**  
Le nom de ressource Amazon (ARN) de la CloudFormation pile principale.  
Type : chaîne

**formation des nuages StackStatus**  
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**  
Celui dans Région AWS lequel le cluster est créé.  
Type : chaîne

**planificateur**    
**metadata**  
Les métadonnées du planificateur    
**name**  
Le nom du planificateur.  
Type : chaîne  
**version**  
La 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\_de 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 de 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"
  }
}
```

------