As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criando grupos de parâmetros de cluster do Amazon DocumentDB
<a name="cluster_parameter_groups-create"></a>

Grupos de parâmetros de cluster padrão, como `default.docdb5.0`, `default.docdb4.0`, ou `default.docdb3.6`, são criados quando você cria um cluster com uma nova versão do mecanismo em uma nova região. Os clusters subsequentes criados nessa região com a mesma versão do mecanismo herdam o grupo de parâmetros do cluster `default`. Depois de criados, os grupos de parâmetros `default` não podem ser excluídos nem renomeados. É possível modificar o comportamento do mecanismo das instâncias de cluster criando um grupo de parâmetros personalizado com valores de parâmetros preferenciais e anexando-o ao seu cluster do Amazon DocumentDB. 

O procedimento a seguir orienta na criação de um grupo de parâmetros de cluster personalizado com base na família. Depois disso, é possível [modificar os parâmetros desse grupo de parâmetros](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html).

**nota**  
Depois de modificar um grupo de parâmetros de cluster, é necessário esperar pelo menos 5 minutos antes de usar esse grupo de parâmetros em particular. Isso permite que o Amazon DocumentDB conclua a ação `create` integralmente antes que o grupo de parâmetros de cluster seja usado para um novo cluster. Você pode usar a `describe-db-cluster-parameter-groups` AWS CLI operação Console de gerenciamento da AWS ou a para verificar se o grupo de parâmetros do cluster foi criado. Para obter mais informações, consulte [Descrever os grupos de parâmetros de cluster do Amazon DocumentDB](cluster_parameter_groups-describe.md).

------
#### [ Using the Console de gerenciamento da AWS ]

**Para criar um grupos de parâmetros de cluster**

1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)

1. No painel de navegação, escolha **Grupos de parâmetros**. 
**dica**  
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.

1. No painel **Grupos de parâmetros de cluster**, escolha **Criar**.

1. No painel **Criar grupo de parâmetros do cluster** insira o seguinte:

   1. **Nome do grupo de parâmetros do novo cluster**: insira um nome para o grupo de parâmetros do cluster. Por exemplo, .`sample-parameter-group` Os grupos de parâmetros de cluster têm as seguintes restrições de nomenclatura:
      + O tamanho é de [1–255] caracteres alfanuméricos.
      + O primeiro caractere deve ser uma letra.
      + Não pode terminar com um hífen ou conter dois hifens consecutivos.

   1. **Família**: escolha uma versão do DocumentDB que você pretende usar para seu cluster.

   1. **Descrição** — fornece uma descrição para este grupo de parâmetros de cluster.

1. Para criar o grupo de parâmetro de cluster, escolha **Criar**. Para cancelar a operação, escolha **Cancelar**.

1. Depois de escolher **Criar**, o texto a seguir será exibido na parte superior da página, para verificar se o grupo de parâmetros de cluster foi criado com êxito:

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

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

Para criar um novo grupo de parâmetros de cluster para clusters do Amazon DocumentDB 4.0, use a AWS CLI `create-db-cluster-parameter-group` operação com os seguintes parâmetros:
+ **--db-cluster-parameter-group-name** — o nome do grupo de parâmetros de cluster personalizado. Por exemplo, .`sample-parameter-group`
+ **--db-cluster-parameter-group-family** — a família do grupo de parâmetros de cluster usada como modelo para o grupo de parâmetros de cluster personalizado.
+ **--description** — a descrição fornecida pelo usuário para esse grupo de parâmetros de cluster. O exemplo a seguir usa "`Custom docdb4.0 parameter group`".

Para Linux, macOS ou 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"
```
A saída dessa operação é semelhante ao seguinte (formato JSON).  

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

------