

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.

# Creación de grupos de parámetros de clúster de Amazon DocumentDB
<a name="cluster_parameter_groups-create"></a>

Los grupos de parámetros de clúster predeterminados `default.docdb5.0``default.docdb4.0`, como, o`default.docdb3.6`,, se crean al crear un clúster con una nueva versión del motor y en una nueva Región de AWS. Los clústeres posteriores creados en la misma región y con la misma versión de motor heredan el grupo de parámetros del `default` clúster. Una vez creados, los grupos de parámetros `default` no se pueden eliminar ni cambiar de nombre. Puede modificar el comportamiento del motor de las instancias de clúster creando un grupo de parámetros personalizado con los valores de parámetros preferidos y adjuntándolo a su clúster de Amazon DocumentDB. 

El siguiente procedimiento le guía a través de la creación de un grupo de parámetros de clúster personalizado. A continuación, puede [modificar los parámetros dentro de ese grupo de parámetros](cluster_parameter_groups-modify.md).

**nota**  
Después de crear un grupo de parámetros de clúster, debe esperar al menos 5 minutos antes de usar ese grupo de parámetros en concreto. Esto permite a `create` finalizar por completo la acción Amazon DocumentDB antes de que el grupo de parámetros de clúster se use para un nuevo clúster. Puede utilizar la operación Consola de administración de AWS o la `describe-db-cluster-parameter-groups` AWS CLI operación para comprobar que se ha creado el grupo de parámetros del clúster. Para obtener más información, consulte [Descripción de los grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-describe.md).

------
#### [ Using the Consola de administración de AWS ]

**Creación 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ú (![Menu button.](https://docs.aws.amazon.com/es_es/documentdb/latest/devguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.

1. En el panel **Cluster parameter groups (Grupos de parámetros del clúster)**, elija **Create (Crear)**.

1. En el panel **Create cluster parameter group (Crear grupo de parámetros de clúster)** escriba lo siguiente:

   1. **Nombre del nuevo grupo de parámetros de clúster**: escriba un nombre para el grupo de parámetros de clúster. Por ejemplo, `sample-parameter-group`. Los grupos de parámetros de clúster tienen las siguientes restricciones de denominación:
      + La longitud es de [1-255] caracteres alfanuméricos.
      + El primer carácter debe ser una letra.
      + No puede terminar con un guion ni contener dos guiones consecutivos.

   1. **Familia**: elija la versión de DocumentDB que desee usar para su clúster.

   1. **Descripción**: proporcione una descripción para este grupo de parámetros de clúster.

1. Para crear el grupo de parámetros de clúster, elija **Create (Crear)**. Para cancelar la operación, elija **Cancel (Cancelar)**.

1. Después de seleccionar **Create (Crear)**, aparece el siguiente texto en la parte superior de la página para comprobar que el grupo de parámetros de clúster se ha creado correctamente:

   ```
   Successfully created cluster parameter group '{{sample-parameter-group}}'.
   ```

------
#### [ Using the AWS CLI ]

Para crear un nuevo grupo de parámetros de clústeres para los clústeres de Amazon DocumentDB 4.0, utilice la AWS CLI `create-db-cluster-parameter-group` operación con los siguientes parámetros:
+ **--db-cluster-parameter-group-name**: el nombre del grupo de parámetros de clúster de base de datos. Por ejemplo, `sample-parameter-group`.
+ **--db-cluster-parameter-group-family**: la familia de grupos de parámetros de clúster que se utiliza como plantilla para el grupo de parámetros de clúster personalizado.
+ **--description**: la descripción proporcionada por el usuario para este grupo de parámetros de clúster. El siguiente ejemplo utiliza “`Custom docdb4.0 parameter group`”.

Para Linux, macOS o Unix:

**Example**  

```
aws docdb create-db-cluster-parameter-group \
 --db-cluster-parameter-group-name {{sample-parameter-group}} \
 --db-parameter-group-family docdb5.0 \
 --description "{{Custom docdb5.0 parameter group}}"
```
Para Windows:  

```
aws docdb create-db-cluster-parameter-group ^
 --db-cluster-parameter-group-name {{sample-parameter-group}} ^
 --db-parameter-group-family docdb5.0 ^
 --description "{{Custom docdb5.0 parameter group}}"
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).  

```
{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "{{sample-parameter-group}}",
        "DBParameterGroupFamily": "docdb5.0",
        "Description": "{{Custom docdb4.0 parameter group}}",
        "DBClusterParameterGroupArn": "{{sample-parameter-group-arn}}"
    }
}
```

------