Esta es la guía para desarrolladores de AWS CDK v2. La primera versión del CDK pasó a la etapa de mantenimiento el 1.° de junio de 2022 y no cuenta con soporte desde el 1.° de junio de 2023.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Utilice el comando `cdk rollback` de la interfaz de línea de comandos de AWS Cloud Development Kit (AWS CDK) para revertir una pila fallida o pausada de una implementación de AWS CloudFormation a su último estado estable.

**nota**  
Para ejecutar este comando, debe tener la versión 23 de la plantilla de arranque implementada en su entorno. Para obtener más información, consulte el [historial de versiones de la plantilla de arranque](bootstrapping-env.md#bootstrap-template-history).

Cuando lleva a cabo la implementación mediante `cdk deploy`, la CLI del CDK revertirá una implementación fallida de forma predeterminada. Si especifica `--no-rollback` con `cdk deploy`, puede usar el comando `cdk rollback` para revertir manualmente una implementación fallida. Esto iniciará una reversión al último estado estable de la pila.

## 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 de pila de CDK**   
El ID del constructo de la pila del CDK de la aplicación que se va a restaurar.  
 *Tipo:* cadena  
 *Obligatorio*: no

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

Para obtener una lista de las opciones globales que funcionan con todos los comandos de la CLI de CDK, consulte [Opciones globales](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-rollback-options-all"></a>

 `--all <BOOLEAN>`   
Revierta todas las pilas de la aplicación CDK.  
 *Valor predeterminado*: `false` <a name="ref-cli-cmd-rollback-options-force"></a>

 `--force, -f <BOOLEAN>`   
Cuando usa `cdk rollback`, es posible que algunos recursos no se puedan revertir. Proporcione esta opción para forzar la reversión de todos los recursos. Este es el mismo comportamiento que cuando proporciona la opción `--orphan` para cada recurso de la pila.  
 *Valor predeterminado*: `false` <a name="ref-cli-cmd-rollback-options-help"></a>

 `--help, -h <BOOLEAN>`   
Muestra la información de referencia del comando `cdk rollback`.<a name="ref-cli-cmd-rollback-options-orphan"></a>

 `--orphan <LogicalId>`   
Cuando usa `cdk rollback`, es posible que algunos recursos no se puedan revertir. Cuando esto sucede, puede intentar forzar la reversión de un recurso utilizando esta opción y proporcionando el ID lógico del recurso que no se pudo revertir.  
Esta opción se puede proporcionar varias veces en un solo comando. A continuación se muestra un ejemplo:  

```
$ cdk rollback MyStack --orphan MyLambdaFunction --orphan MyLambdaFunction2
```
Para forzar la reversión de todos los recursos, utilice la opción `--force` en su lugar.<a name="ref-cli-cmd-rollback-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
El nombre de la pila de kit de herramientas de CDK existente con la que se arranca el entorno.  
De forma predeterminada, `cdk bootstrap` implementa una pila con el nombre `CDKToolkit` en el entorno de AWS especificado. Utilice esta opción para proporcionar un nombre diferente a la pila de arranque.  
La CLI de CDK usa este valor para verificar la versión de la pila de arranque.<a name="ref-cli-cmd-rollback-options-validate-bootstrap-version"></a>

 `--validate-bootstrap-version <BOOLEAN>`   
Especifique si desea validar la versión de la pila de arranque. Proporcionar `--validate-bootstrap-version=false` o `--no-validate-bootsrap-version` para desactivar este comportamiento.  
 *Valor predeterminado*: `true`