Ändern eines Amazon DocumentDB-Clusters

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.

• --manage-master-user-password—Fakultativ. Amazon DocumentDB generiert das Masterbenutzerkennwort und verwaltet es während seines gesamten Lebenszyklus in Secrets Manager.

• --rotate-master-user-password— Fakultativ. Secrets Manager generiert eine neue geheime Version für das bestehende Geheimnis. Die neue Version des Secrets enthält das neue primäre Benutzerkennwort. Amazon DocumentDB ändert das primäre Benutzerkennwort für den Cluster so, dass es mit dem Passwort für die neue geheime Version übereinstimmt.

  Sie müssen die --apply-immediately Option angeben, wenn Sie das primäre Passwort ändern.

• --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 mit Ausnahme der folgenden verwendet werden:

    • / (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 Amazon RDS, Amazon Neptune und Amazon DocumentDB pro AWS-Konto Region eindeutig sein.

• --preferred-backup-window— Fakultativ. Der tägliche Zeitbereich, in dem automatisierte Backups erstellt werden, in Universal Coordinated Time (UTC).

  • Format: hh24:mm-hh24:mm

• --preferred-maintenance-window—Fakultativ. Der wöchentliche Zeitbereich, in dem Systemwartungen stattfinden können, in UTC.

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

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

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

{
    "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
    }
}