这是 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` 命令将失败或暂停的堆栈从 AWS CloudFormation 部署回滚到其最后的稳定状态。

**注意**  
要使用此命令，环境中必须部署了 v23 引导模板。有关更多信息，请参阅[引导模板版本历史记录](bootstrapping-env.md#bootstrap-template-history)。

使用 `cdk deploy` 部署时，默认情况下，CDK CLI 将回滚失败的部署。如果使用 `cdk deploy` 来指定 `--no-rollback`，则可以使用 `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`