Il s'agit du guide du développeur AWS CDK v2. L'ancien CDK v1 est entré en maintenance le 1er juin 2022 et a pris fin le 1er juin 2023.

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.

# `cdk destroy`
<a name="ref-cli-cmd-destroy"></a>

Supprimez une ou plusieurs piles AWS CDK de votre AWS environnement.

Lorsque vous supprimez une pile, les ressources de la pile sont détruites, sauf si elles ont été configurées avec un `DeletionPolicy``Retain`.

Lors de la suppression de la pile, cette commande affiche des informations de progression similaires au `cdk deploy` comportement.

## Usage
<a name="ref-cli-cmd-destroy-usage"></a>

```
$ cdk destroy <arguments> <options>
```

## Arguments
<a name="ref-cli-cmd-destroy-args"></a><a name="ref-cli-cmd-destroy-args-stack-name"></a>

 **ID de pile CDK **   
L'ID de construction de la pile CDK de votre application à supprimer.  
 *Type* : chaîne  
 *Obligatoire* : non

## Options
<a name="ref-cli-cmd-destroy-options"></a>

Pour obtenir la liste des options globales qui fonctionnent avec toutes les commandes de l'interface de ligne de commande CDK, consultez la section Options [Options globales](ref-cli-cmd.md#ref-cli-cmd-options) globales.<a name="ref-cli-cmd-destroy-options-all"></a>

 `--all <BOOLEAN>`   
Détruisez toutes les piles disponibles.  
 *Valeur par défaut* : `false` <a name="ref-cli-cmd-destroy-options-concurrency"></a>

 `--concurrency <NUMBER>`   
Détruisez plusieurs piles en parallèle tout en tenant compte des dépendances entre piles. Utilisez cette option pour accélérer les opérations de destruction. Vous devez tout de même prendre en compte AWS CloudFormation toute autre limite de débit de AWS compte.  
Fournissez un nombre pour spécifier le nombre maximum d'opérations de destruction simultanées (si la dépendance le permet) à effectuer.  
 *Valeur par défaut* : `1` <a name="ref-cli-cmd-destroy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Détruisez uniquement les piles demandées et n'incluez pas les dépendances.<a name="ref-cli-cmd-destroy-options-express"></a>

 `--express <BOOLEAN>`   
Détruisez les piles à l'aide du mode CloudFormation express. Le mode Express permet des suppressions plus rapides CloudFormation en signalant les opérations de pile comme étant terminées dès que la configuration des ressources est CloudFormation appliquée. Toutefois, CloudFormation rapporte des succès sans attendre que les ressources se stabilisent. De plus, le mode express n'effectue pas de restauration automatiquement et laissera les piles en état d'échec en cas de problème.  
Pour plus d'informations, consultez le mode [ express ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-express-mode.html) dans le Guide de * AWS CloudFormation l'utilisateur*.  
Le mode Express n'attend pas la stabilisation pour signaler le succès et n'effectue pas de restauration automatique en cas d'échec. Nous ne recommandons pas le mode express pour le démontage de la pile de production. Le mode Express est destiné aux déploiements itératifs que vous effectueriez lors du développement de votre application.
 *Valeur par défaut* : `false` <a name="ref-cli-cmd-destroy-options-force"></a>

 `--force, -f <BOOLEAN>`   
Ne demandez pas de confirmation avant de détruire les piles.<a name="ref-cli-cmd-destroy-options-help"></a>

 `--help, -h <BOOLEAN>`   
Afficher les informations de référence relatives à la `cdk destroy` commande.

## Exemples
<a name="ref-cli-cmd-destroy-examples"></a>

### Supprimer une pile nommée MyStackName
<a name="ref-cli-cmd-destroy-examples-1"></a>

```
$ cdk destroy --app='node bin/main.js' <MyStackName>
```

### Supprimer plusieurs piles en parallèle
<a name="ref-cli-cmd-destroy-examples-2"></a>

Utilisez l'`--concurrency`option with `--all` pour supprimer toutes les piles en parallèle :

```
$ cdk destroy --all --concurrency 5
```