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.

# Supprimer le cluster
<a name="delete-cluster"></a>

Lancez la suppression d'un cluster.

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

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

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

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

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

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

## Syntaxe de réponse
<a name="delete-cluster-response"></a>

```
{
   "cluster": {
       "clusterName": "string",
       "region": "string",
       "version": "string",
       "cloudformationStackArn": "string",
       "cloudformationStackStatus": "DELETE_IN_PROGRESS",
       "clusterStatus": "DELETE_IN_PROGRESS",
       "scheduler": {
           "type": "string",
           "metadata": {
               "name": "string",
               "version": "string"
           }
        }
    }
}
```

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

**cluster**  
Liste des instances de cluster.    
**Nom du cluster**  
Le nom d'un 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**  
L' Région AWS endroit dans 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

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

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

**Demande**

```
$ delete_cluster({{cluster_name_3x}})
```

**Réponse 200**

```
{
  "cluster": {
    "cloudformation_stack_arn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster_name_3x/16b49540-aee5-11ec-8e18-0ac1d712b241",
    "cloudformation_stack_status": "DELETE_IN_PROGRESS",
    "cluster_name": "cluster_name_3x",
    "cluster_status": "DELETE_IN_PROGRESS",
    "region": "us-east-1",
    "version": "3.2.1"
  }
}
```

------