これは AWS CDK v2 デベロッパーガイドです。旧版の CDK v1 は 2022 年 6 月 1 日にメンテナンスを開始し、2023 年 6 月 1 日にサポートを終了しました。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

AWS Cloud Development Kit (AWS CDK) コマンドラインインターフェイス (CLI) の `cdk rollback` コマンドを使用して、失敗したスタックまたは一時停止したスタックを 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 を指定しようとすることができます。  
このオプションは、1 つのコマンドで複数回指定できます。次の内容はそれを示す例です。  

```
$ 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` は指定された AWS 環境に `CDKToolkit` という名前のスタックをデプロイします。このオプションを使用し、ブートストラップスタックに別の名前を指定します。  
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`