Amazon DocumentDB クラスターの削除

Amazon DocumentDB クラスターは、 AWS Management Console またはを使用して削除できます AWS CLI。クラスターを削除するには、クラスターが 使用可能状態であり、インスタンスが関連付けられていないことが必要です。クラスターが停止している場合は、まずクラスターを起動し、クラスターが使用可能になるまで待ってから、クラスターを削除します。詳細については、「Amazon DocumentDB クラスターの停止と起動」を参照してください。

削除保護

クラスターが誤って削除されることを防ぐために、削除保護を有効にできます。コンソールを使用してクラスターを作成する場合は、デフォルトで削除保護が有効になっています。ただし、 AWS CLIを使用してクラスターを作成する場合、削除保護はデフォルトで無効になっています。

Amazon DocumentDB は、コンソールまたは AWS CLIを使用した削除オペレーションのどちらの実行でも、クラスターに対する削除保護を適用します。削除保護が有効になっている場合、クラスターを削除することはできません。削除に対する保護が有効化されているクラスターを削除するには、まずクラスターを変更して削除保護を無効化する必要があります。

クラスター上で削除保護を有効にしたコンソールを使用する場合、クラスターの最後のインスタンスを削除することはできません。これを削除するとクラスターも削除されるためです。 AWS CLIを使用すると、削除保護されているクラスターの最後のインスタンスを削除できます。ただし、クラスター自体は削除されず、データを保持されます。クラスターに新しいインスタンスを作成して、このデータにアクセスできます。削除保護の有効化および無効化の詳細については、以下を参照してください。

Using the AWS Management Console

を使用してクラスターを削除するには AWS Management Console、削除保護を無効にする必要があります。

クラスターで削除保護が有効になっているかどうかを確認するには

にサインインし AWS Management Console、https://console.aws.amazon.com/docdb で Amazon DocumentDB コンソールを開きます。
ナビゲーションペインで クラスター を選択します。

ヒント
画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン () を選択します。
Clusters ナビゲーションボックスで、[クラスター識別子] 列にはクラスターとインスタンスの両方が表示されることに注意してください。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。
クラスターの名前を選択し、[設定] タブを選択します。[クラスターの詳細] セクションで、[削除保護] を見つけます。削除保護が有効化されている場合は、クラスターを変更して削除保護を無効にします。クラスターの変更については、「Amazon DocumentDB クラスターの変更」を参照してください。

[Deletion protection (削除保護)] が無効化されると、クラスターを削除する準備が完了します。

クラスターを削除するには

ナビゲーションペインで [Clusters] (クラスター) を選択します。
[Instances (インスタンス)] 列を確認して、クラスターにインスタンスがあるかどうかを判断します。クラスターを削除する前に、そのすべてのインスタンスを削除する必要があります。詳細については、「Amazon DocumentDB インスタンスの削除」を参照してください。
クラスターにインスタンスがあるかどうかに応じて、次のいずれかの手順を実行します。
- クラスターにインスタンスがない場合は、クラスター名の左側にあるボタンを選択し、[アクション] を選択します。ドロップダウンメニューから [削除] を選択します。[Delete <cluster-name> (<cluster-name> を削除)] ダイアログボックスを完了したら、[Delete (削除)] を選択します。
- クラスターに 1 つ以上のインスタンスがある場合は、次を行います。
  1. ナビゲーションペインで、[インスタンス] を選択します。
  2. クラスターごとのインスタンスを削除します。最後のインスタンスを削除すると、クラスターも削除されます。インスタンスを削除する詳細については、「Amazon DocumentDB インスタンスの削除」を参照してください。

クラスターが削除されるまでに数分かかります。クラスターのステータスをモニタリングするには、「Amazon DocumentDB クラスターのステータスのモニタリング」を参照してください。

Using the AWS CLI

インスタンスが関連付けられているクラスターを削除することはできません。クラスターに関連付けられているインスタンスを確認するには、describe-db-clusters コマンドを実行し、クラスターのすべてのインスタンスを削除します。次に、必要に応じてクラスターの削除保護を無効にし、最後にクラスターを削除します。

最初に、クラスターのすべてのインスタンスを削除します。

削除する必要があるインスタンスを決定するには、次のコマンドを実行します。
```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
このオペレーションからの出力は次のようになります (JSON 形式）。
```
[
    [
        "sample-cluster",
        [
            "sample-instance-1",
            "sample-instance-2"
        ]
    ]
]
                  
```
削除するクラスターにインスタンスがある場合は、次に示すように、そのインスタンスを削除します。
```
aws docdb delete-db-instance \
    --db-instance-identifier sample-instance
```
次に、削除保護を無効にします。

AWS CLI を使用してクラスターのすべてのインスタンスを削除しても、クラスターは削除されません。クラスターも削除する必要があるときには、削除保護が無効化されている場合にのみこれを行うことができます。

クラスターに削除保護が有効化されているかどうかを判断するには、次のコマンドを実行します。

ヒント
すべての Amazon DocumentDB クラスターの削除保護状態を確認するには、--db-cluster-identifier パラメータを省略します。
```
aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
```
このオペレーションによる出力は、次のようになります。
```
[
    [
        "sample-cluster",
        "true"
    ]
]
                  
```
削除保護が有効になっている場合、クラスターを変更して削除保護を無効にします。クラスターの削除保護を無効にするには、次のコマンドを実行します。
```
aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --no-deletion-protection \
    --apply-immediately
                  
```
最後に、クラスターを削除します。

削除保護を無効にしたら、クラスターを削除する準備が整います。クラスターを削除するには、以下のパラメータを指定して delete-db-cluster オペレーションを使用します。
- --db-cluster-identifier — 必須削除するクラスターの識別子。
- --final-db-snapshot-identifier - オプション。最終スナップショットを作成する場合は、最終スナップショットの名前を指定して、このパラメータを含める必要があります。--final-db-snapshot-identifier または --skip-final-snapshot のどちらかを含める必要があります。
  
  命名に関する制約:
  - 1 − 63 個の英字、数字、またはハイフンで構成します。
  - 1 字目は英字である必要があります。
  - ハイフンを、文字列の最後に使用したり、2 つ続けて使用したりすることはできません。
  - Amazon 、Amazon Neptune RDS、および Amazon DocumentDB のすべてのクラスターで、リージョンごとに AWS アカウントごとに一意である必要があります。 Amazon Neptune
- --skip-final-snapshot - オプション。クラスターを削除する前に最終スナップショットを作成しない場合のみ、このパラメータを使用します。デフォルトでは、最終スナップショットを作成します。--final-db-snapshot-identifier または --skip-final-snapshot のどちらかを含める必要があります。
次の AWS CLI コードは、最終スナップショットsample-clusterを持つクラスターを削除します。クラスターに関連付けられるインスタンスがある場合、あるいは削除保護が有効化されている場合、このオペレーションは失敗します。
Linux、macOS、Unix の場合:
```
aws docdb delete-db-cluster \
    --db-cluster-identifier sample-cluster \
    --final-db-snapshot-identifier sample-cluster-final-snapshot
```
Windows の場合:
```
aws docdb delete-db-cluster ^
    --db-cluster-identifier sample-cluster ^
    --final-db-snapshot-identifier sample-cluster-final-snapshot
```
次の AWS CLI コードは、最終スナップショットを作成しsample-clusterなくてもクラスターを削除します。
Linux、macOS、Unix の場合:
```
aws docdb delete-db-cluster \
    --db-cluster-identifier sample-cluster \
    --skip-final-snapshot
```
Windows の場合:
```
aws docdb delete-db-cluster ^
    --db-cluster-identifier sample-cluster ^
    --skip-final-snapshot
```
delete-db-cluster オペレーションの出力は、削除するクラスターになります。

クラスターが削除されるまでに数分かかります。クラスターのステータスをモニタリングするには、「クラスターのステータスのモニタリング」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

クラスターの停止と開始

クラスターのスケーリング

Amazon DocumentDB クラスターの削除

削除保護

クラスターで削除保護が有効になっているかどうかを確認するには

ヒント

クラスターを削除するには

ヒント