Ändern eines Amazon DocumentDB-Clusters

Nur Cluster, die sich im Status available befinden, können geändert werden. Ein angehaltener Cluster kann nicht geändert werden. Wenn der Cluster angehalten ist, starten Sie zuerst den Cluster, warten Sie, bis der Cluster verfügbar wird, und nehmen Sie dann die gewünschten Änderungen vor. Weitere Informationen finden Sie unter Einen Amazon DocumentDB-Cluster stoppen und starten.

Using the AWS Management Console

Gehen Sie wie folgt vor, um einen bestimmten Amazon DocumentDB-Cluster mithilfe der Konsole zu ändern.

So ändern Sie einen Amazon DocumentDB-Cluster

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 () aus.

3. Geben Sie den Cluster an, den Sie ändern möchten, indem Sie die Schaltfläche links neben dem Namen des Clusters auswählen.

4. Wählen Sie Actions (Aktionen) und dann Modify (Ändern) aus.

5. Nehmen Sie im Bereich Modify Cluster: <cluster-name> (Cluster ändern: <cluster-name>) die gewünschten Änderungen vor. Sie können in den folgenden Bereichen Änderungen durchführen:

   • Clusterspezifikationen — Der Name, die Sicherheitsgruppen und das Passwort des Clusters.

   • Cluster-Speicherkonfiguration — Der Datenspeichermodus des Clusters. Wählen Sie zwischen Standard- und I/O-optimierter Konfiguration.

   • Clusteroptionen — Der Port und die Parametergruppe des Clusters.

   • Backup — Der Aufbewahrungszeitraum für Backups und das Backup-Fenster des Clusters.

   • Protokollexporte — Aktiviert oder deaktiviert den Export von Audit- oder Profiler-Protokollen.

   • Wartung — Legt das Wartungsfenster des Clusters fest.

   • Löschschutz — Aktiviert oder deaktiviert den Löschschutz auf dem Cluster. Der Löschschutz ist standardmäßig aktiviert.

6. Wenn Sie fertig sind, wählen Sie Continue (Weiter) aus, um eine Zusammenfassung Ihrer Änderungen anzuzeigen.

7. Wenn Sie mit den Änderungen zufrieden sind, können Sie Modify cluster (Cluster ändern) auswählen, um den Cluster zu ändern. Alternativ können Sie Back (Zurück) oder Cancel (Abbrechen) wählen, um die Änderungen zu bearbeiten oder abzubrechen.

Es dauert einige Minuten, bis Ihre Änderungen übernommen werden. Sie können den Cluster nur verwenden, wenn sein Status available ist. Sie können den Status des Clusters über die Konsole oder AWS CLIüberwachen. Weitere Informationen finden Sie unter Den Status eines Amazon DocumentDB-Clusters überwachen.

Using the AWS CLI

Verwenden Sie die modify-db-cluster-Operation, um den angegebenen Cluster mit der AWS CLI zu ändern. Weitere Informationen finden Sie ModifyDBClusterin der Amazon DocumentDB API DocumentDB-Referenz.

Parameter

• --db-cluster-identifier—Erforderlich. Die ID des Amazon DocumentDB-Clusters, den Sie ändern werden.

• --backup-retention-period— Fakultativ. Die Anzahl von Tagen, über die hinweg automatische Sicherungen aufbewahrt werden. Gültige Werte sind 1—35.

• --storage-type— Fakultativ. Die Speicherkonfiguration des Clusters. Gültige Werte sind standard (Standard) oder iopt1 (I/O-optimiert).

• --db-cluster-parameter-group-name— Optional. Der Name der Cluster-Parametergruppe, die für den Cluster verwendet werden soll.

• --master-user-password—Fakultativ. Das neue Passwort für den primären Datenbankbenutzer.

  Passwortbeschränkungen:

  • Die Länge beträgt [8—100] druckbare ASCII Zeichen.

  • Es können alle druckbaren ASCII Zeichen verwendet werden, mit Ausnahme der folgenden:

    • / (Schrägstrich)

    • " (doppeltes Anführungszeichen)

    • @ ('At'-Symbol)

• --new-db-cluster-identifier— Fakultativ. Die neue Cluster-ID für den Cluster beim Umbenennen eines Clusters. Dieser Wert wird als Zeichenfolge in Kleinbuchstaben gespeichert.

  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.

• --preferred-backup-window— Fakultativ. Der tägliche Zeitraum, in dem automatische Backups erstellt werden, in koordinierter Weltzeit (UTC).

  • Format: hh24:mm-hh24:mm

• --preferred-maintenance-window— Optional. Der wöchentliche Zeitraum, in dem Systemwartungen durchgeführt werden können, inUTC.

  • Format: ddd:hh24:mm-ddd:hh24:mm

  • Gültige Tage: Sun, Mon, Tue, Wed, Thu, Fri und Sat.

• --deletion-protectionoder --no-deletion-protection — Optional. Gibt an, ob der Löschschutz für diesen Cluster aktiviert werden soll. Der Löschschutz verhindert, dass ein Cluster versehentlich gelöscht wird, solange der Cluster-Löschschutz nicht deaktiviert wurde. Weitere Informationen finden Sie unter Löschen eines Amazon DocumentDB-Clusters.

• --apply-immediatelyoder --no-apply-immediately — Verwenden Sie diese Option--apply-immediately, um die Änderung sofort vorzunehmen. Verwenden Sie --no-apply-immediately, um die Änderung während des nächsten Wartungsfensters Ihres Clusters vorzunehmen.

Der folgende Code ändert die Aufbewahrungsfrist für das Backup für den Cluster sample-cluster.

Für Linux, macOS oder Unix:

aws docdb modify-db-cluster \
       --db-cluster-identifier sample-cluster \
       --apply-immediately \
       --backup-retention-period 7

Für Windows:

aws docdb modify-db-cluster ^
       --db-cluster-identifier sample-cluster ^
       --apply-immediately ^
       --backup-retention-period 7

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

{
    "DBCluster": {
        "BackupRetentionPeriod": 7,
        "DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
        "Status": "available",
        "DBClusterMembers": [
            {
                "PromotionTier": 1,
                "DBClusterParameterGroupStatus": "in-sync",
                "DBInstanceIdentifier": "sample-cluster-instance",
                "IsClusterWriter": true
            }
        ],
        "ReadReplicaIdentifiers": [],
        "AvailabilityZones": [
            "us-east-1b",
            "us-east-1c",
            "us-east-1a"
        ],
        "ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
        "PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
        "EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
        "StorageEncrypted": false,
        "MultiAZ": false,
        "AssociatedRoles": [],
        "MasterUsername": "<your-master-user-name>",
        "DBClusterIdentifier": "sample-cluster",
        "VpcSecurityGroups": [
            {
                "Status": "active",
                "VpcSecurityGroupId": "sg-77186e0d"
            }
        ],
        "HostedZoneId": "Z2SUY0A1719RZT",
        "LatestRestorableTime": "2018-06-18T21:17:05.737Z",
        "AllocatedStorage": 1,
        "Port": 27017,
        "Engine": "docdb",
        "DBClusterParameterGroup": "default.docdb3.4",
        "Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
        "DBSubnetGroup": "default",
        "PreferredBackupWindow": "00:00-00:30",
        "EngineVersion": "3.4",
        "ClusterCreateTime": "2018-06-06T19:25:47.991Z",
        "IAMDatabaseAuthenticationEnabled": false
    }
}

Es dauert einige Minuten, bis Ihre Änderungen übernommen werden. Sie können den Cluster nur verwenden, wenn sein Status available ist. Sie können den Status des Clusters über die Konsole oder AWS CLIüberwachen. Weitere Informationen finden Sie unter Den Status eines Amazon DocumentDB-Clusters überwachen.