

# Trabalhar com grupos de parâmetros de clusters de banco de dados multi-AZ
<a name="USER_WorkingWithDBClusterParamGroups"></a>

Clusters de banco de dados multi-AZ usam grupos de parâmetros de cluster de banco de dados As seções a seguir descrevem a configuração e o gerenciamento de grupos de parâmetros de cluster de banco de dados.

**Topics**
+ [Criar um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.CreatingCluster.md)
+ [Modificar parâmetros em um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ModifyingCluster.md)
+ [Redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ResettingCluster.md)
+ [Copiar um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.CopyingCluster.md)
+ [Listar grupos de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ListingCluster.md)
+ [Visualizar valores de parâmetros de um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ViewingCluster.md)
+ [Excluir um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.DeletingCluster.md)

# 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`

# Modificar parâmetros em um grupo de parâmetros de cluster de banco de dados
<a name="USER_WorkingWithParamGroups.ModifyingCluster"></a>

É possível modificar valores de parâmetros em um grupo de parâmetros do cluster de banco de dados criado pelo cliente. Não é possível alterar os valores de parâmetros em um grupo de parâmetros do cluster de banco de dados padrão. As alterações dos parâmetros em um grupo de parâmetros de cluster de banco de dados criado pelo cliente são aplicadas a todos os clusters de bancos de dados que estão associados a esse grupo de parâmetros de cluster de banco de dados.

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

**Para modificar 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, selecione **Parameter groups**.

1. Na lista, escolha o grupo de parâmetros que você deseja modificar.

1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.

1. Altere os valores dos parâmetros que você deseja modificar. Você pode percorrer os parâmetros usando as teclas de seta no canto superior direito da caixa de diálogo. 

   Não altere valores em um grupo de parâmetros padrão.

1. Selecione **Save changes**.

1. Reinicialize a cluster para aplicar as alterações a ela.

   Se você não o cluster, uma operação de failover poderá levar mais tempo do que o normal.

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

Para modificar 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/modify-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html) com os seguintes parâmetros obrigatórios:
+ `--db-cluster-parameter-group-name`
+ `--parameters`

O exemplo a seguir modifica os valores `server_audit_logging` e `server_audit_logs_upload` no grupo de parâmetros de cluster de banco de dados chamado *mydbclusterparametergroup*.

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

```
aws rds modify-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
```
Para Windows:  

```
aws rds modify-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
```
O comando produz uma saída como a seguinte:  

```
DBCLUSTERPARAMETERGROUP  mydbclusterparametergroup
```

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

Para modificar um grupo de parâmetros de cluster de banco de dados, use o comando da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html) com os seguintes parâmetros obrigatórios:
+ `DBClusterParameterGroupName`
+ `Parameters`

# Redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados
<a name="USER_WorkingWithParamGroups.ResettingCluster"></a>

Você pode redefinir parâmetros para seus valores padrão em um grupo de parâmetro de cluster de banco de dados criado pelo cliente. As alterações dos parâmetros em um grupo de parâmetros de cluster de banco de dados criado pelo cliente são aplicadas a todos os clusters de bancos de dados que estão associados a esse grupo de parâmetros de cluster de banco de dados.

**nota**  
Em um grupo de parâmetro de cluster de banco de dados padrão, os parâmetros são sempre definidos como seus valores padrão.

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

**Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão**

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, selecione **Parameter groups**.

1. Na lista, escolha o grupo de parâmetros.

1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.

1. Escolha os parâmetros que você deseja redefinir para os valores padrão. Você pode percorrer os parâmetros usando as teclas de seta no canto superior direito da caixa de diálogo. 

   Não redefina os valores em um grupo de parâmetros padrão.

1. Escolha **Reset (Redefinir)** e, em seguida, confirme escolhendo **Reset parameters (Redefinir parâmetros)**.

1. Reinicialize a cluster do banco de dados.

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

Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html) com a seguinte opção obrigatória: `--db-cluster-parameter-group-name`.

Para redefinir todos os parâmetros no grupo de parâmetro do cluster de banco de dados, especifique a opção `--reset-all-parameters`. Para redefinir parâmetros específicos, especifique a opção `--parameters`.

O exemplo a seguir redefine todos os parâmetros no grupo de parâmetros de banco de dados chamado *mydbparametergroup* para seus valores padrão.

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

```
aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbparametergroup \
    --reset-all-parameters
```
Para Windows:  

```
aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbparametergroup ^
    --reset-all-parameters
```

O exemplo a seguir redefine os valores padrão `server_audit_logging` e `server_audit_logs_upload` no grupo de parâmetro de cluster de banco de dados chamado *mydbclusterparametergroup*.

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

```
aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ApplyMethod=immediate"
```
Para Windows:  

```
aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
```
O comando produz uma saída como a seguinte:  

```
DBClusterParameterGroupName  mydbclusterparametergroup
```

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

Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão, use o comando da API do RDS de [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html) com o seguinte parâmetro necessário: `DBClusterParameterGroupName`.

Para redefinir todos os parâmetros no grupo de parâmetros do cluster de banco de dados, defina o parâmetro `ResetAllParameters` para `true`. Para redefinir parâmetros específicos, especifique o parâmetro `Parameters`.

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

Você pode copiar os grupos de parâmetros de cluster de banco de dados personalizados que criou. Copiar um grupo de parâmetros é uma solução conveniente quando você já criou um grupo de parâmetros de cluster de banco de dados e deseja incluir a maioria dos parâmetros e valores personalizados desse grupo em um novo grupo de parâmetros de cluster de banco de dados. É possível copiar um grupo de parâmetros de cluster de banco de dados usando o comando AWS CLI [copy-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) ou a operação da API do RDS [CopyDBClusterParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html).

Depois de copiar 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 cópia 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.

**nota**  
Não é possível copiar um grupo de parâmetros padrão. No entanto, é possível criar um grupo de parâmetros com base em um grupo de parâmetros padrão.  
Não é possível copiar um grupo de parâmetros de cluster de banco de dados para uma Conta da AWS ou Região da AWS diferente.

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

**Para copiar 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, selecione **Parameter groups**.

1. Na lista, escolha o grupo de parâmetros personalizado que você deseja copiar.

1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Copy (Copiar)**.

1. Em **New DB parameter group identifier (Novo identificador do grupo de parâmetros do banco de dados)**, digite um nome para o novo grupo de parâmetros.

1. Em **Description (Descrição)**, digite uma descrição para o novo grupo de parâmetros.

1. Escolha **Copiar**.

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

Para copiar 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/copy-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) com os seguintes parâmetros obrigatórios:
+ `--source-db-cluster-parameter-group-identifier`
+ `--target-db-cluster-parameter-group-identifier`
+ `--target-db-cluster-parameter-group-description`

O exemplo a seguir cria um novo grupo de parâmetros de cluster de banco de dados chamado `mygroup2` que é uma cópia do grupo de parâmetros de cluster de banco de dados `mygroup1`.

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

```
aws rds copy-db-cluster-parameter-group \
    --source-db-cluster-parameter-group-identifier mygroup1 \
    --target-db-cluster-parameter-group-identifier mygroup2 \
    --target-db-cluster-parameter-group-description "DB parameter group 2"
```
Para Windows:  

```
aws rds copy-db-cluster-parameter-group ^
    --source-db-cluster-parameter-group-identifier mygroup1 ^
    --target-db-cluster-parameter-group-identifier mygroup2 ^
    --target-db-cluster-parameter-group-description "DB parameter group 2"
```

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

Para copiar um grupo de parâmetros de cluster de banco de dados, use a operação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html) com os seguintes parâmetros obrigatórios:
+ `SourceDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupDescription`

# Listar grupos de parâmetros de cluster de banco de dados
<a name="USER_WorkingWithParamGroups.ListingCluster"></a>

Você pode listar os grupos de parâmetros do cluster de banco de dados que criou para sua conta da AWS.

**nota**  
Grupos de parâmetros padrão são criados automaticamente a partir de um modelo de parâmetro padrão quando você cria um cluster de banco de dados para um mecanismo e uma versão de banco de dados específicos. Esses grupos de parâmetros padrão contêm configurações de parâmetros preferenciais e não podem ser modificados. Quando você cria um grupo de parâmetros personalizado, pode modificar as configurações desses parâmetros. 

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

**Para listar todos os grupos de parâmetros do cluster de banco de dados para uma conta da AWS**

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, selecione **Parameter groups**.

   Os parameter groups de cluster de banco de dados são exibidos na lista com **DB cluster parameter group (Parameter group de cluster de banco de dados)** para o **Type (Tipo)**.

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

Para listar todos os grupos de parâmetros de cluster de banco de dados de uma conta da AWS, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html).

**Example**  
O exemplo a seguir lista todos os grupos de parâmetros de cluster de banco de dados de uma conta da AWS.  

```
aws rds describe-db-cluster-parameter-groups
```
O exemplo a seguir descreve o grupo de parâmetros *mydbclusterparametergroup*.  
Para Linux, macOS ou Unix:  

```
aws rds describe-db-cluster-parameter-groups \
    --db-cluster-parameter-group-name mydbclusterparametergroup
```
Para Windows:  

```
aws rds describe-db-cluster-parameter-groups ^
    --db-cluster-parameter-group-name mydbclusterparametergroup
```
O comando retorna uma resposta como a seguinte:  

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

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

Para listar todos os grupos de parâmetros de cluster de banco de dados de uma conta da AWS, use a ação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html).

# Visualizar valores de parâmetros de um grupo de parâmetros de cluster de banco de dados
<a name="USER_WorkingWithParamGroups.ViewingCluster"></a>

Você pode obter uma lista de todos os parâmetros em um grupo de parâmetros de cluster de banco de dados e seus valores.

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

**Para visualizar os valores de parâmetros para 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, selecione **Parameter groups**.

   Os grupos de parâmetros de cluster de banco de dados são exibidos na lista com **DB cluster parameter group (Grupo de parâmetros de cluster de banco de dados)** para o **Type (Tipo)**.

1. Escolha o nome do grupo de parâmetros de cluster de banco de dados para ver sua lista de parâmetros.

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

Para visualizar os valores de parâmetros para 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/describe-db-cluster-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) com o parâmetro obrigatório a seguir.
+ `--db-cluster-parameter-group-name`

**Example**  
O exemplo a seguir lista os parâmetros e os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados chamado *mydbclusterparametergroup*, no formato JSON.  
O comando retorna uma resposta como a seguinte:  

```
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup
```

```
{
    "Parameters": [
        {
            "ParameterName": "activate_all_roles_on_login",
            "ParameterValue": "0",
            "Description": "Automatically set all granted roles as active after the user has authenticated successfully.",
            "Source": "engine-default",
            "ApplyType": "dynamic",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
        {
            "ParameterName": "allow-suspicious-udfs",
            "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": false,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
...
```

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

Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) da API do RDS com o seguinte parâmetro necessário.
+ `DBClusterParameterGroupName`

Em alguns casos, os valores permitidos para um parâmetro não são mostrados. São sempre parâmetros em que a origem é o padrão do mecanismo de banco de dados.

Para visualizar os valores desses parâmetros, você pode executar as seguintes instruções SQL:
+ MySQL:

  ```
  -- Show the value of a particular parameter
  mysql$ SHOW VARIABLES LIKE '%parameter_name%';
  
  -- Show the values of all parameters
  mysql$ SHOW VARIABLES;
  ```
+ PostgreSQL:

  ```
  -- Show the value of a particular parameter
  postgresql=> SHOW parameter_name;
  
  -- Show the values of all parameters
  postgresql=> SHOW ALL;
  ```

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

É possível excluir um 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. Um grupo de parâmetros do cluster de banco de dados será elegível para exclusão somente se não estiver associado a um cluster de banco de dados.

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

**Para excluir um grupo de parâmetros**

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).

   Os grupos de parâmetros aparecem em uma lista.

1. Escolha o nome dos grupos de parâmetros do cluster de banco de dados a serem excluídos.

1. Escolha **Ações** e então **Excluir**.

1. Revise os nomes dos grupos de parâmetros e escolha **Excluir**.

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

Para excluir um grupo de parâmetros de cluster de banco de dados, use o comando [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html) da AWS CLI com os parâmetros obrigatórios a seguir.
+ `--db-parameter-group-name`

**Example**  
O exemplo a seguir exclui um grupo de parâmetros do cluster de banco de dados chamado *mydbparametergroup*.  

```
aws rds delete-db-cluster-parameter-group --db-parameter-group-name mydbparametergroup
```

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

Para excluir um grupo de parâmetros de cluster de banco de dados, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html) da API do RDS com os parâmetros obrigatórios a seguir.
+ `DBParameterGroupName`