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 rollback`
<a name="ref-cli-cmd-rollback"></a>

Use o comando `cdk rollback` da interface de linha de comandos (CLI) do kit de desenvolvimento em nuvem da AWS (CDK da AWS) para reverter uma pilha com falha ou pausada de uma implantação do AWS CloudFormation para seu último estado estável.

**nota**  
Para usar este comando, você deve ter a v23 do modelo de inicialização implantada em seu ambiente. Para obter mais informações, consulte [Histórico de versões de modelos de bootstrapping](bootstrapping-env.md#bootstrap-template-history).

Quando você implanta usando `cdk deploy`, a CLI do CDK reverte uma implantação com falha por padrão. Se você especificar `--no-rollback` com `cdk deploy`, poderá usar o comando `cdk rollback` para reverter manualmente uma implantação com falha. Isso iniciará uma reversão para o último estado estável da sua pilha.

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

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

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

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

## Opções
<a name="ref-cli-cmd-rollback-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-rollback-options-all"></a>

 `--all <BOOLEAN>`   
Reverter todas as pilhas em sua aplicação CDK.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-rollback-options-force"></a>

 `--force, -f <BOOLEAN>`   
Quando você usa o `cdk rollback`, alguns recursos podem falhar na reversão. Forneça essa opção para forçar a reversão de todos os recursos. Esse é o mesmo comportamento de fornecer a opção `--orphan` para cada recurso em sua pilha.  
 *Valor padrão*: `false` <a name="ref-cli-cmd-rollback-options-help"></a>

 `--help, -h <BOOLEAN>`   
Mostrar as informações de referência do comando `cdk rollback`.<a name="ref-cli-cmd-rollback-options-orphan"></a>

 `--orphan <LogicalId>`   
Quando você usa o `cdk rollback`, alguns recursos podem falhar na reversão. Quando isso acontece, você pode tentar forçar a reversão de um recurso usando essa opção e fornecendo o ID lógico do recurso que falhou na reversão.  
Essa opção pode ser fornecida várias vezes em um único comando. Veja a seguir um exemplo:  

```
$ cdk rollback MyStack --orphan MyLambdaFunction --orphan MyLambdaFunction2
```
Para forçar a reversão de todos os recursos, use a opção `--force`.<a name="ref-cli-cmd-rollback-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
O nome da pilha existente do Kit de Ferramentas CDK com a qual o ambiente é inicializado.  
Por padrão, o `cdk bootstrap` implanta uma pilha chamada `CDKToolkit` no ambiente AWS especificado. Use essa opção para fornecer um nome diferente para sua pilha de bootstrapping.  
A CLI do CDK usa esse valor para verificar a versão da pilha de bootstrapping.<a name="ref-cli-cmd-rollback-options-validate-bootstrap-version"></a>

 `--validate-bootstrap-version <BOOLEAN>`   
Especifique se deseja validar a versão da pilha de bootstrapping. Forneça o `--validate-bootstrap-version=false` ou `--no-validate-bootsrap-version` para desativar esse comportamento.  
 *Valor padrão*: `true`