Löschen eines Amazon DocumentDB-Clusters - Amazon DocumentDB
Löschschutz

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Löschen eines Amazon DocumentDB-Clusters

Sie können einen Amazon DocumentDB-Cluster mit dem AWS Management Console oder dem AWS CLI löschen. Um einen Cluster zu löschen, muss sich der Cluster im Status available (verfügbar) befinden und es dürfen keine Instances mit ihm verknüpft sein. Wenn der Cluster angehalten ist, starten Sie zuerst den Cluster, warten Sie, bis der Cluster verfügbar wird, und löschen Sie dann den Cluster. Weitere Informationen finden Sie unter Einen Amazon DocumentDB-Cluster stoppen und starten.

Löschschutz

Zum Schutz Ihrer Cluster vor versehentlichem Löschen, können Sie den Löschschutz aktivieren. Wenn Sie mithilfe der Konsole einen Cluster erstellen, ist der Löschschutz standardmäßig aktiviert. Der Löschschutz ist jedoch standardmäßig deaktiviert, wenn Sie einen Cluster über die AWS CLI erstellen.

Amazon DocumentDB erzwingt den Löschschutz für einen Cluster, unabhängig davon, ob Sie den Löschvorgang über die Konsole oder die ausführen. AWS CLI Sie können einen Cluster nicht löschen, solange der Löschschutz aktiviert ist. Um einen Cluster mit aktiviertem Löschschutz zu löschen, müssen Sie zuerst den Cluster ändern und den Löschschutz deaktivieren.

Wenn Sie die Konsole mit aktiviertem Löschschutz für einen Cluster verwenden, können Sie die letzte Instance des Clusters nicht löschen, da dadurch auch der Cluster gelöscht werden würde. Sie können die letzte Instance eines mit Löschschutz geschützten Clusters mit der AWS CLI löschen. In diesen Fall bleibt der Cluster selbst bestehen und die Daten werden beibehalten. Sie können zum Zugriff auf die Daten neue Instances für den Cluster erstellen. Weitere Informationen zum Aktivieren und Deaktivieren des Löschschutzes siehe:

Using the AWS Management Console

Um einen Cluster mit dem zu löschen AWS Management Console, muss der Löschschutz deaktiviert sein.

So finden Sie heraus, ob der Löschschutz für einen Cluster aktiviert ist:

  1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter https://console.aws.amazon.com/docdb.

  2. Klicken Sie im Navigationsbereich auf Cluster.

    Tipp

    Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (Hamburger menu icon with three horizontal lines.) aus.

  3. Beachten Sie, dass im Cluster-Navigationsfeld in der Spalte Cluster-ID sowohl Cluster als auch Instances angezeigt werden. Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.

    Bild: Das Cluster-Navigationsfeld mit einer Liste der vorhandenen Cluster-Links und der entsprechenden Instanz-Links.

  4. Wählen Sie den Namen des Clusters und die Registerkarte Configuration (Konfiguration) aus. Suchen Sie im Abschnitt Cluster-Details die Option Deletion protection (Löschschutz). Wenn der Löschschutz aktiviert ist, bearbeiten Sie den Cluster, um den Löschschutz zu deaktivieren. Informationen über das Ändern eines Clusters finden Sie unter Ändern eines Amazon DocumentDB-Clusters.

    Nachdem Sie den Löschschutz deaktiviert haben, können Sie den Cluster löschen.

So löschen Sie einen Cluster:

  1. Klicken Sie im Navigationsbereich auf Cluster.

  2. Sehen Sie in der Spalte Instances nach, ob der Cluster Instances hat. Bevor Sie einen Cluster löschen können, müssen Sie alle seine Instances löschen. Weitere Informationen finden Sie unter Löschen einer Amazon DocumentDB DocumentDB-Instance.

  3. Abhängig davon, ob Ihr Cluster Instances hat oder nicht, führen Sie einen der folgenden Schritte aus:

    • Wenn der Cluster über keine Instances verfügt, wählen Sie die Schaltfläche links neben dem Cluster-Namen und dann Actions (Aktionen) aus. Wählen Sie im Dropdown-Menü Löschen aus. Füllen Sie das Dialogfeld <cluster-name> löschen aus und klicken Sie dann auf Löschen.

    • Wenn der Cluster eine oder mehrere Instances hat, gehen Sie wie folgt vor:

      1. Wählen Sie im Navigationsbereich Instances aus.

      2. Löschen Sie alle Instances des Clusters. Wenn Sie die letzte Instance löschen, wird der Cluster ebenfalls gelöscht. Weitere Informationen zum Löschen von Instances finden Sie unter Löschen einer Amazon DocumentDB DocumentDB-Instance.

Es dauert einige Minuten, bis der Cluster gelöscht ist. Informationen zur Überwachung des Status des Clusters finden Sie unter Den Status eines Amazon DocumentDB-Clusters überwachen.

Using the AWS CLI

Sie können einen Cluster, dem Instances zugeordnet sind, nicht löschen. Um festzustellen, welche Instances mit dem Cluster verknüpft sind, führen Sie den Befehl describe-db-clusters aus und löschen Sie alle Instances des Clusters. Deaktivieren Sie dann bei Bedarf den Löschschutz auf Ihrem Cluster und löschen Sie schließlich den Cluster.

  1. Löschen Sie zuerst alle Instances des Clusters.

    Um festzustellen, welche Instances Sie löschen müssen, führen Sie den folgenden Befehl aus.

    aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'

    Die Ausgabe dieses Vorgangs sieht etwa wie folgt aus (JSONFormat).

    [
    [
        "sample-cluster",
        [
            "sample-instance-1",
            "sample-instance-2"
        ]
    ]
]

    Wenn der Cluster, den Sie löschen möchten, Instances enthält, löschen Sie diese wie unten dargestellt.

    aws docdb delete-db-instance \
    --db-instance-identifier sample-instance

  2. Zweitens deaktivieren Sie den Löschschutz.

    Wenn Sie die AWS CLI Option verwenden, um alle Instanzen eines Clusters zu löschen, wird der Cluster nicht gelöscht. Sie müssen auch den Cluster löschen, aber dies ist nur möglich, wenn der Löschschutz deaktiviert ist.

    Um festzustellen, ob der Löschschutz für den Cluster aktiviert ist, führen Sie den folgenden Befehl aus.

    Tipp

    Um den Löschschutzstatus all Ihrer Amazon DocumentDB-Cluster zu sehen, lassen Sie den --db-cluster-identifier Parameter weg.

    aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'

    Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.

    [
    [
        "sample-cluster",
        "true"
    ]
]

    Wenn für einen Cluster der Löschschutz aktiviert ist, bearbeiten Sie den Cluster, um den Löschschutz zu deaktivieren. Führen Sie den folgenden Befehl aus, um den Löschschutz des Clusters zu deaktivieren.

    aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --no-deletion-protection \
    --apply-immediately

  3. Löschen Sie schließlich den Cluster.

    Nachdem Sie den Löschschutz deaktiviert haben, können Sie den Cluster löschen. Um einen Cluster zu löschen, verwenden Sie die delete-db-cluster-Operation mit den folgenden Parametern.

    • --db-cluster-identifier—Erforderlich. Die ID des Clusters, den Sie löschen möchten.

    • --final-db-snapshot-identifier— Fakultativ. Wenn Sie einen endgültigen Snapshot wünschen, müssen Sie diesen Parameter mit einem Namen für den endgültigen Snapshot angeben. Sie müssen entweder --final-db-snapshot-identifier oder --skip-final-snapshot angeben.

      Benennungseinschränkungen:

      • Die Länge beträgt [1—63] Buchstaben, Zahlen oder Bindestriche.

      • Muss mit einem Buchstaben beginnen.

      • Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.

      • Muss für alle Cluster in AmazonRDS, Amazon Neptune und Amazon DocumentDB pro AWS-Konto Region eindeutig sein.

    • --skip-final-snapshot— Fakultativ. Verwenden Sie diesen Parameter nur, wenn Sie vor dem Löschen Ihres Clusters keinen letzten Snapshot machen möchten. Standardmäßig wird ein letzter Snapshot erstellt. Sie müssen entweder --final-db-snapshot-identifier oder --skip-final-snapshot angeben.

    Der folgende AWS CLI Code löscht den Cluster sample-cluster mit einem endgültigen Snapshot. Die Operation schlägt fehl, wenn Instances vorhanden sind, die mit dem Cluster verknüpft sind, oder wenn der Löschschutz aktiviert ist.

    Für Linux, macOS oder Unix:

    aws docdb delete-db-cluster \
    --db-cluster-identifier sample-cluster \
    --final-db-snapshot-identifier sample-cluster-final-snapshot

    Für Windows:

    aws docdb delete-db-cluster ^
    --db-cluster-identifier sample-cluster ^
    --final-db-snapshot-identifier sample-cluster-final-snapshot

    Der folgende AWS CLI Code löscht den Cluster, sample-cluster ohne einen endgültigen Snapshot zu erstellen.

    Für Linux, macOS oder Unix:

    aws docdb delete-db-cluster \
    --db-cluster-identifier sample-cluster \
    --skip-final-snapshot

    Für Windows:

    aws docdb delete-db-cluster ^
    --db-cluster-identifier sample-cluster ^
    --skip-final-snapshot

    Die Ausgabe der delete-db-cluster-Operation ist der Cluster, den Sie löschen.

    Es dauert einige Minuten, bis der Cluster gelöscht ist. Informationen zur Überwachung des Status des Clusters finden Sie unter Den Status eines Clusters überwachen.