Modificación de grupos de parámetros de clúster de Amazon DocumentDB

En esta sección se explica cómo modificar un grupo de parámetros personalizados de Amazon DocumentDB. En Amazon DocumentDB, no puede modificar un grupo de parámetros de clúster default que se crea al crear por primera vez un clúster con una nueva versión del motor en una nueva región. Si el clúster de Amazon DocumentDB utiliza el grupo de parámetros de clúster predeterminado y desea modificar un valor en él, primero debe crear un nuevo grupo de parámetros o copiar un grupo de parámetros existente, modificarlo y, a continuación, aplicar el grupo de parámetros modificado a su clúster.

Siga los pasos siguientes para modificar un grupo de parámetros de clúster. Las acciones de modificación pueden tardar un tiempo en propagarse. Espere a que el grupo de parámetros del clúster modificado esté disponible antes de adjuntarlo al clúster. Puede utilizar la AWS Management Console o la operación describe-db-cluster-parameters de la AWS CLI para verificar que el grupo de parámetros de clúster se haya creado. Para obtener más información, consulte Describir grupos de parámetros de clúster.

Using the AWS Management Console

Siga estos pasos para modificar un grupo de parámetros personalizado de Amazon DocumentDB. No puede modificar un grupo de parámetros default. Si desea modificar un valor del grupo de parámetros default, puede copiar el grupo de parámetros del clúster por defecto, modificarlo y, a continuación, aplicar el grupo de parámetros modificado al clúster. Para obtener más información sobre la aplicación de grupos de parámetros al clúster, consulte Modificación de un clúster de Amazon DocumentDB.

Para modificar un grupo de parámetros de clúster personalizado

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). En la lista de grupos de parámetros, seleccione el nombre del grupo de parámetros que desee modificar.

   sugerencia

   Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú () en la esquina superior izquierda de la página.

3. Para cada parámetro del grupo de parámetros que desee modificar, haga lo siguiente:

   1. Localice el parámetro que desea modificar y compruebe que es modificable comprobando si aparece en la true columna Modifiable (Modificable) .

   2. Si es modificable, seleccione el parámetro y elija Edit (Editar) en la parte superior derecha de la página de la consola.

   3. En el cuadro de diálogo Modify (Modificar) <parameter-name>, realice los cambios que desee. A continuación, elija Modify cluster parameter (Modificar el parámetro de clúster), o elija Cancel (Cancelar) para descartar los cambios.

Using the AWS CLI

Puede modificar los valores de ParameterValue, Description o ApplyMethod de cualquier parámetro modificable de un grupo de parámetros de clúster personalizado de Amazon DocumentDB mediante la AWS CLI. No se pueden realizar modificaciones directamente en un grupo de parámetros de clúster por defecto.

Para modificar los parámetros de un grupo de parámetros de clúster personalizado, utilice la operación modify-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 va a modificar.

• --parameters: obligatorio. Los parámetros que está modificando. Para obtener una lista de los parámetros que se aplican a todas las instancias de un clúster de Amazon DocumentDB, consulte Referencia de parámetros de clúster de Amazon DocumentDB. Cada entrada de parámetro debe incluir lo siguiente:

  • ParameterName: el nombre del grupo de parámetros de clúster que va a modificar.

  • ParameterValue: el valor nuevo de este parámetro de clúster.

  • ApplyMethod: cómo desea que se apliquen los cambios a este parámetro. Los valores permitidos son immediate y pending-reboot.

    nota

    Los parámetros con el ApplyType de static deben tener un ApplyMethod de pending-reboot.

ejemplo - Modificación del valor de un parámetro

En este ejemplo, se muestran los valores de parámetro de sample-parameter-group y se modifica el parámetro tls. A continuación, después de 5 minutos, también se muestran los valores de parámetro de sample-parameter-group para ver los valores de parámetro que han cambiado.

1. Muestre los parámetros de sample-parameter-group y sus valores.

   Para Linux, macOS o Unix:

   aws docdb describe-db-cluster-parameters \
          --db-cluster-parameter-group-name sample-parameter-group

   Para Windows:

   aws docdb describe-db-cluster-parameters ^
          --db-cluster-parameter-group-name sample-parameter-group

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

   {
          "Parameters": [
              {
                  "Source": "system",
                  "ApplyType": "static",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "tls",
                  "IsModifiable": true,
                  "Description": "Config to enable/disable TLS"
              },
              {
                  "Source": "user",
                  "ApplyType": "dynamic",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "ttl_monitor",
                  "IsModifiable": true,
                  "Description": "Enables TTL Monitoring"
              }
          ]
   }

2. Modifique el parámetro tls para que su valor sea disabled.

   No se puede modificar ApplyMethod ya que ApplyType es static.

   Para Linux, macOS o Unix:

   aws docdb modify-db-cluster-parameter-group \
          --db-cluster-parameter-group-name sample-parameter-group \
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot

   Para Windows:

   aws docdb modify-db-cluster-parameter-group ^
          --db-cluster-parameter-group-name sample-parameter-group ^
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"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"
      }

3. Espere al menos 5 minutos.

4. Enumere los valores de parámetro de sample-parameter-group para verificar que se modificó el parámetro de tls.

   Para Linux, macOS o Unix:

   aws docdb describe-db-cluster-parameters \
          --db-cluster-parameter-group-name sample-parameter-group

   Para Windows:

   aws docdb describe-db-cluster-parameters ^
          --db-cluster-parameter-group-name sample-parameter-group

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

   {
          "Parameters": [
              {
                  "ParameterValue": "false",
                  "ParameterName": "enable_audit_logs",
                  "ApplyType": "dynamic",
                  "DataType": "string",
                  "Description": "Enables auditing on cluster.",
                  "AllowedValues": "true,false",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              },
              {
                  "ParameterValue": "disabled",
                  "ParameterName": "tls",
                  "ApplyType": "static",
                  "DataType": "string",
                  "Description": "Config to enable/disable TLS",
                  "AllowedValues": "disabled,enabled",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              }
          ]
   }