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 grupos de parâmetros de cluster do Amazon DocumentDB
Esta seção explica como modificar um grupo de parâmetros *personalizado* do Amazon DocumentDB. No Amazon DocumentDB, você não pode modificar um grupo de parâmetros de cluster `default` ao criar pela primeira vez um cluster com a nova versão do mecanismo em uma nova região. Se o cluster do Amazon DocumentDB estiver usando o grupo de parâmetros de cluster padrão e você desejar modificar um valor, primeiro será necessário [criar um novo grupo de parâmetros](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html), ou [copiar um grupo de parâmetros existente](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), para então modificá-lo e, em seguida, aplicar o grupo de parâmetros modificado ao seu cluster.
Conclua as etapas a seguir para modificar um grupo personalizado de parâmetros de cluster. As ações de modificação podem demorar um pouco para se propagar. Aguarde até que o grupo de parâmetros de cluster modificado esteja disponível antes de anexá-lo ao seu cluster. Você pode usar a AWS CLI `describe-db-cluster-parameters` operação Console de gerenciamento da AWS ou a para verificar se o grupo de parâmetros do cluster foi modificado. Para obter mais informações, consulte [Descrevendo grupos de parâmetros de cluster](cluster_parameter_groups-describe.md).
------
#### [ Using the Console de gerenciamento da AWS ]
Siga estas etapas para modificar um grupo de parâmetros do Amazon DocumentDB personalizado. Não é possível modificar um grupo de parâmetros `default`. Se você deseja modificar um valor no grupo de parâmetros `default`, você pode [copiar o grupo de parâmetros de cluster padrão](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), modificá-lo e aplicá-lo ao cluster. Para obter mais informações sobre como aplicar grupos de parâmetros ao cluster, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
**Para modificar um grupos de parâmetros de cluster personalizado**
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, no lado esquerdo do console, selecione **Grupos de parâmetros**. Na lista de grupos de parâmetro, escolha o nome do grupo de parâmetro que deseja modificar.
**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. Para cada parâmetro no grupo de parâmetro que desejar modificar, faça o seguinte:
1. Localize o parâmetro que deseja modificar e verifique se ele é modificável e se está listado como `true` na coluna **Modificável**.
1. Se for modificável, selecione o parâmetro e escolha **Editar** no canto superior direito da página do console.
1. Na caixa de diálogo **Modificar ``**, faça as alterações que deseja. Depois disso, escolha **Modificar parâmetro de cluster** ou **Cancelar** para descartar as alterações.
------
#### [ Using the AWS CLI ]
É possível modificar o `ParameterValue`, a `Description` ou o `ApplyMethod` de qualquer parâmetro modificável em um grupo de parâmetros de cluster personalizado do Amazon DocumentDB usando a AWS CLI. Não é possível fazer modificações diretamente em um grupo de parâmetros de cluster.
Para modificar os parâmetros de um grupo de parâmetros de cluster personalizado, use a operação `modify-db-cluster-parameter-group` com os parâmetros a seguir.
+ **--db-cluster-parameter-group-name** — Obrigatório. O nome do grupos de parâmetros de cluster que você está modificando.
+ **--parameters** — Obrigatório. Os parâmetros que você está modificando. Para obter uma lista dos parâmetros que se aplicam a todas as instâncias em um cluster do Amazon DocumentDB, consulte [Referência de parâmetros de cluster do Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md). Cada entrada de parâmetro deve incluir o seguinte:
+ **ParameterName** — O nome do parâmetro que você está modificando.
+ **ParameterValue** — o novo valor para esse parâmetro.
+ **ApplyMethod** — como você deseja aplicar as alterações nesse parâmetro. Os valores permitidos são `immediate` e `pending-reboot`.
**nota**
Os parâmetros com `ApplyType` de `static` devem ter um `ApplyMethod` de `pending-reboot`.
**Example - Modificando o valor de um parâmetro**
Neste exemplo, você lista os valores de parâmetro de `sample-parameter-group` e modifica o parâmetro `tls`. Em seguida, após esperar 5 minutos, você listará novamente os valores dos parâmetros do `sample-parameter-group` para vê-los alterados.
1. Liste os parâmetros e os valores do `sample-parameter-group`.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Para Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"Parameters": [
{
"Source": "system",
"ApplyType": "static",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "tls",
"IsModifiable": true,
"Description": "Config to enable/disable TLS"
},
{
"Source": "user",
"ApplyType": "dynamic",
"AllowedValues": "disabled,enabled",
"ParameterValue": "enabled",
"ApplyMethod": "pending-reboot",
"DataType": "string",
"ParameterName": "ttl_monitor",
"IsModifiable": true,
"Description": "Enables TTL Monitoring"
}
]
}
```
1. Modifique o parâmetro `tls` para que seu valor seja `disabled`.
Não é possível modificar o `ApplyMethod` porque o `ApplyType` é `static`.
Para Linux, macOS ou Unix:
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
Para Windows:
```
aws docdb modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name sample-parameter-group ^
--parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"DBClusterParameterGroupName": "sample-parameter-group"
}
```
1. Aguarde pelo menos 5 minutos.
1. Liste os valores de parâmetros de `sample-parameter-group` para verificar se o parâmetro `tls` foi modificado.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Para Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"Parameters": [
{
"ParameterValue": "false",
"ParameterName": "enable_audit_logs",
"ApplyType": "dynamic",
"DataType": "string",
"Description": "Enables auditing on cluster.",
"AllowedValues": "true,false",
"Source": "system",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterValue": "disabled",
"ParameterName": "tls",
"ApplyType": "static",
"DataType": "string",
"Description": "Config to enable/disable TLS",
"AllowedValues": "disabled,enabled",
"Source": "system",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------