Amazon DocumentDB クラスターの削除 - Amazon DocumentDB

英語の翻訳が提供されている場合で、内容が矛盾する場合には、英語版がオリジナルとして取り扱われます。翻訳は機械翻訳により提供されています。

Amazon DocumentDB クラスターの削除

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

削除保護

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

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

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

AWS マネジメントコンソール を使用した Amazon DocumentDB クラスターの削除

AWS マネジメントコンソール を使用してクラスターを削除するには、削除保護を無効にする必要があります。

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

  1. AWS マネジメントコンソールにサインインして、https://console.aws.amazon.com/docdb で Amazon DocumentDB コンソールを開きます。

  2. ナビゲーションペインで [クラスター] を選択します。

    ヒント

    画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン () を選択します。

  3. クラスターの名前を選択し、[設定] タブを選択します。[クラスターの詳細] セクションで、[削除保護] を見つけます。削除保護が有効化されている場合は、クラスターを変更して削除保護を無効にします。クラスターの変更については、「Amazon DocumentDB クラスターの変更」を参照してください。

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

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

  1. ナビゲーションペインで [クラスター] を選択します。

  2. [Instances (インスタンス)] 列を確認して、クラスターにインスタンスがあるかどうかを判断します。クラスターを削除する前に、そのすべてのインスタンスを削除する必要があります。詳細については、Deleting an Amazon DocumentDB Instance を参照してください。

  3. クラスターにインスタンスがあるかどうかに応じて、次のいずれかの手順を実行します。

    • クラスターにインスタンスがない場合は、クラスター名の左側にあるボタンを選択し、[アクション] を選択します。ドロップダウンメニューから [削除] を選択します。[Delete <cluster-name> (<cluster-name> を削除)] ダイアログボックスを完了したら、[Delete (削除)] を選択します。

    • クラスターに 1 つ以上のインスタンスがある場合は、次を行います。

      1. ナビゲーションペインで、[インスタンス] を選択します。

      2. クラスターごとのインスタンスを削除します。最後のインスタンスを削除すると、クラスターも削除されます。インスタンスを削除する詳細については、「Deleting an Amazon DocumentDB Instance 」を参照してください。

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

AWS CLI を使用した Amazon DocumentDB クラスターの削除

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

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

    削除する必要があるインスタンスを決定するには、次のコマンドを実行します。

    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
  2. 次に、削除保護を無効にします。

    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
  3. 最後に、クラスターを削除します。

    削除保護を無効にしたら、クラスターを削除する準備が整います。クラスターを削除するには、以下のパラメータを指定して delete-db-cluster オペレーションを使用します。

    • --db-cluster-identifier—必須。削除するクラスターの識別子。

    • --final-db-snapshot-identifier—オプション。最終スナップショットを作成する場合は、最終スナップショットの名前を指定して、このパラメータを含める必要があります。--final-db-snapshot-identifier または --skip-final-snapshot のどちらかを含める必要があります。

      命名に関する制約:

      • [1—63] 個の英字、数字、またはハイフンで構成します。

      • 1 字目は文字である必要があります。

      • ハイフンを、文字列の最後に使用したり、2 つ続けて使用したりすることはできません。

      • リージョンごと、AWS アカウントごとに、Amazon RDS、Amazon Neptune、および Amazon DocumentDB のすべてのクラスターで一意にする必要があります。

    • --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 オペレーションの出力は、削除するクラスターになります。

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