Ceci est le guide du développeur du AWS CDK v2. L'ancien CDK v1 est entré en maintenance le 1er juin 2022 et a pris fin le 1er juin 2023.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Utilisez la commande d'interface de ligne de commande (CLI) `cdk rollback` du AWS Cloud Development Kit (AWS CDK) pour rétablir le dernier état stable d'une pile AWS CloudFormation défaillante ou interrompue.

**Note**  
Pour utiliser cette commande, la version 23 du modèle bootstrap doit être déployée dans votre environnement. Pour plus d'informations, consultez l'[historique des versions du modèle Bootstrap](bootstrapping-env.md#bootstrap-template-history).

Lorsque vous déployez à l'aide de`cdk deploy`, la CLI CDK annulera par défaut un déploiement ayant échoué. Si vous spécifiez `--no-rollback` avec`cdk deploy`, vous pouvez ensuite utiliser la `cdk rollback` commande pour annuler manuellement un déploiement qui a échoué. Cela initiera un retour au dernier état stable de votre pile.

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

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

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

 **ID de pile CDK**   
L'ID de construction de la pile CDK depuis votre application jusqu'à la restauration.  
 *Type* : chaîne  
 *Obligatoire* : non

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

Pour une liste des options globales qui fonctionnent avec toutes les commandes de la CLI CDK, consultez la section [Options globales](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-rollback-options-all"></a>

 `--all <BOOLEAN>`   
Annulez toutes les piles dans votre application CDK.  
 *Valeur par défaut* : `false` <a name="ref-cli-cmd-rollback-options-force"></a>

 `--force, -f <BOOLEAN>`   
Lors de l'utilisation`cdk rollback`, certaines ressources peuvent ne pas être annulées. Proposez cette option pour forcer l'annulation de toutes les ressources. Ce comportement revient à fournir l'`--orphan`option pour chaque ressource de votre pile.  
 *Valeur par défaut* : `false` <a name="ref-cli-cmd-rollback-options-help"></a>

 `--help, -h <BOOLEAN>`   
Afficher les informations de référence relatives à la `cdk rollback` commande.<a name="ref-cli-cmd-rollback-options-orphan"></a>

 `--orphan <LogicalId>`   
Lors de l'utilisation`cdk rollback`, certaines ressources peuvent ne pas être annulées. Dans ce cas, vous pouvez essayer de forcer l'annulation d'une ressource en utilisant cette option et en fournissant l'ID logique de la ressource dont la restauration n'a pas pu être annulée.  
Cette option peut être fournie plusieurs fois en une seule commande. Voici un exemple :  

```
$ cdk rollback MyStack --orphan MyLambdaFunction --orphan MyLambdaFunction2
```
Pour forcer l'annulation de toutes les ressources, utilisez plutôt l'`--force`option.<a name="ref-cli-cmd-rollback-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Nom de la pile CDK Toolkit existante avec laquelle l'environnement est amorcé.  
Par défaut, `cdk bootstrap` déploie une pile nommée `CDKToolkit` dans l' AWS environnement spécifié. Utilisez cette option pour attribuer un nom différent à votre stack bootstrap.  
La CLI CDK utilise cette valeur pour vérifier la version de votre stack bootstrap.<a name="ref-cli-cmd-rollback-options-validate-bootstrap-version"></a>

 `--validate-bootstrap-version <BOOLEAN>`   
Spécifiez s'il faut valider la version de la pile bootstrap. Indiquez `--validate-bootstrap-version=false` ou `--no-validate-bootsrap-version` désactivez ce comportement.  
 *Valeur par défaut* : `true`