# Associar um grupo de parâmetros de cluster de banco de dados a um cluster de banco de dados no Amazon Aurora
<a name="USER_WorkingWithParamGroups.AssociatingCluster"></a>

Você pode criar seus próprios grupos de parâmetros de cluster de banco de dados com configurações personalizadas. Você pode associar um grupo de parâmetros de cluster de banco de dados a um cluster de banco de dados usando o Console de gerenciamento da AWS ou a API RDSAWS CLI. Você pode fazer isso ao criar ou modificar um cluster de banco de dados.

Para obter informações sobre como criar um grupo de parâmetros de cluster de banco de dados, consulte [Criar um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora](USER_WorkingWithParamGroups.CreatingCluster.md). Para obter informações sobre como criar um cluster de banco de dados, consulte [Criar um cluster de bancos de dados do Amazon Aurora](Aurora.CreateInstance.md). Para obter informações sobre como modificar um cluster de banco de dados, consulte [Modificar um cluster de bancos de dados Amazon Aurora](Aurora.Modifying.md).

**nota**  
Para o Aurora PostgreSQL 15.2, 14.7, 13.10, 12.14 e todas as versões 11, ao alterar o grupo de parâmetros de cluster de banco de dados associado a um cluster de banco de dados, reinicialize cada instância de réplica para aplicar as alterações.  
Para determinar se a instância de banco de dados principal de um cluster de banco de dados deve ser reinicializada para aplicar alterações, execute o seguinte comando AWS CLI:  
`aws rds describe-db-clusters --db-cluster-identifier db_cluster_identifier`  
Verifique o valor `DBClusterParameterGroupStatus` da instância do banco de dados primário na saída. Se o valor for `pending-reboot`, reinicie a instância de banco de dados principal do cluster de banco de dados.

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

**Para associar um grupo de parâmetros de cluster de banco de dados a um 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 **Databases (Bancos de dados)** e escolha o cluster de banco de dados que você deseja modificar. 

1. Escolha **Modify** (Modificar). A página **Modify DB cluster (Modificar cluster de banco de dados)** é exibida.

1. Altere a configuração do **grupo de parâmetros do cluster de banco de dados**. 

1. Escolha **Continue** (Continuar) e verifique o resumo de modificações. 

   A alteração é aplicada imediatamente, independentemente da configuração **Agendamento de modificações**.

1. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha **Modify cluster (Modificar cluster)** para salvar as alterações. 

   Como alternativa, escolha **Back (Voltar)** para editar suas alterações ou escolha **Cancel (Cancelar)** para cancelar as alterações. 

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

Para associar um grupo de parâmetros de cluster de banco de dados a um cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) com as seguintes opções:
+ `--db-cluster-name`
+ `--db-cluster-parameter-group-name`

O exemplo a seguir associa o `mydbclpg` grupo de parâmetros de banco de dados ao cluster de banco de dados`mydbcluster`.

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

```
aws rds modify-db-cluster \
    --db-cluster-identifier mydbcluster \
    --db-cluster-parameter-group-name mydbclpg
```
Para Windows:  

```
aws rds modify-db-cluster ^
    --db-cluster-identifier mydbcluster ^
    --db-cluster-parameter-group-name mydbclpg
```

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

Para associar um grupo de parâmetros de cluster de banco de dados a um cluster de banco de dados, use a operação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) com os seguintes parâmetros:
+ `DBClusterIdentifier`
+ `DBClusterParameterGroupName`