

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

# Modificação de um grupo de parâmetros do ElastiCache
<a name="ParameterGroups.Modifying"></a>

**Importante**  
Não é possível modificar um parameter group padrão.

Você pode modificar alguns valores de parâmetros em um parameter group. Esses valores de parâmetros são aplicados a clusters associados ao parameter group. Para obter mais informações sobre quando uma mudança no valor do parâmetro é aplicada a um parameter group, consulte [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis) e [Parâmetros específicos do Memcached](ParameterGroups.Engine.md#ParameterGroups.Memcached).

## Modificação de um grupo de parâmetros (console)
<a name="ParameterGroups.Modifying.CON"></a>

O procedimento a seguir mostra como alterar o valor do parâmetro `cluster-enabled` usando o console do ElastiCache. Você usaria o mesmo procedimento para alterar o valor de qualquer parâmetro.

**Para alterar o valor de um parâmetro usando o console do ElastiCache**

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

1. Para ver uma lista de todos os parameter groups disponíveis, no painel de navegação à esquerda, escolha **Parameter Groups**.

1. Escolha o parameter group que você deseja modificar, marcando a caixa à esquerda do nome do parameter group.

   Os parâmetros do parameter group serão listados na parte inferior da tela. Talvez você precise paginar pela lista para ver todos os parâmetros.

1. Para modificar um ou mais parâmetros, escolha **Edit Parameters**.

1. Na tela **Edit Parameter Group:**, percorra usando as setas esquerda e direita até encontrar o parâmetro `binding_protocol`. Em seguida, digite `ascii` na coluna **Value**.

1. Escolha **Salvar alterações**.

1. Para o Memcached, para localizar o nome do parâmetro que você alterou, consulte [Parâmetros específicos do Memcached](ParameterGroups.Engine.md#ParameterGroups.Memcached). Se alterações no parâmetro ocorrerem depois da reinicialização (*After restart*), reinicialize todos os clusters que usam esse parameter group. Para obter mais informações, consulte [Rebooting clusters](Clusters.html#Rebooting).

1. Com Valkey e Redis OSS, para localizar o nome do parâmetro que você alterou, consulte [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis). Se você tiver um cluster do Valkey ou Redis OSS (modo cluster desabilitado) e fizer alterações nos parâmetros a seguir, é preciso reinicializar os nós no cluster:
   + activerehashing
   + bancos de dados

    Para obter mais informações, consulte [Reinicialização de nós](nodes.rebooting.md).
**Alterações de parâmetro do Valkey ou Redis OSS (modo cluster habilitado)**  
Se você fizer alterações nos parâmetros a seguir em um cluster do Valkey ou Redis OSS (modo cluster habilitado), siga as etapas a seguir.  
activerehashing
bancos de dados
Com o Redis OSS, você pode criar um backup manual do cluster. Consulte [Realização de backups manuais](backups-manual.md).
Excluir o cluster. Consulte [Deleting clusters](Clusters.html#Delete).
Restaure o cluster usando o parameter group alterado e o backup para propagar o novo cluster. Consulte [Restauração de um backup para um novo cache](backups-restoring.md).
Alterações em outros parâmetros não exigem isso.



## Modificação de um grupo de parâmetros (AWS CLI)
<a name="ParameterGroups.Modifying.CLI"></a>

Para alterar o valor de um parâmetro usando a AWS CLI, use o comando `modify-cache-parameter-group`.

**Example**  
Com o Memcached, para localizar o nome e os valores permitidos do parâmetro que você deseja alterar, consulte [Parâmetros específicos do Memcached](ParameterGroups.Engine.md#ParameterGroups.Memcached)  
O código de exemplo a seguir define o valor de dois parâmetros, *chunk\$1size* e *chunk\$1size\$1growth\$1fact* no parameter group `myMem14`.  
Para Linux, macOS ou Unix:  

```
aws elasticache modify-cache-parameter-group \
    --cache-parameter-group-name myMem14 \
    --parameter-name-values \
        ParameterName=chunk_size,ParameterValue=96 \
        ParameterName=chunk_size_growth_fact,ParameterValue=1.5
```
Para Windows:  

```
aws elasticache modify-cache-parameter-group ^
    --cache-parameter-group-name myMem14 ^
    --parameter-name-values ^
        ParameterName=chunk_size,ParameterValue=96 ^
        ParameterName=chunk_size_growth_fact,ParameterValue=1.5
```
A saída desse comando será semelhante a esta.  

```
{
    "CacheParameterGroupName": "myMem14"
}
```

**Example**  
Com o Valkey e Redis OSS, para localizar o nome e os valores permitidos do parâmetro que você deseja alterar, consulte [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis)  
O código de exemplo a seguir define o valor de dois parâmetros, *reserved-memory-percent* e *cluster-enabled* no parameter group `myredis32-on-30`. Definimos *reserved-memory-percent* como `30` (30%) e *cluster-enabled* como `yes` para que o grupo de parâmetros possa ser usado com clusters do Valkey ou Redis OSS (modo cluster habilitado) (grupos de replicação).  
Para Linux, macOS ou Unix:  

```
aws elasticache modify-cache-parameter-group \
    --cache-parameter-group-name myredis32-on-30 \
    --parameter-name-values \
        ParameterName=reserved-memory-percent,ParameterValue=30 \
        ParameterName=cluster-enabled,ParameterValue=yes
```
Para Windows:  

```
aws elasticache modify-cache-parameter-group ^
    --cache-parameter-group-name myredis32-on-30 ^
    --parameter-name-values ^
        ParameterName=reserved-memory-percent,ParameterValue=30 ^
        ParameterName=cluster-enabled,ParameterValue=yes
```
A saída desse comando será semelhante a esta.  

```
{
    "CacheParameterGroupName": "my-redis32-on-30"
}
```

Para obter mais informações, consulte [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-parameter-group.html).

Para localizar o parâmetro que você alterou, consulte [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis). 

 Se você tiver um cluster do Valkey ou Redis OSS (modo cluster desabilitado) e fizer alterações nos parâmetros a seguir, é preciso reinicializar os nós no cluster:
+ activerehashing
+ bancos de dados

 Para obter mais informações, consulte [Reinicialização de nós](nodes.rebooting.md).

**Alterações de parâmetro do Valkey ou Redis OSS (modo cluster habilitado)**  
Se você fizer alterações nos parâmetros a seguir em um cluster do Valkey ou Redis OSS (modo cluster habilitado), siga as etapas a seguir.  
activerehashing
bancos de dados
Crie um backup manual do seu cluster. Consulte [Realização de backups manuais](backups-manual.md).
Excluir o cluster. Consulte [Deleting clusters](Clusters.html#Delete).
Restaure o cluster usando o parameter group alterado e o backup para propagar o novo cluster. Consulte [Restauração de um backup para um novo cache](backups-restoring.md).
Alterações em outros parâmetros não exigem isso.

## Modificação de um grupo de parâmetros (API do ElastiCache)
<a name="ParameterGroups.Modifying.API"></a>

Para alterar os valores dos parâmetros de um grupo usando a API do ElastiCache, use a ação `ModifyCacheParameterGroup`.

**Example**  
Com o Memcached, para localizar o nome e os valores permitidos do parâmetro que você deseja alterar, consulte [Parâmetros específicos do Memcached](ParameterGroups.Engine.md#ParameterGroups.Memcached)  
O código de exemplo a seguir define o valor de dois parâmetros, *chunk\$1size* e *chunk\$1size\$1growth\$1fact* no parameter group `myMem14`.  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyCacheParameterGroup
   &CacheParameterGroupName=myMem14
   &ParameterNameValues.member.1.ParameterName=chunk_size
   &ParameterNameValues.member.1.ParameterValue=96
   &ParameterNameValues.member.2.ParameterName=chunk_size_growth_fact
   &ParameterNameValues.member.2.ParameterValue=1.5
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &Version=2015-02-02
   &X-Amz-Credential=<credential>
```

**Example**  
Com o Valkey e Redis OSS, para localizar o nome e os valores permitidos do parâmetro que você deseja alterar, consulte [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis)  
O código de exemplo a seguir define o valor de dois parâmetros, *reserved-memory-percent* e *cluster-enabled* no parameter group `myredis32-on-30`. Definimos *reserved-memory-percent* como `30` (30%) e *cluster-enabled* como `yes` para que o grupo de parâmetros possa ser usado com clusters do Valkey ou Redis OSS (modo cluster habilitado) (grupos de replicação).  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyCacheParameterGroup
   &CacheParameterGroupName=myredis32-on-30
   &ParameterNameValues.member.1.ParameterName=reserved-memory-percent
   &ParameterNameValues.member.1.ParameterValue=30
   &ParameterNameValues.member.2.ParameterName=cluster-enabled
   &ParameterNameValues.member.2.ParameterValue=yes
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &Version=2015-02-02
   &X-Amz-Credential=<credential>
```

Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheParameterGroup.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheParameterGroup.html).

Se você tiver um cluster do Valkey ou Redis OSS (modo cluster desabilitado) e fizer alterações nos parâmetros a seguir, é preciso reinicializar os nós no cluster:
+ activerehashing
+ bancos de dados

 Para obter mais informações, consulte [Reinicialização de nós](nodes.rebooting.md).

**Alterações de parâmetro do Valkey ou Redis OSS (modo cluster habilitado)**  
Se você fizer alterações nos parâmetros a seguir em um cluster do Valkey ou Redis OSS (modo cluster habilitado), siga as etapas a seguir.  
activerehashing
bancos de dados
Crie um backup manual do seu cluster. Consulte [Realização de backups manuais](backups-manual.md).
Excluir o cluster. Consulte [Excluindo um cluster no ElastiCache](Clusters.Delete.md).
Restaure o cluster usando o parameter group alterado e o backup para propagar o novo cluster. Consulte [Restauração de um backup para um novo cache](backups-restoring.md).
Alterações em outros parâmetros não exigem isso.