Modification d'un cluster Amazon DocumentDB

Pour modifier un cluster, le cluster doit être à l'état disponible . Vous ne pouvez pas modifier un cluster qui est arrêté. Si le cluster est arrêté, commencez par démarrer le cluster, attendez que le cluster devienne disponible, puis apportez les modifications souhaitées. Pour plus d’informations, consultez Arrêt et démarrage d'un cluster Amazon DocumentDB.

Using the AWS Management Console

Utilisez la procédure suivante pour modifier un cluster Amazon DocumentDB spécifique à l'aide de la console.

Pour modifier un cluster Amazon DocumentDB

1. Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à l'adresse https://console.aws.amazon.com/docdb.

2. Dans le panneau de navigation, choisissez Clusters.

   Astuce

   Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu () dans le coin supérieur gauche de la page.

3. Spécifiez le cluster que vous souhaitez modifier en cliquant sur le bouton situé à gauche du nom du cluster.

4. Choisissez Actions, puis Modify (Modifier).

5. Dans le volet Modify cluster: <cluster-name> (Modifier le cluster : <nom-cluster>), apportez les modifications souhaitées. Vous pouvez effectuer des modifications dans les domaines suivants :

   • Spécifications du cluster : nom, groupes de sécurité et mot de passe du cluster.

   • Configuration du stockage en cluster : mode de stockage des données du cluster. Choisissez entre une configuration standard et une configuration optimisée pour les E/S.

   • Options du cluster : port et groupe de paramètres du cluster.

   • Sauvegarde : période de conservation des sauvegardes et fenêtre de sauvegarde du cluster.

   • Exportations de journaux : activez ou désactivez l'exportation des journaux d'audit ou de profilage.

   • Maintenance —Définissez la fenêtre de maintenance du cluster.

   • Protection contre la suppression : activez ou désactivez la protection contre la suppression sur le cluster. Par défaut, la protection contre la suppression est activée.

6. Lorsque vous avez terminé, choisissez Continue (Continuer) pour afficher un récapitulatif de vos modifications.

7. Si vous êtes satisfait de vos modifications, vous pouvez choisir Modify cluster (Modifier le cluster) pour modifier votre cluster. Vous pouvez également choisir Back (Précédent) ou Cancel (Annuler) pour modifier ou annuler vos modifications, respectivement.

L'application de vos modifications prend quelques minutes. Vous pouvez uniquement utiliser le cluster lorsqu'il présente le statut disponible. Vous pouvez surveiller l'état du cluster en utilisant la console ou la AWS CLI. Pour plus d’informations, consultez Surveillance de l'état d'un cluster Amazon DocumentDB.

Using the AWS CLI

Utilisez l'opération modify-db-cluster pour modifier le cluster spécifié à l'aide de l’ AWS CLI. Pour plus d'informations, consultez le ModifyDBClustermanuel Amazon DocumentDB API Reference.

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.

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

  • Tous les caractères ASCII imprimables peuvent être utilisés, à 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'Amazon RDS, Amazon Neptune et Amazon DocumentDB par région Compte AWS.

• --preferred-backup-window—Facultatif. L'intervalle de temps quotidien (en UTC) au cours duquel les sauvegardes automatiques sont créées.

  • Format : hh24:mm-hh24:mm

• --preferred-maintenance-window—Facultatif. Intervalle de temps hebdomadaire (en UTC) pendant lequel peut se produire la maintenance du système.

  • 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 plus d’informations, consultez 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.

Le code suivant modifie la période de conservation des sauvegardes pour le cluster sample-cluster.

Pour Linux, macOS ou Unix :

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

Pour Windows :

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

Le résultat de cette opération ressemble à ceci.

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

L'application de vos modifications prend quelques minutes. Vous pouvez uniquement utiliser le cluster lorsqu'il présente le statut disponible. Vous pouvez surveiller l'état du cluster en utilisant la console ou la AWS CLI. Pour plus d’informations, consultez Surveillance de l'état d'un cluster Amazon DocumentDB.