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 cluster do ElastiCache
Além de adicionar ou remover nós de um cluster do ElastiCache, pode haver momentos em que você precisará fazer outras alterações, como adicionar um grupo de segurança, alterar a janela de manutenção ou um grupo de parâmetros.
Recomendamos que você tenha sua janela de manutenção cair no momento da menor utilização. Assim, talvez seja necessário modificá-la de tempos em tempos.
Quando você altera parâmetros de um cluster, a alteração é aplicada no cluster imediatamente ou após ele ser reiniciado. Isso é verdadeiro se você alterar o próprio grupo de parâmetro do cluster ou um valor do parâmetro dentro do grupo do parâmetro do cluster. Para determinar quando uma mudança de parâmetro particular é aplicada, consulte a seção **As alterações terão efeito** da coluna **Detalhes** nas tabelas de [Parâmetros específicos do Memcached](ParameterGroups.Engine.md#ParameterGroups.Memcached) e [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis). Para obter informações sobre como reinicializar um cluster, consulte [Reinicialização de nós](nodes.rebooting.md).
## Uso do Console de gerenciamento da AWS do ElastiCache
**Como modificar um cluster**
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. Na lista localizada no canto superior direito, escolha a região da AWS em que o cluster que você deseja modificar está localizado.
1. No painel de navegação, escolha o mecanismo em execução no cluster que deseja modificar.
É exibida uma lista dos clusters do mecanismo escolhido.
1. Na lista de clusters, no cluster que você deseja modificar, escolha seu nome.
1. Escolha **Actions** (Ações) e **Modify** (Modificar).
A janela **Modify Cluster** (Modificar cluster) é exibida.
1. Na janela **Modify Cluster** (Modificar cluster), faça as modificações desejadas. Entre as opções estão:
+ Descrição
+ Modo de cluster: para modificar o modo de cluster de **Desativado** para **Ativado**, você deve primeiro definir o modo de cluster como **Compatível**.
O modo compatível permite que seus clientes Valkey ou Redis OSS se conectem usando o modo de cluster habilitado e o modo de cluster desabilitado. Depois de migrar todos os clientes Valkey ou Redis OSS para usar o modo cluster habilitado, você poderá concluir a configuração do modo cluster e definir o modo cluster como **Habilitado**.
+ Compatibilidade de versão de mecanismo
**Importante**
Você pode atualizar para versões mais recentes do mecanismo. Se você atualizar as principais versões do mecanismo, por exemplo, de 5.0.6 para 6.0, será necessário selecionar uma família de grupo de parâmetros que seja compatível com a nova versão do mecanismo. Para obter mais informações para fazer isso, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md). No entanto, você não pode fazer downgrade para versões anteriores do mecanismo, exceto excluindo o cluster existente e criando-o novamente.
+ Grupos de segurança da VPC
+ Grupo do parâmetro
+ Tipo de nó
**nota**
Se o cluster estiver usando um tipo de nó da família r6gd, você só poderá escolher um tamanho de nó diferente nessa família. Se você escolher um tipo de nó da família r6gd, a classificação de dados em níveis será ativada automaticamente. Para mais informações, consulte [Classificação de dados em níveis](data-tiering.md).
+ Multi-AZ
+ Failover automático (somente no modo cluster desabilitado)
+ Habilitar backups automáticos
+ ID do nó de backup
+ Backup Retention Period
+ Janela de backup
+ Tópico para notificação do SNS
+ Compatibilidade de versão do mecanismo Memcached
+ Tipo de rede
**nota**
Se você estiver mudando de IPv4 para IPv6, deverá selecionar ou criar grupos de sub-rede compatíveis com IPv6. Para obter mais informações, consulte [Escolhendo um tipo de rede em ElastiCache](network-type.md).
+ Grupos de segurança da VPC
+ Grupo do parâmetro
+ Janela de manutenção
+ Tópico para notificação do SNS
A caixa **Apply Immediately (Aplicar imediatamente)** aplica-se apenas a modificações feitas no tipo de nó e na versão do mecanismo. Para aplicar alterações imediatamente, marque a caixa de seleção **Apply Immediately** (Aplicar imediatamente). Se essa caixa não for escolhida, as modificações feitas na versão do mecanismo serão aplicadas durante a próxima janela de manutenção. Outras modificações, como a alteração da janela de manutenção, são aplicadas imediatamente.
**Para habilitar/desabilitar a entrega de logs para o Redis**
1. Na lista de clusters, escolha o cluster que você deseja modificar. Selecione o **Cluster name** (Nome do cluster), e não a caixa de seleção ao lado dele.
1. Na página **Detalhes do cluster**, escolha a guia **Logs**.
1. Para habilitar/desabilitar logs lentos, escolha **Habilitar** ou **Desabilitar**.
Se você escolher habilitar:
1. Em **Log format** (Formato do log), escolha **JSON** ou **Text** (Texto).
1. Em **Log destination type** (Tipo de destino de log), escolha **CloudWatch Logs** (Logs do CloudWatch) ou **Kinesis Firehose**.
1. Em **Destino do log**, escolha **Criar novo** e insira o nome do grupo de logs do CloudWatchLogs ou o nome do stream do Kinesis Data Firehose. Você também pode escolher **Selecionar existente** e escolher o nome do grupo de logs do CloudWatchLogs ou o nome do stream do Kinesis Data Firehose.
1. Escolha **Habilitar**.
**Para alterar sua configuração para o Redis:**
1. Escolha **Modificar**.
1. Em **Log format** (Formato do log), escolha **JSON** ou **Text** (Texto).
1. Em **Destination Type** (Tipo de destino), escolha **CloudWatch Logs** (Logs do CloudWatch) ou **Kinesis Firehose**.
1. Em **Log destination** (Destino do log), escolha **Create new** (Criar) e insira o nome do grupo de logs do CloudWatchLogs ou o nome do stream do Kinesis Data Firehose. Ou escolha **Select existing** (Selecionar existente) e escolha o nome do grupo de logs do CloudWatchLogs ou o nome do stream do Kinesis Data Firehose.
## Uso da AWS CLI com o ElastiCache
Você pode modificar um cluster existente usando a operação AWS CLI `modify-cache-cluster`. Para modificar o valor de configuração de um cluster, especifique o ID do cluster, o parâmetro a ser alterado e o novo valor do parâmetro. O exemplo a seguir altera a janela de manutenção para um cluster chamado `my-cluster` e aplica a alteração imediatamente.
**Importante**
Você pode atualizar para versões mais recentes do mecanismo Memcached. Para obter mais informações para fazer isso, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md). No entanto, você não pode fazer downgrade para versões anteriores do mecanismo, exceto excluindo o cluster existente e criando-o novamente.
**Importante**
Você pode atualizar para versões mais recentes do mecanismo Valkey ou Redis OSS. Se você atualizar as principais versões do mecanismo, por exemplo, do Redis OSS 5.0.6 para o Redis OSS 6.0, será preciso selecionar uma família de grupos de parâmetros que seja compatível com a nova versão do mecanismo. Para obter mais informações para fazer isso, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md). No entanto, você não pode fazer downgrade para versões anteriores do mecanismo, exceto excluindo o cluster existente e criando-o novamente.
Para Linux, macOS ou Unix:
```
aws elasticache modify-cache-cluster \
--cache-cluster-id my-cluster \
--preferred-maintenance-window sun:23:00-mon:02:00
```
Para Windows:
```
aws elasticache modify-cache-cluster ^
--cache-cluster-id my-cluster ^
--preferred-maintenance-window sun:23:00-mon:02:00
```
O parâmetro `--apply-immediately` aplica-se apenas a modificações no tipo de nó, na versão do mecanismo e a alteração do número de nós em um cluster. Se quiser aplicar qualquer uma dessas alterações imediatamente, use o parâmetro `--apply-immediately`. Se preferir adiar essas alterações para sua próxima janela de manutenção, use o parâmetro `--no-apply-immediately`. Outras modificações, como a alteração da janela de manutenção, são aplicadas imediatamente.
Para obter mais informações, consulte a AWS CLI para o tópico do ElastiCache [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html).
## Uso da API do ElastiCache
Você pode modificar um cluster existente usando a operação `ModifyCacheCluster` da API do ElastiCache. Para modificar o valor de configuração de um cluster, especifique o ID do cluster, o parâmetro a ser alterado e o novo valor do parâmetro. O exemplo a seguir altera a janela de manutenção para um cluster chamado `my-cluster` e aplica a alteração imediatamente.
**Importante**
Você pode atualizar para versões mais recentes do mecanismo Memcached. Para obter mais informações para fazer isso, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md). No entanto, você não pode fazer downgrade para versões anteriores do mecanismo, exceto excluindo o cluster existente e criando-o novamente.
**Importante**
Você pode atualizar para versões mais recentes do mecanismo Valkey ou Redis OSS. Se você atualizar as principais versões do mecanismo, por exemplo, do Redis OSS 5.0.6 para o Redis OSS 6.0, será preciso selecionar uma família de grupos de parâmetros que seja compatível com a nova versão do mecanismo. Para obter mais informações para fazer isso, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md). No entanto, você não pode fazer downgrade para versões anteriores do mecanismo, exceto excluindo o cluster existente e criando-o novamente.
As quebras de linha foram adicionadas para legibilidade.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=ModifyCacheCluster
&CacheClusterId=my-cluster
&PreferredMaintenanceWindow=sun:23:00-mon:02:00
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150901T220302Z
&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
&X-Amz-Date=20150202T220302Z
&X-Amz-SignedHeaders=Host
&X-Amz-Expires=20150901T220302Z
&X-Amz-Credential=
&X-Amz-Signature=
```
O parâmetro `ApplyImmediately` aplica-se apenas a modificações no tipo de nó, na versão do mecanismo e a alteração do número de nós em um cluster. Se quiser aplicar qualquer uma dessas alterações imediatamente, defina o parâmetro `ApplyImmediately` como `true`. Se preferir adiar essas alterações para sua próxima janela de manutenção, defina o parâmetro `ApplyImmediately` como `false`. Outras modificações, como a alteração da janela de manutenção, são aplicadas imediatamente.
Para obter mais informações, consulte o tópico de referência da API do ElastiCache [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html).