Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# 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](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) o [copiar un grupo de parámetros existente](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), 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 de clúster modificado esté disponible antes de adjuntarlo al clúster. Puede utilizar la AWS CLI `describe-db-cluster-parameters` operación Consola de administración de AWS o para comprobar que el grupo de parámetros del clúster se ha modificado. Para obtener más información, consulte [Descripción de los grupos de parámetros de clúster](cluster_parameter_groups-describe.md).
------
#### [ Using the Consola de administración de AWS ]
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](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), 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](db-cluster-modify.md).
**Modificación de un grupo de parámetros de clúster personalizado**
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. 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ú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.
1. 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)** .
1. Si es modificable, seleccione el parámetro y elija **Edit (Editar)** en la parte superior derecha de la página de la consola.
1. En el cuadro de diálogo **Modify (Modificar) ``**, 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](cluster_parameter_groups-list_of_parameters.md). 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`.
**Example - 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"
}
]
}
```
1. 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"
}
```
1. Espere al menos 5 minutos.
1. 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"
}
]
}
```
------