

Este é o Guia do desenvolvedor do AWS CDK v2. O CDK v1 antigo entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Exclua uma ou mais pilhas do CDK da AWS do seu ambiente da AWS.

Quando você exclui uma pilha, os recursos na pilha serão destruídos, a menos que tenham sido configurados com um `DeletionPolicy` de `Retain`.

Durante a exclusão da pilha, esse comando produzirá informações de andamento semelhantes ao comportamento `cdk deploy`.

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

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

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

 **ID da pilha CDK**   
O ID de constructo da pilha CDK da sua aplicação a ser excluído.  
 *Tipo:* string  
 *Obrigatório*: não

## Opções
<a name="ref-cli-cmd-destroy-options"></a>

Para obter uma lista das opções globais que funcionam com todos os comandos da CLI do CDK, consulte [Opções globais](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-destroy-options-all"></a>

 `--all <BOOLEAN>`   
Destrua todas as pilhas disponíveis.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-destroy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Destrua apenas as pilhas solicitadas e não inclua dependências.<a name="ref-cli-cmd-destroy-options-force"></a>

 `--force, -f <BOOLEAN>`   
Não peça confirmação antes de destruir as pilhas.<a name="ref-cli-cmd-destroy-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk destroy`.

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

### Excluir uma pilha chamada MyStackName
<a name="ref-cli-cmd-destroy-examples-1"></a>

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