# Criar um grupo de parâmetros de cluster de banco de dados
<a name="USER_WorkingWithParamGroups.CreatingCluster"></a>

Você pode criar um novo grupo de parâmetros de cluster de banco de dados usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.

Depois de criar um grupo de parâmetros de cluster de banco de dados, você deve esperar pelo menos 5 minutos antes de criar seu primeiro cluster que usa esse grupo de parâmetros de cluster de banco de dados. Isso permite que o Amazon RDS conclua totalmente a criação do grupo de parâmetros antes que seja usado pelo novo cluster de banco de dados. É possível usar a página **Parameter Groups** (Grupos de parâmetros) do [console do Amazon RDS](https://console.aws.amazon.com/rds/) ou o comando [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) para verificar se o seu grupo de parâmetros de cluster de banco de dados foi criado.

As seguintes limitações se aplicam ao nome do grupo de parâmetros do cluster de banco de dados:
+ O nome deve ter de 1 a 255 letras, números ou hifens.

  Os nomes de grupos de parâmetros padrão podem incluir um ponto, como `default.mysql5.7`. No entanto, nomes de grupos de parâmetros personalizados não podem incluir um ponto.
+ O primeiro caractere deve ser uma letra.
+ O nome não pode terminar com hífen nem conter dois hífens consecutivos.

## Console
<a name="USER_WorkingWithParamGroups.CreatingCluster.CON"></a>

**Para criar um grupo de parâmetros de cluster de banco de dados**

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

1. No painel de navegação, escolha **Parameter groups** (Grupos de parâmetros).

1. Escolha **Criar grupo de parâmetros**.

1. Em **Nome do grupo de parâmetros**, insira o nome do novo grupo de parâmetros do cluster de banco de dados.

1. Em **Descrição**, insira uma descrição para o novo grupo de parâmetros do cluster de banco de dados.

1. Em **Tipo de mecanismo**, escolha o mecanismo de banco de dados.

1. Em **Família de grupos de parâmetros**, selecione uma família de grupos de parâmetros de banco de dados.

1. Escolha **Criar**.

## AWS CLI
<a name="USER_WorkingWithParamGroups.CreatingCluster.CLI"></a>

Para criar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html).

O exemplo a seguir cria um grupo de parâmetros de cluster de banco de dados chamado *mydbclusterparametergroup* para o RDS para MySQL versão 8.0 com a descrição "*My new parameter group*” (Meu novo grupo de parâmetros).

Inclua os seguintes parâmetros necessários:
+ `--db-cluster-parameter-group-name`
+ `--db-parameter-group-family`
+ `--description`

Para listar todas as famílias de grupos de parâmetros disponíveis, use o comando a seguir:

```
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
```

**nota**  
A saída contém duplicatas.

**Example**  
Para Linux, macOS ou Unix:  

```
aws rds create-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --db-parameter-group-family mysql8.0 \
    --description "My new cluster parameter group"
```
Para Windows:  

```
aws rds create-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --db-parameter-group-family mysql8.0 ^
    --description "My new cluster parameter group"
```
O comando gerará uma saída semelhante à seguinte:  

```
{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "mydbclusterparametergroup",
        "DBParameterGroupFamily": "mysql8.0",
        "Description": "My new cluster parameter group",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup2"
    }
}
```

## API do RDS
<a name="USER_WorkingWithParamGroups.CreatingCluster.API"></a>

Para criar um grupo de parâmetros de cluster de banco de dados, use a ação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html).

Inclua os seguintes parâmetros necessários:
+ `DBClusterParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`