Restablecimiento de grupos de parámetros de clúster de Amazon DocumentDB

Puede restablecer algunos o todos los valores de los parámetros de un grupo de parámetros de clúster de Amazon DocumentDB a sus valores predeterminados utilizando el AWS Management Console o el AWS Command Line Interface (AWS CLI) para restablecer el grupo de parámetros de clúster.

Using the AWS Management Console

Siga estos pasos para restablecer algunos o todos los valores de parámetros de un grupo de parámetros de clúster a sus valores predeterminados.

Para restablecer los valores de parámetros de un grupo de parámetros de clúster

1. Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

2. En el panel de navegación del lado izquierdo de la consola, elija Parameter groups (Grupos de parámetros).

3. En el panel Cluster parameter groups (Grupos de parámetros del clúster), seleccione el nombre del grupo de parámetros de clúster que quiera reiniciar.

4. Elija Actions (Acciones), y, a continuación, elija Reset (Reiniciar) para restablecer ese grupo de parámetros.

5. En la página de confirmación de restablecimiento del grupo de parámetros del clúster resultante, confirme que desea restablecer todos los parámetros del clúster de ese grupo de parámetros a sus valores predeterminados. A continuación, seleccione Reset (Restablecer) para restablecer el grupo de parámetros. También puede seleccionar Cancel (Cancelar) para descartar los cambios.

Using the AWS CLI

Para restablecer algunos o todos los valores de parámetros de un grupo de parámetros de clúster a sus valores predeterminados, use la operación reset-db-cluster-parameter-group con los siguientes parámetros.

• --db-cluster-parameter-group-name: obligatorio. El nombre del grupo de parámetros de clúster que se va a restablecer.

• --parameters: opcional. Una lista de ParameterName y ApplyMethod del grupo de parámetros de clúster que se va a restablecer a sus valores predeterminados. Los parámetros estáticos se deben establecer en pending-reboot para que se apliquen la próxima vez que se reinicie la instancia o en la siguiente solicitud reboot-db-instance. Debe llamar a reboot-db-instance para cada instancia del clúster a la que desee aplicar el parámetro estático actualizado.

  Este parámetro y --reset-all-parameters se excluyen mutuamente: puede utilizar uno pero no ambos.

• --reset-all-parameters o --no-reset-all-parameters: opcional. Especifica si se deben restablecer todos los parámetros (--reset-all-parameters) o solo algunos de los parámetros (--no-reset-all-parameters) a sus valores predeterminados. El parámetro --reset-all-parameters y --parameters se excluyen mutuamente: puede utilizar uno pero no ambos.

  Cuando restablece todo el grupo, los parámetros dinámicos se actualizan inmediatamente. Los parámetros estáticos se establecen en pending-reboot para que se apliquen la próxima vez que se reinicie la instancia o en la siguiente solicitud reboot-db-instance. Debe llamar a reboot-db-instance para cada instancia del clúster a la que desee aplicar el parámetro estático actualizado.

Ejemplo 1: Restablecer todos los parámetros a sus valores predeterminados

El siguiente código restablece todos los parámetros del grupo de parámetros de clúster sample-parameter-group a sus valores predeterminados.

Para Linux, macOS o Unix:

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

Para Windows:

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

Ejemplo 2: Restablecer los parámetros especificados a sus valores predeterminados

El siguiente código restablece el parámetro tls del grupo de parámetros de clúster sample-parameter-group a su valor predeterminado.

Para Linux, macOS o 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

Para 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

La salida de esta operación será similar a lo que se indica a continuación (formato JSON).

{
       "DBClusterParameterGroupName": "sample-parameter-group"
   }

Reinicio de una instancia del clúster

Antes de que el valor de un parámetro estático cambie, la instancia del clúster debe reiniciarse. Reinicie cada instancia del clúster a la que desee aplicar el parámetro estático actualizado.

Para Linux, macOS o Unix:

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

Para Windows:

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