這是 AWS CDK v2 開發人員指南。較舊的 CDK v1 已於 2022 年 6 月 1 日進入維護，並於 2023 年 6 月 1 日結束支援。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

從 AWS 環境中刪除一或多個 AWS CDK 堆疊。

刪除堆疊時，除非已使用 `DeletionPolicy`的 設定，否則堆疊中的資源將會銷毀`Retain`。

在刪除堆疊期間，此命令會輸出類似`cdk deploy`行為的進度資訊。

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

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

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

 **CDK 堆疊 ID**   
您應用程式要刪除之 CDK 堆疊的建構 ID。  
 *類型：*字串  
 *必要*：否

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

如需適用於所有 CDK CLI 命令的全域選項清單，請參閱[全域選項](ref-cli-cmd.md#ref-cli-cmd-options)。<a name="ref-cli-cmd-destroy-options-all"></a>

 `--all <BOOLEAN>`   
銷毀所有可用的堆疊。  
 *預設值*：`false`<a name="ref-cli-cmd-destroy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
僅銷毀請求的堆疊，不包含相依性。<a name="ref-cli-cmd-destroy-options-force"></a>

 `--force, -f <BOOLEAN>`   
在銷毀堆疊之前，請勿要求確認。<a name="ref-cli-cmd-destroy-options-help"></a>

 `--help, -h <BOOLEAN>`   
顯示命令的`cdk destroy`命令參考資訊。

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

### 刪除名為 MyStackName 的堆疊
<a name="ref-cli-cmd-destroy-examples-1"></a>

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