Modification d'un cluster Amazon DocumentDB

Paramètres

• --db-cluster-identifier : obligatoire. Identifiant du cluster Amazon DocumentDB que vous allez modifier.

• --backup-retention-period—Facultatif. Nombre de jours de conservation des sauvegardes automatiques. Les valeurs valides sont comprises entre 1 et 35.

• --storage-type—Facultatif. Configuration de stockage du cluster. Les valeurs valides sont standard (Standard) ou iopt1 (optimisées pour les E/S).

• --db-cluster-parameter-group-name—Facultatif. Le nom du groupe de paramètres de cluster à utiliser pour le cluster.

• --manage-master-user-password—Facultatif. Amazon DocumentDB génère le mot de passe de l'utilisateur principal et le gère tout au long de son cycle de vie dans Secrets Manager.

• --rotate-master-user-password—Facultatif. Secrets Manager génère une nouvelle version secrète pour le secret existant. La nouvelle version du secret contient le nouveau mot de passe de l'utilisateur principal. Amazon DocumentDB modifie le mot de passe de l'utilisateur principal du cluster afin qu'il corresponde au mot de passe de la nouvelle version secrète.

  Vous devez spécifier l'--apply-immediatelyoption lorsque vous faites pivoter le mot de passe principal.

• --master-user-password—Facultatif. Le nouveau mot de passe de l'utilisateur principal de la base de données.

  Contraintes du mot de passe :

  • La longueur est de [8 à 100] caractères imprimablesASCII.

  • Peut utiliser tous les ASCII caractères imprimables, à l'exception des suivants :

    • / (barre oblique)

    • " (guillemets doubles)

    • @ (symbole arobase)

• --new-db-cluster-identifier—Facultatif. Le nouvel identificateur de cluster pour le cluster lors du changement de nom d'un cluster. Cette valeur est stockée sous la forme d'une chaîne en minuscules.

  Contraintes d'affectation de noms :

  • La longueur est de [1 à 63] lettres, chiffres ou traits d'union.

  • Le premier caractère doit être une lettre.

  • Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.

  • Doit être unique pour tous les clusters d'AmazonRDS, Amazon Neptune et Amazon DocumentDB Compte AWS par région.

• --preferred-backup-window—Facultatif. La plage horaire quotidienne pendant laquelle les sauvegardes automatisées sont créées, en temps universel coordonné (UTC).

  • Format : hh24:mm-hh24:mm

• --preferred-maintenance-window—Facultatif. La plage horaire hebdomadaire pendant laquelle la maintenance du système peut avoir lieu, dansUTC.

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

  • Jours valables : Sun, Mon, Tue, Wed, Thu, Fri, et Sat.

• --deletion-protectionou --no-deletion-protection —Facultatif. Indique si la protection contre la suppression doit être activée sur ce cluster. La protection contre la suppression empêche toute suppression accidentelle d’un cluster tant que cette fonction n’est pas désactivée. Pour de plus amples informations, veuillez consulter Suppression d'un cluster Amazon DocumentDB.

• --apply-immediatelyou --no-apply-immediately —Utilisez --apply-immediately pour effectuer la modification immédiatement. Utilisez --no-apply-immediately pour effectuer la modification au cours de la fenêtre de maintenance suivante de votre cluster.

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