

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 replicação
<a name="Replication.Modify"></a>

**Restrições importantes**  
Atualmente, ElastiCache oferece suporte a modificações limitadas de um grupo de replicação Valkey ou Redis OSS (modo de cluster ativado), por exemplo, alterando a versão do mecanismo usando a operação de API (`ModifyReplicationGroup`CLI:). `modify-replication-group` Você pode modificar o número de fragmentos (grupos de nós) em um cluster do Valkey ou Redis OSS (modo cluster habilitado) com a operação da API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroupShardConfiguration.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroupShardConfiguration.html) (CLI: [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group-shard-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group-shard-configuration.html)). Para obter mais informações, consulte [Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado)](scaling-redis-cluster-mode-enabled.md).  
Outras modificações em um cluster do Valkey ou Redis OSS (modo cluster habilitado) exigem que você o crie novamente com o novo cluster que incorpore as alterações.
Você pode atualizar os clusters e grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado) e Valkey ou Redis OSS (modo cluster habilitado) para versões mais recentes do mecanismo. No entanto, você não pode fazer downgrade para versões anteriores do mecanismo, exceto excluindo o cluster existente ou grupo de replicação e criando-o novamente. Para obter mais informações, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md).
Você pode atualizar um cluster OSS existente ElastiCache para Valkey ou Redis que usa o modo de cluster desativado para usar o modo de cluster ativado, usando o console, a [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)API ou o comando [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html)CLI, conforme mostrado no exemplo abaixo. Ou você pode seguir as etapas em [Modificar o modo de cluster](modify-cluster-mode.md).

Você pode modificar as configurações de um cluster Valkey ou Redis OSS (modo de cluster desativado) usando o ElastiCache console AWS CLI, o ou a API. ElastiCache Atualmente, ElastiCache oferece suporte a um número limitado de modificações em um grupo de replicação Valkey ou Redis OSS (modo de cluster ativado). Outras modificações exigem que você crie um backup do grupo de replicação e, em seguida, use esse backup para propagar um novo grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado).

**Topics**
+ [Usando o Console de gerenciamento da AWS](#Replication.Modify.CON)
+ [Usando o AWS CLI](#Replication.Modify.CLI)
+ [Usando a ElastiCache API](#Replication.Modify.API)

## Usando o Console de gerenciamento da AWS
<a name="Replication.Modify.CON"></a>

Para modificar um cluster do Valkey ou Redis OSS (modo cluster desabilitado), consulte [Modificação de um cluster do ElastiCache](Clusters.Modify.md).

## Usando o AWS CLI
<a name="Replication.Modify.CLI"></a>

Veja a seguir AWS CLI exemplos do `modify-replication-group` comando. Você pode usar o mesmo comando para fazer outras modificações em um grupo de replicação.

**Ativar multi-AZ em um grupo de replicação do Valkey ou Redis OSS existente:**

Para Linux, macOS ou Unix:

```
aws elasticache modify-replication-group \
   --replication-group-id myReplGroup \
   --multi-az-enabled = true
```

Para Windows:

```
aws elasticache modify-replication-group ^
   --replication-group-id myReplGroup ^
   --multi-az-enabled
```

**Modifique o modo de cluster de desativado para ativado:**

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

Para Linux, macOS ou Unix:

Defina o modo de cluster como *compatível*.

```
aws elasticache modify-replication-group \
   --replication-group-id myReplGroup \
   --cache-parameter-group-name myParameterGroupName \
   --cluster-mode compatible
```

Defina o modo de cluster como *ativado*.

```
aws elasticache modify-replication-group \
   --replication-group-id myReplGroup \
   --cluster-mode enabled
```

Para Windows:

Defina o modo de cluster como *compatível*.

```
aws elasticache modify-replication-group ^
   --replication-group-id myReplGroup ^
   --cache-parameter-group-name myParameterGroupName ^
   --cluster-mode compatible
```

Defina o modo de cluster como *ativado*.

```
aws elasticache modify-replication-group ^
   --replication-group-id myReplGroup ^
   --cluster-mode enabled
```

Para obter mais informações sobre o AWS CLI `modify-replication-group` comando, consulte [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) ou [Modificando o modo de cluster]() no Guia do *ElastiCache usuário do Redis OSS.*

## Usando a ElastiCache API
<a name="Replication.Modify.API"></a>

A operação de ElastiCache API a seguir habilita o Multi-AZ em um grupo de replicação Valkey ou Redis OSS existente. Você pode usar a mesma operação para fazer outras modificações em um grupo de replicação.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyReplicationGroup
   &AutomaticFailoverEnabled=true  
   &Mutli-AZEnabled=true  
   &ReplicationGroupId=myReplGroup
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20141201T220302Z
   &Version=2014-12-01
   &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
   &X-Amz-Date=20141201T220302Z
   &X-Amz-SignedHeaders=Host
   &X-Amz-Expires=20141201T220302Z
   &X-Amz-Credential=<credential>
   &X-Amz-Signature=<signature>
```

Para obter mais informações sobre a `ModifyReplicationGroup` operação ElastiCache da API, consulte[ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html).