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

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

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

使用 AWS 雲端開發套件 (AWS CDK) 命令列界面 (CLI) `cdk rollback`命令，將失敗或暫停的堆疊從 an AWS CloudFormation 部署復原至其最後的穩定狀態。

**注意**  
若要使用此命令，您必須將引導範本的 v23 部署到您的環境。如需詳細資訊，請參閱[引導範本版本歷史記錄](bootstrapping-env.md#bootstrap-template-history)。

當您使用 部署時`cdk deploy`，CDK CLI 預設會復原失敗的部署。如果您`--no-rollback`使用 指定 `cdk deploy`，則可以使用 `cdk rollback`命令手動轉返失敗的部署。這將啟動回復至堆疊的最後一個穩定狀態。

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

```
$ cdk rollback <arguments> <options>
```

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

 **CDK 堆疊 ID**   
從您的應用程式轉返的 CDK 堆疊建構 ID。  
 *類型：*字串  
 *必要*：否

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

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

 `--all <BOOLEAN>`   
復原 CDK 應用程式中的所有堆疊。  
 *預設值*：`false`<a name="ref-cli-cmd-rollback-options-force"></a>

 `--force, -f <BOOLEAN>`   
當您使用 時`cdk rollback`，某些資源可能無法轉返。提供此選項可強制復原所有資源。這與為堆疊中的每個資源提供 `--orphan`選項的行為相同。  
 *預設值*：`false`<a name="ref-cli-cmd-rollback-options-help"></a>

 `--help, -h <BOOLEAN>`   
顯示命令的`cdk rollback`命令參考資訊。<a name="ref-cli-cmd-rollback-options-orphan"></a>

 `--orphan <LogicalId>`   
當您使用 時`cdk rollback`，某些資源可能無法轉返。發生這種情況時，您可以使用此選項並提供無法轉返的資源邏輯 ID，嘗試強制轉返資源。  
此選項可在單一命令中提供多次。以下是範例：  

```
$ cdk rollback MyStack --orphan MyLambdaFunction --orphan MyLambdaFunction2
```
若要強制復原所有資源，請改用 `--force`選項。<a name="ref-cli-cmd-rollback-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
環境開機所用的現有 CDK Toolkit 堆疊名稱。  
根據預設， 會將名為 `cdk bootstrap` 的堆疊部署`CDKToolkit`到指定的 AWS 環境中。使用此選項為您的引導堆疊提供不同的名稱。  
CDK CLI 使用此值來驗證您的引導堆疊版本。<a name="ref-cli-cmd-rollback-options-validate-bootstrap-version"></a>

 `--validate-bootstrap-version <BOOLEAN>`   
指定是否要驗證引導堆疊版本。提供 `--validate-bootstrap-version=false`或 `--no-validate-bootsrap-version`以關閉此行為。  
 *預設值*：`true`