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 parámetros de clúster de Amazon DocumentDB
En Amazon DocumentDB, *los grupos de parámetros de clúster* constan de *parámetros* que se aplican a todas las instancias que cree en el clúster. En los grupos de parámetros de clúster personalizados, puede modificar un valor de parámetro en cualquier momento o restablecer todos los valores de parámetro a sus valores predeterminados para los grupos de parámetros que cree. En esta sección se describe cómo ver los parámetros que conforman un grupo de parámetros de clúster de Amazon DocumentDB y sus valores, y cómo cambiar o actualizar estos valores.
Los parámetros pueden ser *dinámicos* o *estáticos*. Cuando se modifica un parámetro dinámico y se guarda el grupo de parámetros de clúster, el cambio se aplica inmediatamente, sea cual sea el estado de `Apply Immediately`. Cuando se cambia un parámetro estático y se guarda el grupo de parámetros de clúster, el cambio de parámetros solo tiene efecto después de reiniciar manualmente la instancia.
## Visualización de los parámetros de un grupo de parámetros de clúster de Amazon DocumentDB
Para ver los parámetros y valores de un clúster de Amazon DocumentDB, utilice o. Consola de administración de AWS AWS CLI
------
#### [ Using the Consola de administración de AWS ]
**Visualización de los detalles de un grupo de parámetros de clúster**
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, seleccione **Grupos de parámetros**.
**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. En el panel **Parameter groups (Grupos de parámetros)**, seleccione el nombre del grupo de parámetros de clúster cuyos detalles desee ver.
1. La página resultante muestra los siguientes valores para cada parámetro: el nombre del parámetro, el valor actual, los valores permitidos, si el parámetro es modificable, el tipo de aplicación, el tipo de datos y la descripción.
![\[Captura de pantalla: Nombres y valores de parámetros.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png)
------
#### [ Using the AWS CLI ]
Para ver los parámetros de un grupo de parámetros de un clúster y sus valores, utilice la operación `describe-db-cluster-parameters` con los siguientes parámetros.
+ **--db-cluster-parameter-group-name**: obligatorio. El nombre del grupo de parámetros de clúster para el que desea obtener una lista detallada de parámetros.
+ **--source**: opcional. Si se especifica, devuelve solo los parámetros de un origen específico. Los orígenes de parámetros pueden ser `engine-default`, `system` o `user`.
**Example**
El siguiente código de ejemplo muestra los parámetros, junto con sus valores, del grupo de parámetros `custom3-6-param-grp`. Para obtener más información sobre el grupo de parámetros, omita la línea `--query`. Para obtener más información sobre todos los grupos de parámetros, omita la línea `--db-cluster-parameter-group-name`.
Para Linux, macOS o Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name custom3-6-param-grp \
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
Para Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name custom3-6-param-grp ^
--query 'Parameters[*].[ParameterName,ParameterValue]'
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
[
[
"audit_logs",
"disabled"
],
[
"tls",
"enabled"
],
[
"ttl_monitor",
"enabled"
]
]
```
------
## Modificación de los parámetros de un grupo de parámetros de clúster de Amazon DocumentDB
Puede modificar los parámetros de un grupo de parámetros con las teclas o. Consola de administración de AWS AWS CLI
------
#### [ Using the Consola de administración de AWS ]
**Actualización de los parámetros de un grupo de parámetros de clúster**
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, seleccione **Grupos de parámetros**.
**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. En el panel **Parameter groups (Grupos de parámetros)**, elija el grupo de parámetros del clúster cuyos parámetros desea actualizar.
1. La página resultante muestra los parámetros y sus detalles correspondientes para este grupo de parámetros de clúster. Seleccione un parámetro para actualizar.
1. En la parte superior derecha de la página, elija **Edit (Editar)** para cambiar el valor del parámetro. Para obtener más información sobre los tipos de parámetros de clúster, consulte [Referencia de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md).
1. Realice el cambio y, a continuación, elija **Modify cluster parameter (Modificar parámetro de clúster)** para guardar los cambios. Para descartar los cambios, selecciona **Cancel (Cancelar)**.
------
#### [ Using the AWS CLI ]
Para modificar los parámetros de un grupo de parámetros de clúster, 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. El parámetro o los parámetros que va a modificar. 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`.
**Para cambiar los valores de los parámetros de un grupo de parámetros de clúster (AWS CLI)**
En el siguiente ejemplo se cambia el nombre del parámetro `tls`.
1. **Muestre los parámetros y sus valores de `sample-parameter-group`**
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. **Muestre los valores de parámetro de `sample-parameter-group`.**
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": [
{
"ParameterName": "audit_logs",
"ParameterValue": "disabled",
"Description": "Enables auditing on cluster.",
"Source": "system",
"ApplyType": "dynamic",
"DataType": "string",
"AllowedValues": "enabled,disabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterName": "tls",
"ParameterValue": "disabled",
"Description": "Config to enable/disable TLS",
"Source": "user",
"ApplyType": "static",
"DataType": "string",
"AllowedValues": "disabled,enabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------