這是 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`行為的進度資訊。

## Usage
<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-concurrency"></a>

 `--concurrency <NUMBER>`   
平行銷毀多個堆疊，同時考慮堆疊間相依性。使用此選項可加速銷毀操作。您仍然必須將 in AWS CloudFormation 和其他 AWS 帳戶速率限制納入考量。  
提供數字以指定要同時執行的銷毀操作數目上限 （允許相依性）。  
 *預設值*：`1`<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>
```

### 平行刪除多個堆疊
<a name="ref-cli-cmd-destroy-examples-2"></a>

使用 `--concurrency`選項搭配 `--all` 平行刪除所有堆疊：

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