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

# Modificando clusters do Amazon DocumentDB para usar grupos de parâmetros de cluster personalizados
<a name="cluster_parameter_groups-modify_clusters"></a>

Ao criar um cluster do Amazon DocumentDB, um grupo de parâmetros `default.docdb4.0` é criado automaticamente para esse cluster. Não é possível modificar o grupo de parâmetros de cluster `default`. Em vez disso, é possível modificar seu cluster do Amazon DocumentDB para associar um novo grupo de parâmetros personalizado a ele. 

Esta seção explica como modificar um cluster Amazon DocumentDB existente para usar um grupo de parâmetros de cluster personalizado usando o Console de gerenciamento da AWS e o AWS Command Line Interface ()AWS CLI. 

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

**Como modificar um cluster do Amazon DocumentDB para usar um novo grupo de parâmetros de cluster não padrão**

1. Antes de começar, lembre-se de criar um cluster do Amazon DocumentDB e um grupo de parâmetros de cluster. Consulte [Criar um cluster do Amazon DocumentDB](db-cluster-create.md) e [Criando grupos de parâmetros de cluster do Amazon DocumentDB](cluster_parameter_groups-create.md) para obter mais instruções.

1. Depois de criar o grupo de parâmetros de cluster, abra o console do Amazon DocumentDB em [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). No painel de navegação, escolha **Clusters** para adicionar o novo grupo de parâmetros a um cluster.

1. Escolha o cluster que deseja associar ao seu grupo de parâmetros. Escolha **Ações** e **Modificar** para modificar seu cluster.

1. Em **Opções de cluster**, escolha o novo grupo de parâmetros ao qual deseja associar o cluster.

1. Escolha **Continuar** para exibir um resumo das modificações.

1. Depois de verificar suas alterações, é possível aplicá-las imediatamente, ou durante a próxima janela de manutenção em **Programação de modificações**.

1. Escolha **Modificar cluster** para atualizar seu cluster com o novo grupo de parâmetros.

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

Antes de começar, lembre-se de criar um cluster do Amazon DocumentDB e um grupo de parâmetros de cluster. Você pode [criar um cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html) usando a AWS CLI `create-db-cluster` operação. Você pode [criar um grupo de parâmetros de cluster](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) usando a AWS CLI `create-db-cluster-parameter-group` operação.

Para adicionar seu novo grupo de parâmetros de cluster ao seu cluster, use a AWS CLI `modify-db-cluster` operação com os parâmetros a seguir.
+ **-- db-cluster-identifier** — O nome do seu cluster (por exemplo,`sample-cluster`).
+ **-- db-cluster-parameter-group -name** — O nome do grupo de parâmetros ao qual você deseja associar seu cluster (por exemplo,`sample-parameter-group`).

**Example**  

```
aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --db-cluster-parameter-group-name sample-parameter-group
```
A saída dessa operação é semelhante ao seguinte (formato JSON).  

```
"DBCluster": {
    "AvailabilityZones": [
            "us-west-2c",
            "us-west-2b",
            "us-west-2a"
    ],
    "BackupRetentionPeriod": 1,
    "DBClusterIdentifier": "sample-cluster",
    "DBClusterParameterGroup": "sample-parameter-group",
    "DBSubnetGroup": "default",
   ...
}
```

------