Réinitialisation des groupes de paramètres du cluster Amazon DocumentDB - Amazon DocumentDB

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Réinitialisation des groupes de paramètres du cluster Amazon DocumentDB

Vous pouvez rétablir certaines ou toutes les valeurs des paramètres d'un groupe de paramètres de cluster Amazon DocumentDB à leurs valeurs par défaut en utilisant le AWS Management Console ou le AWS Command Line Interface (AWS CLI) pour réinitialiser le groupe de paramètres de cluster.

Using the AWS Management Console

Procédez comme suit pour réinitialiser certaines ou toutes les valeurs de paramètres d'un groupe de paramètres de cluster à leurs valeurs par défaut.

Pour réinitialiser les valeurs de paramètres d'un groupe de paramètres de cluster

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

  2. Dans le panneau de navigation sur le côté gauche de la console, choisissez Groupes de paramètres.

  3. Dans le panneau Groupes de paramètres de cluster, choisissez le nom du groupe de paramètres de cluster que vous souhaitez réinitialiser.

  4. Choisissez Actions, puis Réinitialiser pour réinitialiser ce groupe de paramètres.

  5. Sur la page Cluster parameter group reset confirmation (Confirmation de réinitialisation du groupe de paramètres de cluster) qui s'affiche, confirmez que vous souhaitez réinitialiser tous les paramètres de cluster de ce groupe de paramètres à leurs valeurs par défaut. Choisissez ensuite Réinitialiser pour réinitialiser votre groupe de paramètres. Vous pouvez également choisir Annuler pour annuler vos modifications.

Using the AWS CLI

Pour réinitialiser certaines ou toutes les valeurs des paramètres d'un groupe de paramètres de cluster aux valeurs par défaut, utilisez l'opération reset-db-cluster-parameter-group avec les paramètres suivants.

  • --db-cluster-parameter-group-name — Obligatoire. Le nom du groupe de paramètres du cluster à réinitialiser.

  • --parameters— Facultatif. Une liste des ParameterName et de la ApplyMethod dans le groupe de paramètres de cluster à réinitialiser à leurs valeurs par défaut. Les paramètres statiques doit être définie sur pending-reboot pour entrer en vigueur lors du prochain redémarrage de l'instance ou de la demande reboot-db-instance. Vous devez appeler reboot-db-instance pour chaque instance de votre cluster à laquelle vous souhaitez que la mise à jour des paramètres statiques soit appliquée.

    Ce paramètre et --reset-all-parameters s'excluent mutuellement : vous pouvez utiliser l'un ou l'autre, mais pas les deux.

  • --reset-all-parametersou --no-reset-all-parameters — Facultatif. Spécifie s'il faut réinitialiser tous les paramètres (--reset-all-parameters) ou uniquement certains des paramètres (--no-reset-all-parameters) à leurs valeurs par défaut. Le paramètre --reset-all-parameters et --parameters s'excluent mutuellement : vous pouvez utiliser l'un ou l'autre, mais pas les deux.

    Lorsque vous réinitialisez l'ensemble du groupe, les paramètres dynamiques sont mis à jour immédiatement. Les paramètres statiques doivent être définis sur pending-reboot pour entrer en vigueur lors du redémarrage suivant de l'instance ou de la demande reboot-db-instance. Vous devez appeler reboot-db-instance pour chaque instance de votre cluster à laquelle vous souhaitez que la mise à jour des paramètres statiques soit appliquée.

Exemple 1 : Réinitialisation de tous les paramètres à leurs valeurs par défaut

Le code suivant réinitialise tous les paramètres dans le groupe de paramètres de cluster sample-parameter-group à leurs valeurs par défaut.

Pour Linux, macOS ou Unix :

aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --reset-all-parameters

Pour Windows :

aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --reset-all-parameters
Exemple 2 : Réinitialisation de paramètres spécifiés à leurs valeurs par défaut

Le code suivant réinitialise le paramètre tls dans le groupe de paramètres de cluster sample-parameter-group à sa valeur par défaut.

Pour Linux, macOS ou Unix :

aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --no-reset-all-parameters \
       --parameters ParameterName=tls,ApplyMethod=pending-reboot

Pour Windows :

aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --no-reset-all-parameters ^
       --parameters ParameterName=tls,ApplyMethod=pending-reboot

Le résultat de cette opération ressemble à ce qui suit (JSONformat).

{
       "DBClusterParameterGroupName": "sample-parameter-group"
   }
Redémarrage d'une instance de cluster

Avant qu'une valeur de paramètre statique soit modifiée, l'instance du cluster doit être redémarrée. Redémarrez chaque instance de votre cluster à laquelle vous souhaitez que la mise à jour du paramètre statique soit appliquée.

Pour Linux, macOS ou Unix :

aws docdb reboot-db-instance \
       --db-instance-identifier sample-cluster-instance

Pour Windows :

aws docdb reboot-db-instance ^
       --db-instance-identifier sample-cluster-instance