Verwalten von Elastic-Cluster-Snapshots - Amazon DocumentDB
Erstellen eines manuellen Elastic-Cluster-SnapshotsAnzeigen eines elastischen Cluster-SnapshotsWiederherstellen eines elastischen Clusters aus einem SnapshotKopieren eines Elastic-Cluster-SnapshotsLöschen eines elastischen Cluster-SnapshotsVerwalten eines automatischen Backups für Elastic-Cluster-Snapshots

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.

Verwalten von Elastic-Cluster-Snapshots

Manuelle Snapshots können erstellt werden, nachdem ein elastischer Cluster erstellt wurde. Automatisierte Backups werden erstellt, sobald der elastische Cluster-Snapshot erstellt wird.

Anmerkung

Ihr elastischer Cluster muss sich im Available Status befinden, damit ein manueller Snapshot erstellt werden kann.

In diesem Abschnitt wird erläutert, wie Sie Elastic-Cluster-Snapshots erstellen, anzeigen, wiederherstellen und löschen können.

Die folgenden Themen zeigen, wie Sie verschiedene Aufgaben ausführen, wenn Sie mit Amazon DocumentDB-Snapshots für elastische Cluster arbeiten.

Erstellen eines manuellen Elastic-Cluster-Snapshots

In diesem Abschnitt wird erläutert, wie Sie einen manuellen Snapshot eines elastischen Clusters mit der AWS Management Console oder AWS CLI mit den folgenden Anweisungen erstellen.

Using the AWS Management Console

So erstellen Sie einen manuellen Elastic-Cluster-Snapshot mit der AWS Management Console:

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon DocumentDB-Konsole.

  2. Wählen Sie im Navigationsbereich die Option Snapshots.

    Tipp

    Wenn der Navigationsbereich auf der linken Seite Ihres Bildschirms nicht angezeigt wird, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.

  3. Wählen Sie auf der Seite Snapshots die Option Create (Erstellen) aus.

  4. Wählen Sie auf der Seite Cluster-Snapshot erstellen im Feld Cluster-ID Ihren elastischen Cluster aus der Dropdown-Liste aus.

    Geben Sie im Feld Snapshot-Kennung eine eindeutige Kennung für Ihren elastischen Cluster ein.

    Wählen Sie Erstellen.

    Diagramm: Snapshot erstellen des elastischen Clusters
Anmerkung

Alternativ können Sie auf das Dialogfeld Cluster-Snapshot erstellen zugreifen, indem Sie die Seite Cluster aufrufen, das Kontrollkästchen neben Ihrem Cluster aktivieren und dann Aktionen und dann Snapshot erstellen auswählen.

Ihr elastischer Cluster-Snapshot wird jetzt bereitgestellt. Dies kann bis zu einigen Minuten dauern. Sie können Ihren Snapshot anzeigen und wiederherstellen, wenn der Status als Available in der Liste Snapshots angezeigt wird.

Using the AWS CLI

Um einen manuellen Elastic-Cluster-Snapshot mit der zu erstellen AWS CLI, verwenden Sie die -create-cluster-snapshotOperation mit den folgenden Parametern:

  • --snapshot-name—Erforderlich. Der Name des Cluster-Snapshots, den Sie erstellen möchten.

  • --cluster-arn—Erforderlich. Die ARN-ID des Clusters, für den Sie einen Snapshot erstellen möchten.

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Für Linux, macOS oder Unix:

aws docdb-elastic create-cluster-snapshot \
    --snapshot-name sample-snapshot-1 \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

Für Windows:

aws docdb-elastic create-cluster-snapshot ^
    --snapshot-name sample-snapshot-1 ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

Anzeigen eines elastischen Cluster-Snapshots

In diesem Abschnitt wird erläutert, wie Sie Snapshot-Informationen für elastische Cluster mithilfe der AWS Management Console oder AWS CLI mit den folgenden Anweisungen anzeigen.

Using the AWS Management Console

So zeigen Sie Informationen zu einem bestimmten Elastic-Cluster-Snapshot mithilfe der an AWS Management Console:

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon DocumentDB-Konsole.

  2. Wählen Sie im Navigationsbereich die Option Snapshots.

    Tipp

    Wenn der Navigationsbereich auf der linken Seite Ihres Bildschirms nicht angezeigt wird, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.

  3. Wählen Sie auf der Seite Snapshots Ihren Snapshot aus der Liste aus, indem Sie auf den Namen in der Spalte Snapshot-Kennung klicken.

  4. Zeigen Sie die Informationen Ihres Snapshots unter Details an.

    Diagramm: Snapshot der elastischen Cluster-Ansicht
Using the AWS CLI

Um Informationen zu einem bestimmten Elastic-Cluster-Snapshot mithilfe der anzuzeigen AWS CLI, verwenden Sie die -get-cluster-snapshotOperation mit den folgenden Parametern:

  • --snapshot-arn—Erforderlich. Die ARN-ID des Snapshots, für den Sie Informationen benötigen.

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Für Linux, macOS oder Unix:

aws docdb-elastic get-cluster-snapshot \
    --snapshot-arn sampleResourceName

Für Windows:

aws docdb-elastic get-cluster-snapshot ^
    --snapshot-arn sampleResourceName

Um Informationen zu einem bestimmten Elastic-Cluster-Snapshot mithilfe der anzuzeigen AWS CLI, verwenden Sie die -get-cluster-snapshotOperation mit den folgenden Parametern:

  • --snapshot-arn—Erforderlich. Die ARN-ID des Snapshots, für den Sie Informationen benötigen.

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Für Linux, macOS oder Unix:

aws docdb-elastic get-cluster-snapshot \
    --snapshot-arn sampleResourceName

Für Windows:

aws docdb-elastic get-cluster-snapshot ^
    --snapshot-arn sampleResourceName

Um Informationen zu allen elastischen Cluster-Snapshots mithilfe der anzuzeigen AWS CLI, verwenden Sie die -list-cluster-snapshotsOperation mit den folgenden Parametern:

  • --snapshot-type—Optional. Der Typ der Cluster-Snapshots, die zurückgegeben werden sollen. Sie können einen der folgenden Werte angeben:

    • automated – Gibt alle Cluster-Snapshots zurück, die Amazon DocumentDB automatisch für Ihr AWS Konto erstellt hat.

    • manual – Gibt alle Cluster-Snapshots zurück, die Sie manuell für Ihr AWS Konto erstellt haben.

    • shared – Gibt alle manuellen Cluster-Snapshots zurück, die für Ihr AWS Konto freigegeben wurden.

    • public – Gibt alle Cluster-Snapshots zurück, die als öffentlich markiert wurden.

  • --next-token—Optional. Ein optionales Paginierungstoken, das von einer vorherigen Anforderung bereitgestellt wird. Wenn dieser Parameter angegeben ist, enthält die Antwort nur Datensätze über dieses Token hinaus bis zu dem von angegebenen Wertmax-results.

  • --max-results—Optional. Die maximale Anzahl der Ergebnisse, die in die Antwort aufgenommen werden sollen. Wenn mehr Ergebnisse als der angegebene max-results Wert vorhanden sind, wird ein Paginierungstoken (next-token) in die Antwort aufgenommen, damit die verbleibenden Ergebnisse abgerufen werden können.

    • Standard: 100

    • Mindestens 20, maximal 100

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Für Linux, macOS oder Unix:

aws docdb-elastic list-cluster-snapshots \
    --snapshot-type  value \
    --next-token  value \
    --max-results 50

Für Windows:

aws docdb-elastic list-cluster-snapshots ^
    --snapshot-type  value ^
    --next-token  value ^
    --max-results 50

Wiederherstellen eines elastischen Clusters aus einem Snapshot

In diesem Abschnitt wird erläutert, wie Sie einen elastischen Cluster aus einem Snapshot mithilfe der AWS Management Console oder AWS CLI mit den folgenden Anweisungen wiederherstellen.

Using the AWS Management Console

So stellen Sie einen elastischen Cluster aus einem Snapshot mithilfe der wieder her AWS Management Console:

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon DocumentDB-Konsole.

  2. Wählen Sie im Navigationsbereich die Option Snapshots.

    Tipp

    Wenn der Navigationsbereich auf der linken Seite Ihres Bildschirms nicht angezeigt wird, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.

  3. Wählen Sie in der Spalte Snapshot-ID die Schaltfläche links neben dem Snapshot aus, die Sie zum Wiederherstellen eines Clusters verwenden möchten.

  4. Wählen Sie Aktionen und dann Wiederherstellen aus.

    Diagramm: Elastic-Cluster-Wiederherstellung aus Snapshot

  5. Geben Sie auf der Seite Snapshot wiederherstellen einen Namen für den neuen Cluster in das Feld Cluster-ID ein.

    Anmerkung

    Für jede manuelle Snapshot-Wiederherstellung müssen Sie einen neuen Cluster erstellen.

  6. Wählen Sie im Feld Virtual Private Cloud (VPC) eine VPC aus der Dropdown-Liste aus.

  7. Für Subnetze und VPC-Sicherheitsgruppen können Sie die Standardeinstellungen verwenden oder drei Subnetze Ihrer Wahl und bis zu drei VPC-Sicherheitsgruppen (mindestens eine) auswählen.

  8. Wenn Sie mit der Cluster-Konfiguration zufrieden sind, wählen Sie Restore cluster (Cluster wiederherstellen) aus und warten Sie, bis Ihr Cluster wiederhergestellt ist.

Using the AWS CLI

Um einen elastischen Cluster mithilfe der aus einem Snapshot wiederherzustellen AWS CLI, verwenden Sie die -restore-cluster-from-snapshotOperation mit den folgenden Parametern:

  • --cluster-name—Erforderlich. Der aktuelle Name des elastischen Clusters, wie er während der Erstellung oder letzten Änderung eingegeben wurde.

  • --snapshot-arn—Erforderlich. Die ARN-ID des Snapshots, der zur Wiederherstellung des Clusters verwendet wird.

  • --vpc-security-group-ids—Optional. Eine oder mehrere Amazon EC2- und Amazon Virtual Private Cloud (VPC)-Sicherheitsgruppen, die dem Cluster zugeordnet werden sollen.

  • --kms-key-id—Optional. Konfigurieren Sie die KMS-Schlüsselkennung für einen verschlüsselten Cluster.

    Die KMS-Schlüsselkennung ist der Amazon-Ressourcenname (ARN) für den AWS KMS Verschlüsselungsschlüssel. Wenn Sie einen Cluster mit demselben Amazon Web Services-Konto erstellen, das den KMS-Verschlüsselungsschlüssel besitzt, der zur Verschlüsselung des neuen Clusters verwendet wird, können Sie den KMS-Schlüssel-Alias anstelle des ARN für den KMS-Verschlüsselungsschlüssel verwenden.

    Wenn in kein Verschlüsselungsschlüssel angegeben ist KmsKeyId und der StorageEncrypted Parameter „true“ ist, verwendet Amazon DocumentDB Ihren Standardverschlüsselungsschlüssel.

  • --subnet-ids—Optional. Netzwerk-Subnetz-IDs.

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Für Linux, macOS oder Unix:

aws docdb-elastic restore-cluster-from-snapshot \
     --cluster-name elastic-sample-cluster \
     --snapshot-arn sampleResourceName \
     --vpc-security-group-ids value ec-65f40350 \
     --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
     --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

Für Windows:

aws docdb-elastic restore-cluster-from-snapshot ^
     --cluster-name elastic-sample-cluster ^
     --snapshot-arn sampleResourceName ^
     --vpc-security-group-ids value ec-65f40350 ^
     --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
     --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

Kopieren eines Elastic-Cluster-Snapshots

In Amazon DocumentDB können Sie manuelle und automatische Elastic-Cluster-Snapshots innerhalb derselben Region und innerhalb desselben Kontos kopieren. In diesem Abschnitt wird erläutert, wie Sie einen elastischen Cluster-Snapshot mit der AWS Management Console oder kopieren AWS CLI.

Using the AWS Management Console

So kopieren Sie einen elastischen Cluster-Snapshot mit der AWS Management Console:

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon DocumentDB-Konsole.

  2. Wählen Sie im Navigationsbereich die Option Snapshots.

    Tipp

    Wenn der Navigationsbereich auf der linken Seite Ihres Bildschirms nicht angezeigt wird, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.

  3. Wählen Sie in der Spalte Snapshot-ID die Schaltfläche links neben dem Snapshot aus, den Sie kopieren möchten.

  4. Wählen Sie Aktionen und dann Kopieren aus.

    Diagramm: Elastic Cluster Copy Snapshot

  5. Geben Sie für Neue Snapshot-ID den Namen des neuen Snapshots ein.

  6. Aktivieren Sie für Tags kopieren das Kontrollkästchen, wenn Sie alle Tags aus dem elastischen Quell-Cluster-Snapshot in den elastischen Ziel-Cluster-Snapshot kopieren möchten.

  7. Wählen Sie für Verschlüsselung entweder einen Standard AWS -KMS-Schlüssel oder einen KMS-Schlüssel Ihrer Wahl aus. Mit der zweiten Option können Sie einen vorhandenen KMS-Schlüssel auswählen, den Sie bereits erstellt haben, oder einen neuen Schlüssel erstellen.

  8. Wählen Sie Snapshot kopieren, wenn Sie fertig sind.

Using the AWS CLI

Um einen elastischen Cluster-Snapshot mit der zu kopieren AWS CLI, verwenden Sie die -copy-cluster-snapshotOperation mit den folgenden Parametern:

  • ‐‐source-db-cluster-snapshot-identifier—Erforderlich. Die Kennung des vorhandenen Elastic-Cluster-Snapshots, der kopiert wird. Der elastische Cluster-Snapshot muss vorhanden sein und sich im Status „Verfügbar“ befinden. Wenn Sie den Snapshot in eine andere kopieren AWS-Region, muss diese Kennung im ARN-Format für die Quell- vorliegen AWS-Region. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.

  • ‐‐target-db-cluster-snapshot-identifier—Erforderlich. Die Kennung des neuen elastischen Cluster-Snapshots, der aus dem vorhandenen Cluster-Snapshot erstellt werden soll. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.

    Einschränkungen des Ziel-Snapshot-Namens:

    • Kann nicht der Namen eines vorhandenen Snapshots sein.

    • 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.

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Für Linux, macOS oder Unix:

aws docdb-elastic copy-cluster-snapshot \
     ‐‐source-cluster-snapshot-arn <sample ARN> \
     ‐‐target-cluster-snapshot-name my-target-copied-snapshot

Für Windows:

aws docdb-elastic copy-cluster-snapshot ^
     ‐‐source-cluster-snapshot-arn <sample ARN> ^
     ‐‐target-cluster-snapshot-name my-target-copied-snapshot

Löschen eines elastischen Cluster-Snapshots

In diesem Abschnitt wird erläutert, wie Sie einen elastischen Cluster-Snapshot mithilfe von AWS Management Console oder löschen AWS CLI.

Using the AWS Management Console

So stellen Sie einen elastischen Cluster aus einem Snapshot mithilfe der wieder her AWS Management Console:

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon DocumentDB-Konsole.

  2. Wählen Sie im Navigationsbereich die Option Snapshots.

    Tipp

    Wenn der Navigationsbereich auf der linken Seite Ihres Bildschirms nicht angezeigt wird, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.

  3. Wählen Sie in der Spalte Snapshot-ID die Schaltfläche links neben dem Snapshot aus, die Sie zum Wiederherstellen eines Clusters verwenden möchten.

  4. Wählen Sie Aktionen und dann Löschen aus.

    Diagramm: Elastic Cluster Delete Snapshot

  5. Wählen Sie im Dialogfeld Snapshot löschen die Option Löschen aus.

Using the AWS CLI

Um einen elastischen Cluster-Snapshot mit der zu löschen AWS CLI, verwenden Sie die -delete-cluster-snapshotOperation mit den folgenden Parametern:

  • --snapshot-arn—Erforderlich. Die ARN-ID des Snapshots, der zur Wiederherstellung des Clusters verwendet wird.

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Für Linux, macOS oder Unix:

aws docdb-elastic delete-cluster-snapshot \
     --snapshot-arn sampleResourceName

Für Windows:

aws docdb-elastic delete-cluster-snapshot ^
     --snapshot-arn sampleResourceName

Verwalten eines automatischen Backups für Elastic-Cluster-Snapshots

Amazon DocumentDB erstellt tägliche Snapshots Ihrer elastischen Cluster. Sie können das bevorzugte Backup-Fenster und den Aufbewahrungszeitraum für Backups in einer neuen oder vorhandenen Konfiguration für elastische Cluster-Snapshots angeben. In diesem Abschnitt wird erläutert, wie Sie automatische Backup-Parameter in einem elastischen Cluster-Snapshot festlegen, indem Sie entweder die AWS Management Console oder verwenden AWS CLI.

Using the AWS Management Console

So legen Sie ein automatisches Backup für einen neuen Elastic-Cluster-Snapshot mithilfe der fest AWS Management Console:

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon DocumentDB-Konsole.

  2. Klicken Sie im Navigationsbereich auf Cluster.

    Tipp

    Wenn der Navigationsbereich auf der linken Seite Ihres Bildschirms nicht angezeigt wird, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.

  3. Wählen Sie in der Spalte Cluster-ID die Schaltfläche links neben dem Cluster aus, für den Sie die Backup-Einstellungen ändern möchten.

  4. Wählen Sie Aktionen und dann Ändern aus.

  5. Bearbeiten Sie im Abschnitt Backup die Felder entsprechend Ihren Backup-Anforderungen.

    Screenshot mit dem Bereich "Backup (Sicherung)" und den Schritten zur Konfiguration des Cluster-Sicherungsfensters

    1. Aufbewahrungszeitraum für Backups – Wählen Sie in der Liste die Anzahl der Tage aus, für die automatische Backups dieses Clusters aufbewahrt werden sollen, bevor sie gelöscht werden.

    2. Backup-Fenster – Legen Sie die tägliche Zeit und Dauer fest, in der Amazon DocumentDB Backups dieses Clusters erstellen soll.

      1. Wählen Sie Fenster auswählen, wenn Sie die Zeit und Dauer der Erstellung von Backups konfigurieren möchten.

        Startzeit – Wählen Sie in der ersten Liste die Startzeitstunde (UTC) zum Starten Ihrer automatischen Backups aus. Wählen Sie in der zweiten Liste die Minute für den Beginn der automatischen Backups aus.

        Dauer – Wählen Sie in der Liste die Anzahl der Stunden aus, die dem Erstellen automatischer Backups zugewiesen werden sollen.

      2. Wählen Sie Keine Präferenz, wenn Amazon DocumentDB den Zeitpunkt und die Dauer der Erstellung von Backups auswählen soll.

  6. Wählen Sie Cluster ändern, wenn Sie fertig sind.

Using the AWS CLI

Um eine automatische Sicherung für einen neuen elastischen Cluster-Snapshot mithilfe der einzurichten AWS CLI, verwenden Sie die -create-cluster-snapshotOperation mit den folgenden Parametern:

  • --preferred-backup-window—Optional. Der täglich bevorzugte Zeitraum, in dem automatische Backups erstellt werden. Die Standardeinstellung ist ein 30-minütiges Fenster, das zufällig aus einem 8-Stunden-Zeitblock für jede ausgewählt wird AWS-Region.

    Einschränkungen:

    • Muss im Format hh24:mi-hh24:mi angegeben werden.

    • Muss in Universal Coordinated Time (UTC) angegeben werden.

    • Darf nicht mit dem bevorzugten Wartungsfenster in Konflikt treten.

    • Muss mindestens 30 Minuten betragen.

  • --backup-retention-period—Optional. Die Anzahl von Tagen, über die hinweg automatische Sicherungen aufbewahrt werden. Der Standardwert lautet 1.

    Einschränkungen:

    • Muss einen Mindestwert von 1 angeben.

    • Der Bereich liegt zwischen 1 und 35.

Anmerkung

Automatisierte Backups werden nur erstellt, wenn sich der Cluster im Status „aktiv“ befindet.

Anmerkung

Sie können die backup-retention-period Parameter preferred-backup-window und eines vorhandenen elastischen Clusters auch mit dem aws docdb-elastic update-cluster Befehl ändern.

Ersetzen Sie im folgenden Beispiel jeden Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Im folgenden create-cluster Beispiel wird der Amazon DocumentDB-Beispiel-Cluster mit dem Aufbewahrungszeitraum für automatische Backups von 7 Tagen und einem bevorzugten Backup-Fenster von 18:00 bis 18:30 UTC erstellt.

Für Linux, macOS oder Unix:

aws docdb-elastic create-cluster \
     --cluster-name sample-cluster \
     --shard-capacity 2 \
     --shard-count 2 \
     --admin-user-name SampleAdmin \
     --auth-type PLAIN_TEXT \
     --admin-user-password SamplePass123! \
     --preferred-backup-window 18:00-18:30 \ 
     --backup-retention-period 7

Für Windows:

aws docdb-elastic create-cluster ^
     --cluster-name sample-cluster ^
     --shard-capacity 2 ^
     --shard-count 2 ^
     --admin-user-name SampleAdmin ^
     --auth-type PLAIN_TEXT ^
     --admin-user-password SamplePass123! ^
     --preferred-backup-window 18:00-18:30 ^ 
     --backup-retention-period 7