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á.
# Alta disponibilidade com o uso de grupos de replicação
Os clusters do Valkey e Redis OSS do Amazon ElastiCache de nó único são entidades na memória com serviços de proteção de dados limitados (AOF). Se o seu cluster falhar por qualquer motivo, você perderá todos os dados do cluster. No entanto, se você estiver executando o mecanismo Valkey ou Redis OSS, poderá agrupar de 2 a 6 nós em um cluster com réplicas em que 1 a 5 nós somente leitura contêm dados replicados do único nó primário de leitura/gravação do grupo. Nesse cenário, se um nó falhar por qualquer motivo, você não perderá todos os seus dados, pois eles serão replicados em um ou mais outros nós. Devido à latência de replicação, alguns dados podem ser perdidos se a falha ocorrer no nó primário de leitura/gravação.
Conforme visto no gráfico a seguir, a estrutura de replicação está contida dentro de um fragmento (chamado de *grupo de nós* na API/CLI) que está contido dentro de um cluster do Valkey ou Redis OSS. Clusters do Valkey ou Redis OSS (modo cluster desabilitado) sempre têm um fragmento. Clusters do Valkey ou Redis OSS (modo cluster habilitado) podem ter até 500 fragmentos, com os dados do cluster particionados nos fragmentos. É possível criar um cluster com alto número de fragmentos e baixo número de réplicas totalizando até 90 nós por cluster. Essa configuração do cluster pode variar de 90 fragmentos e 0 réplicas para 15 fragmentos e 5 réplicas, que é o número máximo de réplicas permitidas.
O limite de nó ou fragmento pode ser aumentado para um máximo de 500 por cluster com o ElastiCache para Valkey e com o ElastiCache versão 5.0.6 ou superior para Redis OSS. Por exemplo, você pode optar por configurar um cluster de 500 nós que varia entre 83 fragmentos (uma primária e 5 réplicas por fragmento) e 500 fragmentos (primário único e sem réplicas). Verifique se existem endereços IP disponíveis suficientes para acomodar o aumento. As armadilhas comuns incluem as sub-redes no grupo de sub-redes têm um intervalo CIDR muito pequeno ou as sub-redes são compartilhadas e fortemente usadas por outros clusters. Para obter mais informações, consulte [Criação de um grupo de sub-redes](SubnetGroups.Creating.md).
Para versões abaixo de 5.0.6, o limite é 250 por cluster.
Para solicitar um aumento de limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e selecione o tipo de limite **Nodes per cluster per instance type** (Nós por cluster por tipo de instância).
![\[Imagem: Cluster do Valkey ou Redis OSS (modo cluster desabilitado) tem um fragmento e de 0 a 5 nós de réplicas\]](http://docs.aws.amazon.com/pt_br/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-Redis-Replicas.png)
*Cluster do Valkey ou Redis OSS (modo cluster desabilitado) tem um fragmento e de 0 a 5 nós de réplicas*
Se o cluster com réplicas tiver o Multi-AZ habilitado e o nó primário falhar, esse nó primário executará failover em uma réplica de leitura. Como os dados são atualizados nos nós de réplica de forma assíncrona, pode haver alguma perda de dados devido à latência na atualização dos nós de réplica. Para obter mais informações, consulte [Mitigar falhas ao executar o Valkey ou Redis OSS](disaster-recovery-resiliency.md#FaultTolerance.Redis).
**Topics**
+ [Entendendo a replicação do Valkey e do Redis OSS](Replication.Redis.Groups.md)
+ [Replicação: Modo de cluster Valkey e Redis OSS desativado versus ativado](Replication.Redis-RedisCluster.md)
+ [Minimizar o tempo de inatividade no ElastiCache usando o Multi-AZ com Valkey e Redis OSS](AutoFailover.md)
+ [Como a sincronização e o backup são implementados](Replication.Redis.Versions.md)
+ [Criação de um grupo de replicação do Valkey ou Redis OSS](Replication.CreatingRepGroup.md)
+ [Visualização dos detalhes de um grupo de replicação](Replication.ViewDetails.md)
+ [Localização de endpoints de grupo de replicação](Replication.Endpoints.md)
+ [Modificação de um grupo de replicação](Replication.Modify.md)
+ [Exclusão de um grupo de replicação](Replication.DeletingRepGroup.md)
+ [Alteração do número de réplicas](increase-decrease-replica-count.md)
+ [Promoção de uma réplica de leitura a primário, para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado)](Replication.PromoteReplica.md)
# Entendendo a replicação do Valkey e do Redis OSS
O Redis OSS implementa a replicação de duas formas:
+ Com um único fragmento que contém todos os dados do cluster em cada nó: Valkey ou Redis OSS (modo cluster desabilitado)
+ Com dados particionados em até 500 fragmentos: Valkey ou Redis OSS (modo cluster habilitado)
Cada fragmento em um grupo de replicação tem um único nó primário de leitura/gravação e até 5 nós de réplica somente de leitura. É possível criar um cluster com alto número de fragmentos e baixo número de réplicas totalizando até 90 nós por cluster. Essa configuração do cluster pode variar de 90 fragmentos e 0 réplicas para 15 fragmentos e 5 réplicas, que é o número máximo de réplicas permitidas.
O limite de nó ou fragmento pode ser aumentado para um máximo de 500 por cluster se a versão do mecanismo Redis OSS for 5.0.6 ou superior. Por exemplo, você pode optar por configurar um cluster de 500 nós que varia entre 83 fragmentos (uma primária e 5 réplicas por fragmento) e 500 fragmentos (primário único e sem réplicas). Verifique se existem endereços IP disponíveis suficientes para acomodar o aumento. As armadilhas comuns incluem as sub-redes no grupo de sub-redes têm um intervalo CIDR muito pequeno ou as sub-redes são compartilhadas e fortemente usadas por outros clusters. Para obter mais informações, consulte [Criação de um grupo de sub-redes](SubnetGroups.Creating.md).
Para versões abaixo de 5.0.6, o limite é 250 por cluster.
Para solicitar um aumento de limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e selecione o tipo de limite **Nodes per cluster per instance type** (Nós por cluster por tipo de instância).
**Topics**
+ [Valkey ou Redis OSS (modo cluster desabilitado)](#Replication.Redis.Groups.Classic)
+ [Valkey ou Redis OSS (modo cluster habilitado)](#Replication.Redis.Groups.Cluster)
## Valkey ou Redis OSS (modo cluster desabilitado)
Um cluster do Valkey ou Redis OSS (modo cluster desabilitado) tem um único fragmento, dentro do qual há uma coleção de nós; um nó de leitura/gravação primário e até cinco nós de réplica secundários somente de leitura. Cada réplica de leitura mantém uma cópia dos dados do nó primário do cluster. Mecanismos de replicação assíncronos são usados para manter as réplicas de leitura sincronizadas com a primária. Os aplicativos podem ler a partir de qualquer nó no cluster. Os aplicativos podem apenas gravar no nó primário. Réplicas de leitura melhoram o throughput de leitura e protegem contra a perda de dados nos casos de falha de um nó.
![\[Imagem: Cluster do Valkey ou Redis OSS (modo cluster desabilitado) com um único fragmento e nós de réplicas\]](http://docs.aws.amazon.com/pt_br/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-Redis-Replicas.png)
*Cluster do Valkey ou Redis OSS (modo cluster desabilitado) com um único fragmento e nós de réplicas*
Você pode usar clusters do Valkey ou Redis OSS (modo cluster desabilitado) com réplicas de nós para escalar sua solução para o ElastiCache de modo a lidar com aplicações de leitura intensiva ou para oferecer suporte a um grande número de clientes que leiam simultaneamente do mesmo cluster.
Todos os nós em um cluster do Valkey ou Redis OSS (modo cluster desabilitado) devem residir na mesma região.
Quando você adiciona uma réplica de leitura a um cluster, todos os dados do primário são copiados para o novo nó. A partir desse momento, sempre que os dados são gravados no primário, as alterações são propagadas de forma assíncrona em todas as réplicas de leitura.
Para melhorar a tolerância a falhas e reduzir o tempo de gravação, habilitar o recurso multi-AZ com failover automático para o seu cluster do Valkey ou Redis OSS (modo cluster desabilitado) com réplicas. Para obter mais informações, consulte [Minimizar o tempo de inatividade no ElastiCache usando o Multi-AZ com Valkey e Redis OSS](AutoFailover.md).
Você pode alterar as funções dos nós dentro do cluster do Valkey ou Redis OSS (modo cluster desabilitado) com o primário e uma das réplicas trocando funções. Você pode decidir fazer isso por motivos de ajuste de desempenho. Por exemplo, com um aplicativo Web que possui uma intensa atividade de gravação, você pode escolher o nó que tenha a menor latência da rede. Para obter mais informações, consulte [Promoção de uma réplica de leitura a primário, para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado)](Replication.PromoteReplica.md).
## Valkey ou Redis OSS (modo cluster habilitado)
Um cluster do Valkey ou Redis OSS (modo cluster habilitado) é composto de 1 a 500 fragmentos (API/CLI: grupos de nós). Cada fragmento tem um nó primário e até cinco nós de réplica de leitura. A configuração pode variar de 90 fragmentos e 0 réplicas para 15 fragmentos e 5 réplicas, que é o número máximo de réplicas permitidas.
O limite de nós ou fragmentos pode ser aumentado para um máximo de 500 por cluster se a versão do mecanismo for Valkey 7.2 e posteriores ou Redis OSS 5.0.6 e posteriores. Por exemplo, você pode optar por configurar um cluster de 500 nós que varia entre 83 fragmentos (uma primária e 5 réplicas por fragmento) e 500 fragmentos (primário único e sem réplicas). Verifique se existem endereços IP disponíveis suficientes para acomodar o aumento. As armadilhas comuns incluem as sub-redes no grupo de sub-redes têm um intervalo CIDR muito pequeno ou as sub-redes são compartilhadas e fortemente usadas por outros clusters. Para obter mais informações, consulte [Criação de um grupo de sub-redes](SubnetGroups.Creating.md).
Para versões abaixo de 5.0.6, o limite é 250 por cluster.
Para solicitar um aumento de limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e selecione o tipo de limite **Nodes per cluster per instance type** (Nós por cluster por tipo de instância).
Cada réplica de leitura em um fragmento mantém uma cópia dos dados do primário do fragmento. Mecanismos de replicação assíncronos são usados para manter as réplicas de leitura sincronizadas com a primária. Os aplicativos podem ler a partir de qualquer nó no cluster. Os aplicativos podem apenas gravar nos nós primários. Réplicas de leitura melhoram a escalabilidade de leitura e protegem contra a perda de dados. Os dados são particionados em todos os fragmentos em um cluster do Valkey ou Redis OSS (modo cluster habilitado).
As aplicações usam o *endpoint de configuração* do cluster do Valkey ou Redis OSS (modo cluster habilitado) para se conectar aos nós no cluster. Para obter mais informações, consulte [Encontrar endpoints de conexão no ElastiCache](Endpoints.md).
![\[Imagem: Cluster do Valkey ou Redis OSS (modo cluster habilitado) com vários fragmentos e nós de réplicas\]](http://docs.aws.amazon.com/pt_br/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-RedisClusters.png)
*Cluster do Valkey ou Redis OSS (modo cluster habilitado) com vários fragmentos e nós de réplica*
Todos os nós em um cluster do Valkey ou Redis OSS (modo cluster habilitado) devem residir na mesma região. Para melhorar a tolerância a falhas, você pode provisionar primários e réplicas de leitura em várias zonas de disponibilidade dentro dessa região.
Atualmente, os recursos Valkey ou Redis OSS (modo cluster habilitado) têm algumas limitações.
+ Você não pode promover manualmente nenhum nó de réplica para primário.
# Replicação: Modo de cluster Valkey e Redis OSS desativado versus ativado
Começando com o Valkey 7.2 e o Redis OSS versão 3.2, você pode criar um dos dois tipos distintos de clusters (API/CLI: grupos de replicação). Um cluster do Valkey ou Redis OSS (modo cluster desabilitado) sempre possui um único fragmento (API/CLI: grupo de nós) com até 5 nós de réplicas de leitura. Um cluster do Valkey ou Redis OSS (modo cluster habilitado) tem até 500 fragmentos de 1 a 5 nós de réplicas de leitura em cada.
![\[Imagem: Clusters do Valkey ou Redis OSS (modo cluster desabilitado) e do Valkey ou Redis OSS (modo cluster habilitado)\]](http://docs.aws.amazon.com/pt_br/AmazonElastiCache/latest/dg/images/ElastiCache-NodeGroups.png)
*Clusters do Valkey ou Redis OSS (modo cluster desabilitado) e do Redis OSS (modo cluster habilitado)*
A tabela a seguir resume diferenças importantes entre os clusters do Valkey ou Redis OSS (modo cluster desabilitado) e do Valkey ou Redis OSS (modo cluster habilitado).
**Comparação de clusters do Valkey ou Redis OSS (modo cluster desabilitado) e do Valkey ou Redis OSS (modo cluster habilitado)**
| Recurso | Valkey ou Redis OSS (modo cluster desabilitado) | Valkey ou Redis OSS (modo cluster habilitado) |
| --- | --- | --- |
| Modificável | Sim. Oferece suporte para adicionar e excluir nós de réplica e aumentar a escala verticalmente do tipo de nó. | Limitado. Para obter mais informações, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md) e [Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado)](scaling-redis-cluster-mode-enabled.md). |
| Particionamento de dados | Não | Sim |
| Estilhaços | 1 | 1 a 500 |
| Réplicas de leitura | 0 – 5 Se você não tiver réplicas e o nó falhar, ocorrerá uma perda total de dados. | 0 a 5 por fragmento. Se você não tiver réplicas e um nó falhar, ocorrerá uma perda de todos os dados nesse estilhaço. |
| Multi-AZ | Sim, com pelo menos 1 réplica. Opcional. Ativado por padrão. | SimOpcional. Ativado por padrão. |
| Snapshots (Backups) | Sim, criando um único arquivo .rdb. | Sim, criando um arquivo .rdb exclusivo para cada estilhaço. |
| Restaurar | Sim, usando um único arquivo .rdb de um cluster do Valkey ou Redis OSS (modo cluster desabilitado). | Sim, usando arquivos .rdb de um cluster do Valkey ou Redis OSS (modo cluster desabilitado) ou do Valkey ou Redis OSS (modo cluster habilitado). |
| Com suporte por | Todas as versões do Valkey e Redis OSS | Todas as versões do Valkey e Redis OSS 3.2 e seguintes |
| Mecanismo atualizável | Sim, com alguns limites. Para obter mais informações, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md). | Sim, com alguns limites. Para obter mais informações, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md). |
| Criptografia | Versões 3.2.6 (programadas para EOL, consulte [Cronograma de fim de vida útil das versões do Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e posteriores. | Versões 3.2.6 (programadas para EOL, consulte [Cronograma de fim de vida útil das versões do Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e posteriores. |
| Elegível para HIPAA | Versões 3.2.6 (programadas para EOL, consulte [Cronograma de fim de vida útil das versões do Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e posteriores. | Versões 3.2.6 (programadas para EOL, consulte [Cronograma de fim de vida útil das versões do Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e posteriores. |
| Compatível com PCI DSS | Versões 3.2.6 (programadas para EOL, consulte [Cronograma de fim de vida útil das versões do Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e posteriores. | Versões 3.2.6 (programadas para EOL, consulte [Cronograma de fim de vida útil das versões do Redis OSS](engine-versions.md#deprecated-engine-versions)) e 4.0.10 e posteriores. |
| Reestilhaçamento online | N/D | Versão 3.2.10 (programada para EOL, consulte [Cronograma de fim de vida útil das versões do Redis OSS](engine-versions.md#deprecated-engine-versions)) e posterior. |
## Qual devo escolher?
Ao escolher entre Valkey ou Redis OSS (modo cluster desabilitado) ou Valkey ou Redis OSS (modo cluster habilitado), considere os seguintes fatores:
+ **Escalabilidade versus particionamento**: os negócios precisam mudar. Você precisa fornecer provisão para demanda máxima ou escalar conforme a demanda sofre alterações. O Valkey ou Redis OSS (modo cluster desabilitado) oferece suporte a escalabilidade. Você pode dimensionar a capacidade de leitura adicionando ou excluindo nós de réplica ou pode dimensionar a capacidade aumentando para um tipo de nó maior. Ambas as operações exigem tempo. Para obter mais informações, consulte [Escalar nós de réplica para Valkey ou Redis OSS (modo cluster desativado)](Scaling.RedisReplGrps.md).
O Valkey ou Redis OSS (modo cluster habilitado) oferece suporte para o particionamento dos seus dados em até 500 grupos de nós. Você pode alterar dinamicamente o número de estilhaços à medida que suas necessidades de negócios mudam. Uma vantagem do particionamento é que você espalha sua carga em um número maior de endpoints que reduz o afunilamento de acesso durante a demanda de pico. Além disso, você pode acomodar um conjunto de dados maior, pois os dados podem ser distribuídos em vários servidores. Para obter informações sobre como escalar suas partições, consulte [Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado)](scaling-redis-cluster-mode-enabled.md).
+ **Tamanho do nó versus número de nós**: como um cluster do Valkey ou Redis OSS (modo cluster desabilitado) tem apenas um fragmento, o tipo de nó deve ser grande o suficiente para acomodar todos os dados do cluster mais a sobrecarga necessária. Por outro lado, como você pode particionar seus dados em vários fragmentos ao usar um cluster do Valkey ou Redis OSS (modo cluster habilitado), os tipos de nós podem ser menores, embora você precise de mais deles. Para obter mais informações, consulte [Escolha do tamanho do nó](CacheNodes.SelectSize.md).
+ **Leituras versus gravações**: se a carga principal no seu cluster for de aplicações que leiam dados, você poderá escalar um cluster do Valkey ou Redis OSS (modo cluster habilitado) adicionando e excluindo réplicas de leitura. No entanto, há um máximo de 5 réplicas de leitura. Se a carga no seu cluster for de escrita pesada, você poderá se beneficiar dos endpoints de gravação adicionais de um cluster do Valkey ou Redis OSS (modo cluster habilitado) com vários fragmentos.
Seja qual for o tipo de cluster que você optar por implementar, certifique-se de escolher um tipo de nó que seja adequado para suas necessidades atuais e futuras.
# Minimizar o tempo de inatividade no ElastiCache usando o Multi-AZ com Valkey e Redis OSS
Há várias instâncias em que o ElastiCache para Valkey e Redis OSS pode precisar substituir um nó primário; elas incluem certos tipos de manutenção planejada e o evento improvável de falha em um nó primário ou zona de disponibilidade.
Essa substituição resulta em algum tempo de inatividade do cluster, mas se o multi-AZ estiver habilitado, o tempo de inatividade será minimizado. A função do nó primário fará failover automaticamente para uma das réplicas de leitura. Não há necessidade de criar e provisionar um novo nó primário, porque o ElastiCache lidará com isso de forma transparente. O failover e a promoção de réplica garantem que você possa continuar a gravar no novo primário assim que a promoção estiver concluída.
O ElastiCache também propaga o nome do DNS (Serviço de Nomes de Domínio) da réplica promovida. Isso ocorre porque, em seguida, se o seu aplicativo estiver gravando no endpoint primário, nenhuma alteração nesse endpoint será necessária no seu aplicativo. Se estiver lendo de endpoints individuais, altere o endpoint de leitura da réplica promovida a primária para o endpoint da nova réplica.
No caso de substituições de nó planejadas, iniciadas devido a atualizações de manutenção ou atualizações de autoatendimento, esteja ciente do seguinte:
+ Para clusters do Valkey e Redis OSS, as substituições de nó planejadas são concluídas enquanto o cluster atende às solicitações de gravação recebidas.
+ Para clusters desabilitados do modo de cluster do Valkey e Redis OSS com o Multi-AZ habilitado que são executados no mecanismo 5.0.6 ou posterior, as substituições de nó planejadas são concluídas enquanto o cluster atende às solicitações de gravação recebidas.
+ Para clusters desabilitados do modo de cluster do Valkey e Redis OSS com o Multi-AZ habilitado que são executados no mecanismo 4.0.10 ou anterior, é possível notar uma breve interrupção de gravação associada às atualizações de DNS. Essa interrupção pode levar até alguns segundos. Esse processo é muito mais rápido do que recriar e provisionar um novo primário, que será o caso se você não habilitar o multi-AZ.
É possível habilitar o multi-AZ usando o console de gerenciamento do ElastiCache, a AWS CLI ou a API do ElastiCache.
Habilitar o Multi-AZ do ElastiCache no cluster do Valkey ou Redis OSS (na API e CLI ou no grupo de replicação) melhora a tolerância a falhas. Isso é verdade, especialmente nos casos em que o cluster primário de leitura/gravação do seu cluster se torna inacessível ou falha por qualquer motivo. O Multi-AZ só é aceito em clusters do Valkey e Redis OSS com mais de um nó em cada fragmento.
**Topics**
+ [Habilitar Multi-AZ](#AutoFailover.Enable)
+ [Cenários de falha com respostas do multi-AZ](#AutoFailover.Scenarios)
+ [Teste do failover automático](#auto-failover-test)
+ [Limitações no Multi-AZ](#AutoFailover.Limitations)
## Habilitar Multi-AZ
É possível habilitar o multi-AZ ao criar ou modificar um cluster (API, CLI ou grupo de replicação) usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache.
É possível habilitar o Multi-AZ somente em clusters do Valkey ou Redis OSS (modo cluster desabilitado) que têm pelo menos uma réplica de leitura disponível. Clusters sem réplicas de leitura não fornece alta disponibilidade ou tolerância a falhas. Para obter informações sobre como criar um cluster com replicação, consulte [Criação de um grupo de replicação do Valkey ou Redis OSS](Replication.CreatingRepGroup.md). Para obter informações sobre como adicionar uma réplica de leitura a um cluster com replicação, consulte [Adição de uma réplica de leitura do Valkey ou do Redis OSS (modo cluster desabilitado)](Replication.AddReadReplica.md).
**Topics**
+ [Habilitação do multi-AZ (console)](#AutoFailover.Enable.Console)
+ [Habilitar o recurso multi-AZ (AWS CLI)](#AutoFailover.Enable.CLI)
+ [Habilitação do multi-AZ (API do ElastiCache)](#AutoFailover.Enable.API)
### Habilitação do multi-AZ (console)
É possível habilitar o Multi-AZ usando o console do ElastiCache ao criar um novo cluster do Valkey ou Redis OSS ou modificando um cluster existente com replicação.
O Multi-AZ é habilitado por padrão em clusters do Valkey ou Redis OSS (modo cluster habilitado).
**Importante**
O ElastiCache habilitará automaticamente o multi-AZ somente se o cluster contiver pelo menos uma réplica em uma zona de disponibilidade diferente da principal em todos os fragmentos.
#### Habilitação do multi-AZ ao criar um cluster usando o console do ElastiCache
Para obter mais informações sobre esse processo, consulte [Criação de um cluster do Valkey (modo cluster desabilitado) (console)](SubnetGroups.designing-cluster-pre.valkey.md#Clusters.Create.CON.valkey-gs). Tenha uma ou mais réplicas e habilite o Multi-AZ.
#### Habilitação do multi-AZ em um cluster existente (console)
Para obter mais informações sobre esse processo, consulte Modificação de um cluster [Uso do Console de gerenciamento da AWS do ElastiCache](Clusters.Modify.md#Clusters.Modify.CON).
### Habilitar o recurso multi-AZ (AWS CLI)
O exemplo de código a seguir usa a AWS CLI para habilitar o Multi-AZ para o grupo de replicação `redis12`.
**Importante**
O grupo de replicação `redis12` já deve existir e ter pelo menos uma réplica de leitura disponível.
Para Linux, macOS ou Unix:
```
aws elasticache modify-replication-group \
--replication-group-id redis12 \
--automatic-failover-enabled \
--multi-az-enabled \
--apply-immediately
```
Para Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id redis12 ^
--automatic-failover-enabled ^
--multi-az-enabled ^
--apply-immediately
```
A saída JSON desse comando deve ser semelhante ao seguinte.
```
{
"ReplicationGroup": {
"Status": "modifying",
"Description": "One shard, two nodes",
"NodeGroups": [
{
"Status": "modifying",
"NodeGroupMembers": [
{
"CurrentRole": "primary",
"PreferredAvailabilityZone": "us-west-2b",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis12-001.v5r9dc.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis12-001"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2a",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis12-002.v5r9dc.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis12-002"
}
],
"NodeGroupId": "0001",
"PrimaryEndpoint": {
"Port": 6379,
"Address": "redis12.v5r9dc.ng.0001.usw2.cache.amazonaws.com"
}
}
],
"ReplicationGroupId": "redis12",
"SnapshotRetentionLimit": 1,
"AutomaticFailover": "enabling",
"MultiAZ": "enabled",
"SnapshotWindow": "07:00-08:00",
"SnapshottingClusterId": "redis12-002",
"MemberClusters": [
"redis12-001",
"redis12-002"
],
"PendingModifiedValues": {}
}
}
```
Para obter mais informações, consulte estes tópicos na *AWS CLI Referência de comandos*:
+ [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html)
+ [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)
+ [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) na *AWS CLI Referência de comandos.*
### Habilitação do multi-AZ (API do ElastiCache)
O exemplo de código a seguir usa a API do ElastiCache para habilitar o multi-AZ para o grupo de replicação `redis12`.
**nota**
Para usar esse exemplo, o grupo de replicação `redis12` já deve existir e ter pelo menos uma réplica de leitura disponível.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=ModifyReplicationGroup
&ApplyImmediately=true
&AutoFailover=true
&MultiAZEnabled=true
&ReplicationGroupId=redis12
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20140401T192317Z
&X-Amz-Credential=
```
Para obter mais informações, veja estes tópicos na *Referência da API do ElastiCache*:
+ [CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html)
+ [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)
## Cenários de falha com respostas do multi-AZ
Antes da introdução do multi-AZ, o ElastiCache detectava e substituía os nós com falha de um cluster recriando e reprovisionando esses nós. Se você habilitar o Multi-AZ, um nó primário com falha fará failover para a réplica com o menor atraso de replicação. A réplica selecionada é promovida automaticamente para primário, o que é muito mais rápido do que criar e reprovisionar um novo nó primário. Esse processo normalmente demora apenas alguns segundos até que você possa gravar novamente no cluster.
Quando o multi-AZ está habilitado, o ElastiCache monitora continuamente o estado do nó primário. Se o nó primário falhar, uma das seguintes ações será realizada, dependendo do tipo da falha.
**Topics**
+ [Cenários de falha quando somente o nó primário falha](#AutoFailover.Scenarios.PrimaryOnly)
+ [Cenários de falha quando o nó primário e algumas réplicas de leitura falham](#AutoFailover.Scenarios.PrimaryAndReplicas)
+ [Cenários de falha quando cluster inteiro falha](#AutoFailover.Scenarios.AllFail)
### Cenários de falha quando somente o nó primário falha
Se somente o nó primário falhar, a réplica de leitura com o menor atraso de replicação será promovida a primária. Depois disso, uma réplica de leitura de substituição é criada e provisionada na mesma zona de disponibilidade que o primário com falha.
Quando somente o nó primário falha, o recurso multi-AZ do ElastiCache faz o seguinte:
1. O nó primário com falha é colocado offline.
1. A réplica de leitura com o menor atraso de replicação é promovida a primário.
As gravações poderão ser retomadas assim que o processo de promoção estiver concluído, normalmente depois de apenas alguns segundos. Se a sua aplicação estiver gravando no endpoint primário, não será necessário alterar o endpoint para gravações ou leituras. O ElastiCache propaga o nome do DNS da réplica promovida.
1. Uma réplica de leitura de substituição é executada e provisionada.
A réplica de leitura de substituição é executada na Zona de disponibilidade em que o nó primário com falha se encontrava, para que a distribuição de nós seja mantida.
1. As réplicas são sincronizadas com o novo nó primário.
Depois que a nova réplica estiver disponível, lembre-se dos seguintes efeitos:
+ **Endpoint primário**: não faça alterações na sua aplicação, pois o nome do DNS do novo nó primário é propagado para o endpoint primário.
+ **Endpoint leitor**: o endpoint leitor é atualizado automaticamente para apontar para os novos nós de réplica.
Para obter informações sobre como encontrar os endpoints de um cluster, consulte os seguintes tópicos:
+ [Localização de endpoints de um cluster do Valkey ou do Redis OSS (modo cluster desabilitado) (console)](Endpoints.md#Endpoints.Find.Redis)
+ [Localização de endpoints para grupos de replicação do Valkey ou Redis OSS (AWS CLI)](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Localização de endpoints para grupos de replicação do Valkey ou Redis OSS (API do ElastiCache)](Endpoints.md#Endpoints.Find.API.ReplGroups)
### Cenários de falha quando o nó primário e algumas réplicas de leitura falham
Se o primário e pelo menos uma réplica de leitura falhar, a réplica disponível com o menor atraso de replicação será promovida a cluster primário. Novas réplicas de leitura também são criadas e provisionadas nas mesmas Zonas de disponibilidade que os nós com falha e a réplica que foi promovida a primário.
Quando o nó primário e algumas réplicas de leitura falham, o multi-AZ do ElastiCache faz o seguinte:
1. O nó primário com falha e as réplicas de leitura com falha são colocadas offline.
1. A réplica disponível com o menor atraso de replicação é promovida a nó primário.
As gravações poderão ser retomadas assim que o processo de promoção estiver concluído, normalmente depois de apenas alguns segundos. Se a sua aplicação estiver gravando no endpoint primário, não será necessário alterar o endpoint para gravações. O ElastiCache propaga o nome do DNS da réplica promovida.
1. Réplicas de substituição são criadas e provisionadas.
As réplicas de substituição são criadas nas Zonas de disponibilidade dos nós com falha, de modo que a distribuição de nós seja mantida.
1. Todos os clusters são sincronizados com o novo nó primário.
Faça as seguintes alterações no seu aplicativo depois que os novos nós estiverem disponíveis:
+ **Endpoint primário**: não faça alterações em sua aplicação. O nome de DNS do novo nó primário é propagado para o endpoint primário.
+ **Endpoint leitor**: o endpoint leitor é atualizado automaticamente para apontar para os novos nós de réplica.
Para obter informações sobre como encontrar os endpoints de um grupo de replicação, consulte os seguintes tópicos:
+ [Localização de endpoints de um cluster do Valkey ou do Redis OSS (modo cluster desabilitado) (console)](Endpoints.md#Endpoints.Find.Redis)
+ [Localização de endpoints para grupos de replicação do Valkey ou Redis OSS (AWS CLI)](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Localização de endpoints para grupos de replicação do Valkey ou Redis OSS (API do ElastiCache)](Endpoints.md#Endpoints.Find.API.ReplGroups)
### Cenários de falha quando cluster inteiro falha
Se tudo falhar, todos os nós serão recriados e provisionados nas mesmas Zonas de disponibilidade que os nós originais.
Nesse cenário, todos os dados do cluster são perdidos devido à falha de cada nó no cluster. Essa ocorrência é rara.
Quando o cluster inteiro falha, o multi-AZ do ElastiCache faz o seguinte:
1. O nó primário e as réplicas de leitura com falha são colocados offline.
1. Um nó primário de substituição é criado e provisionado.
1. Réplicas de substituição são criadas e provisionadas.
As substituição são criadas nas Zonas de disponibilidade dos nós com falha, de modo que a distribuição de nós seja mantida.
Como o cluster inteiro falhou, os dados são perdidos, e todos os novos nós são iniciados a frio.
Como cada um dos nós de substituição tem o mesmo endpoint que o nó que ele está substituindo, não é necessário fazer alterações de endpoint no seu aplicativo.
Para obter informações sobre como encontrar os endpoints de um grupo de replicação, consulte os seguintes tópicos:
+ [Localização de endpoints de um cluster do Valkey ou do Redis OSS (modo cluster desabilitado) (console)](Endpoints.md#Endpoints.Find.Redis)
+ [Localização de endpoints para grupos de replicação do Valkey ou Redis OSS (AWS CLI)](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Localização de endpoints para grupos de replicação do Valkey ou Redis OSS (API do ElastiCache)](Endpoints.md#Endpoints.Find.API.ReplGroups)
Recomendamos que você crie o nó primário e as réplicas de leitura em diferentes Zonas de disponibilidade para aumentar o nível de tolerância a falhas.
## Teste do failover automático
Depois de habilitar o failover automático, é possível testá-lo usando o console do ElastiCache, a AWS CLI e a API do ElastiCache.
Ao testar, observe o seguinte:
+ Você pode usar essa operação para testar o failover automático em até 15 fragmentos (chamados de grupos de nós na API do ElastiCache e na AWS CLI) em qualquer período contínuo de 24 horas.
+ Se você chamar essa operação em estilhaços em clusters diferentes (chamados grupos de replicação na API e CLI), poderá fazer as chamadas simultaneamente.
+ Em alguns casos, é possível chamar essa operação várias vezes em diferentes fragmentos no mesmo grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Nesses casos, a substituição do primeiro nó deve ser concluída antes que uma chamada subsequente possa ser feita.
+ Para determinar se a substituição do nó está completa, verifique os eventos usando o console do Amazon ElastiCache, a AWS CLI ou a API do ElastiCache. Procure pelos seguintes eventos relacionados ao failover automático, listados aqui em ordem de ocorrência:
1. Mensagem do grupo de replicação: `Test Failover API called for node group `
1. Mensagem do cluster de cache: `Failover from primary node to replica node completed`
1. Mensagem do grupo de replicação: `Failover from primary node to replica node completed`
1. Mensagem do cluster de cache: `Recovering cache nodes `
1. Mensagem do cluster de cache: `Finished recovery for cache nodes `
Para obter mais informações, consulte:
+ [Visualizando ElastiCache eventos](ECEvents.Viewing.md) no *Guia do usuário do ElastiCache*
+ [DescribeEvents](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html) na * Referência da API do ElastiCache*
+ [describe-events](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-events.html) na *AWS CLI Referência de comandos.*
+ Essa API foi projetada para testar o comportamento de sua aplicação em caso de failover do ElastiCache. Ela não foi projetado para ser uma ferramenta operacional para iniciar um failover a fim de resolver um problema com o cluster. Além disso, sob determinadas condições, como eventos operacionais de grande escala, a AWS pode bloquear essa API.
**Topics**
+ [Teste do failover automático usando o Console de gerenciamento da AWS](#auto-failover-test-con)
+ [Teste do failover automático usando o AWS CLI](#auto-failover-test-cli)
+ [Teste do failover automático usando a API do ElastiCache](#auto-failover-test-api)
### Teste do failover automático usando o Console de gerenciamento da AWS
Use o procedimento a seguir para testar o failover automático com o console.
**Para testar o failover automático**
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. No painel de navegação, escolha **Valkey** ou **Redis OSS**.
1. Na lista de clusters, escolha a caixa à esquerda do cluster que deseja testar. Esse cluster deve ter pelo menos um nó de réplica de leitura.
1. Na área **Details**, confirme se esse cluster está habilitado para Multi-AZ. Se o cluster não estiver habilitado para o Multi-AZ, escolha um cluster diferente ou modifique esse cluster para habilitar o Multi-AZ. Para obter mais informações, consulte [Uso do Console de gerenciamento da AWS do ElastiCache](Clusters.Modify.md#Clusters.Modify.CON).
![\[Imagem: área Detalhes de um cluster habilitado para Multi-AZ\]](http://docs.aws.amazon.com/pt_br/AmazonElastiCache/latest/dg/images/ElastiCache-AutoFailover-MultiAZ-Enabled.png)
1. Para o Valkey ou Redis OSS (modo cluster desabilitado), escolha o nome do cluster.
Para o Valkey ou Redis OSS (modo cluster habilitado), faça o seguinte:
1. Escolha o nome do cluster.
1. Na página **Shards**, para o estilhaço (chamado de grupo de nó na API e na CLI) no qual você deseja testar o failover, escolha o nome do estilhaço.
1. Na página Nodes, escolha **Failover Primary**.
1. Escolha **Continue** para fazer failover do primário ou **Cancel** para cancelar a operação e não fazer failover do nó primário.
Durante o processo de failover, o console continua a mostrar o status do nó como *disponível*. Para acompanhar o progresso do seu teste de failover, escolha **Events** no painel de navegação do console. Na guia **Eventos**, observe os eventos que indicam que o failover foi iniciado (`Test Failover API called`) e concluído (`Recovery completed`).
### Teste do failover automático usando o AWS CLI
É possível testar o failover automático em qualquer cluster habilitado para Multi-AZ usando a operação da AWS CLI `test-failover`.
**Parâmetros**
+ `--replication-group-id`: obrigatório. O grupo de replicação (no console, cluster) que deve ser testado.
+ `--node-group-id`: obrigatório. O nome do grupo de nós nos quais você deseja testar o failover automático. Você pode testar um máximo de 15 grupos de nós em um período contínuo de 24 horas.
O exemplo a seguir usa a AWS CLI para testar o failover automático no grupo de nós `redis00-0003` do cluster do Valkey ou Redis OSS (modo cluster habilitado) `redis00`.
**Example Teste de failover automático**
Para Linux, macOS ou Unix:
```
aws elasticache test-failover \
--replication-group-id redis00 \
--node-group-id redis00-0003
```
Para Windows:
```
aws elasticache test-failover ^
--replication-group-id redis00 ^
--node-group-id redis00-0003
```
A saída do comando precedente é semelhante ao seguinte.
```
{
"ReplicationGroup": {
"Status": "available",
"Description": "1 shard, 3 nodes (1 + 2 replicas)",
"NodeGroups": [
{
"Status": "available",
"NodeGroupMembers": [
{
"CurrentRole": "primary",
"PreferredAvailabilityZone": "us-west-2c",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis1x3-001.7ekv3t.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis1x3-001"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2a",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis1x3-002.7ekv3t.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis1x3-002"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2b",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis1x3-003.7ekv3t.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis1x3-003"
}
],
"NodeGroupId": "0001",
"PrimaryEndpoint": {
"Port": 6379,
"Address": "redis1x3.7ekv3t.ng.0001.usw2.cache.amazonaws.com"
}
}
],
"ClusterEnabled": false,
"ReplicationGroupId": "redis1x3",
"SnapshotRetentionLimit": 1,
"AutomaticFailover": "enabled",
"MultiAZ": "enabled",
"SnapshotWindow": "11:30-12:30",
"SnapshottingClusterId": "redis1x3-002",
"MemberClusters": [
"redis1x3-001",
"redis1x3-002",
"redis1x3-003"
],
"CacheNodeType": "cache.m3.medium",
"DataTiering": "disabled",
"PendingModifiedValues": {}
}
}
```
Para acompanhar o progresso do failover, use a operação da AWS CLI `describe-events`.
Para obter mais informações, consulte:
+ [test-failover](https://docs.aws.amazon.com/cli/latest/reference/elasticache/test-failover.html) na *AWS CLI Referência de comandos.*
+ [describe-events](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-events.html) na *AWS CLI Referência de comandos.*
### Teste do failover automático usando a API do ElastiCache
É possível testar o failover automático em qualquer cluster habilitado com multi-AZ usando a operação de API do ElastiCache `TestFailover`.
**Parâmetros**
+ `ReplicationGroupId`: obrigatório. O grupo de replicação (no console ou cluster) a ser testado.
+ `NodeGroupId`: obrigatório. O nome do grupo de nós nos quais você deseja testar o failover automático. Você pode testar um máximo de 15 grupos de nós em um período contínuo de 24 horas.
O exemplo a seguir testa o failover automático no grupo de nós `redis00-0003` no grupo de replicação (no console, cluster) `redis00`.
**Example Teste do failover automático**
```
https://elasticache.us-west-2.amazonaws.com/
?Action=TestFailover
&NodeGroupId=redis00-0003
&ReplicationGroupId=redis00
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20140401T192317Z
&X-Amz-Credential=
```
Para acompanhar o progresso do failover, use a operação de API do ElastiCache `DescribeEvents`.
Para obter mais informações, consulte:
+ [TestFailover](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_TestFailover.html) na *Referência da API do ElastiCache*
+ [DescribeEvents](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html) na *Referência da API do ElastiCache*
## Limitações no Multi-AZ
Esteja ciente das seguintes limitações para o Multi-AZ:
+ O Multi-AZ é compatível com Valkey e com Redis OSS versão 2.8.6 e posteriores.
+ O Multi-AZ não é aceito em tipos de nós T1.
+ A replicação do Valkey e Redis OSS é assíncrona. Portanto, quando um nó primário faz failover em uma réplica, uma pequena quantidade de dados pode ser perdida devido ao atraso da replicação.
Ao escolher a réplica a ser promovida a primária, o ElastiCache escolhe a réplica com o menor atraso de replicação. Em outras palavras, ele escolha a réplica que é mais atual. Isso ajuda a minimizar a quantidade de dados perdidos. A réplica com o atraso de replicação mínimo pode estar na mesma zona de disponibilidade ou em outra em relação ao nó primário com falha.
+ Ao promover manualmente réplicas de leitura para primárias em clusters do Valkey ou Redis OSS com o modo cluster desabilitado, você só poderá fazer isso quando o Multi-AZ e o failover automático estiverem desabilitados. Para promover uma réplica de leitura para primário, execute as seguintes etapas:
1. Desabilite o Multi-AZ no cluster.
1. Desabilite o failover automático no cluster. Isso pode ser feito por meio do console desmarcando a caixa de seleção **Failover automático** para o grupo de replicação. Também é possível fazer isso usando a AWS CLI definindo a propriedade `AutomaticFailoverEnabled` como `false` ao chamar a operação `ModifyReplicationGroup`.
1. Promova a réplica de leitura para primário.
1. Habilite novamente o Multi-AZ.
+ O multi-AZ do ElastiCache for Redis OSS e o arquivo somente de acréscimo (AOF) são mutuamente exclusivos. Se você habilitar um, não é possível habilitar o outro.
+ Uma falha de um nó pode ser causada pelo evento raro de falha total de uma zona de disponibilidade. Neste caso, a réplica que substitui o primário com falha é criada somente quando a zona de disponibilidade volta a ficar ativa. Por exemplo, considere um grupo de replicação com o primário em AZ-a e réplicas em AZ-b e AZ-c. Se o primário falhar, a réplica com o menor atraso de replicação será promovida a cluster primário. O ElastiCache criará uma nova réplica em AZ-a (onde o primário com falha estava localizado) somente quando AZ-a voltar a ficar ativa e disponível.
+ Uma reinicialização iniciada pelo cliente de um primário não aciona o failover automático. Outras reinicializações e falhas desencadeiam o failover automático.
+ Quando o primário é reiniciado, seus dados são limpos quando ele volta a ficar online. Quando as réplicas de leitura veem o cluster primário limpo, elas limpam suas cópias dos dados, o que causa perda de dados.
+ Depois que uma réplica de leitura foi promovida, as outras réplicas se sincronizam com o novo primário. Após a sincronização inicial, o conteúdo das réplicas é excluído, e eles sincronizam os dados do novo primário. Esse processo de sincronização causa uma breve interrupção, durante a qual as réplicas não são acessíveis. O processo de sincronização também causa um aumento de carga temporário no primário durante a sincronização com as réplicas. Esse comportamento é nativo do Valkey e do Redis OSS e não é exclusivo do Multi-AZ do ElastiCache. Para obter detalhes sobre esse comportamento, consulte [Replicação](http://valkey.io/topics/replication) no site do Valkey.
**Importante**
Para Valkey 7.2.6 e posterior ou Redis OSS versão 2.8.22 e posterior, não é possível criar réplicas externas.
Para versões do Redis OSS anteriores à 2.8.22, recomendamos que você não conecte uma réplica externa a um cluster do ElastiCache que esteja habilitado para Multi-AZ. Essa configuração sem suporte pode criar problemas que impedem que o ElastiCache realize corretamente o processo de failover e recuperação. Para conectar uma réplica externa a um cluster do ElastiCache, verifique se o multi-AZ não está habilitado antes de fazer a conexão.
# Como a sincronização e o backup são implementados
Todas as versões com suporte do Valkey ou Redis OSS oferecem suporte para backup e sincronização entre os nós primário e de réplica. No entanto, a forma como o backup e a sincronização são implementados varia de acordo com a versão.
## Redis OSS versão 2.8.22 e posterior
Para a replicação Redis OSS, nas versões 2.8.22 e posteriores, escolha um dos dois métodos de backup. Para obter mais informações, consulte [Versões do Redis OSS anteriores a 2.8.22](#Replication.Redis.Earlier2-8-22) e [Snapshots e restauração](backups.md).
Durante o processo sem permissão, se as cargas de gravação forem pesadas, as gravações no cluster serão atrasadas para garantir que você não acumule muitas mudanças e, assim, evite um snapshot bem-sucedido.
## Versões do Redis OSS anteriores a 2.8.22
O backup e a sincronização do Redis OSS nas versões anteriores a 2.8.22 é um processo de três etapas.
1. A bifurcação e, no processo em segundo plano, serializam os dados do cluster no disco. Isso cria um snapshot de ponto no tempo.
1. Em primeiro plano, acumule um log de alterações no *buffer de saída do cliente*.
**Importante**
Se o log de alterações exceder o tamanho do *buffer de saída do cliente*, o backup ou a sincronização falhará. Para obter mais informações, consulte [Garantir que você tem memória suficiente para criar um snapshot do Valkey ou Redis OSS](BestPractices.BGSAVE.md).
1. Por fim, transmita os dados do cache e, em seguida, o log de alterações para o nó de réplica.
# Criação de um grupo de replicação do Valkey ou Redis OSS
Você tem as seguintes opções para criar um cluster com nós de réplica. Uma delas se aplica quando você já tem um cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível não associado a nenhum cluster que possua réplicas a serem usadas como o nó primário. A outra é aplicada quando você precisa criar um nó primário com o cluster e as réplicas de leitura. Atualmente, um cluster do Valkey ou Redis OSS (modo cluster habilitado) deve ser criado do zero.
**Opção 1 1: [Criação de um grupo de replicação usando um cluster existente](Replication.CreatingReplGroup.ExistingCluster.md)**
Use essa opção para aproveitar um cluster de nó único já existente do Valkey ou Redis OSS (modo cluster desabilitado). Você especifica esse nó existente como o nó primário no novo cluster e, em seguida, adiciona individualmente de 1 a 5 réplicas de leitura ao cluster. Se o cluster existente estiver ativo, as réplicas de leitura serão sincronizadas com ele enquanto forem criadas. Consulte [Criação de um grupo de replicação usando um cluster existente](Replication.CreatingReplGroup.ExistingCluster.md).
Não é possível criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) usando um cluster existente. Para criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) (API/CLI: grupo de replicação) usando o console do ElastiCache, consulte [Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster).
**Opção 2 2: [Criação de um grupo de replicação do Valkey ou Redis OSS do início](Replication.CreatingReplGroup.NoExistingCluster.md)**
Use essa opção se você ainda não tiver um cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível a ser usado como nó primário do cluster, ou se quiser criar um cluster do Valkey ou Redis OSS (modo cluster habilitado). Consulte [Criação de um grupo de replicação do Valkey ou Redis OSS do início](Replication.CreatingReplGroup.NoExistingCluster.md).
# Criação de um grupo de replicação usando um cluster existente
O procedimento a seguir adiciona um grupo de replicação ao cluster de nó único do Valkey ou Redis OSS (modo cluster desabilitado). Ele é necessário para atualizar seu cluster para a versão mais recente do Valkey. Esse é um procedimento local que envolve zero tempo de inatividade e zero perda de dados. Quando você cria um grupo de replicação para seu cluster de nó único, o nó do cluster se torna o nó primário no novo cluster. Se você não tiver um cluster do Valkey ou Redis OSS (modo cluster desabilitado) que possa usar como primário do novo cluster, consulte [Criação de um grupo de replicação do Valkey ou Redis OSS do início](Replication.CreatingReplGroup.NoExistingCluster.md).
Um cluster disponível é um cluster do Valkey ou Redis OSS existente de um único nó. Atualmente, o Valkey ou o Redis OSS (modo cluster habilitado) não oferecem suporte para criar um cluster com réplicas usando um cluster de um único nó disponível. Se você quiser criar um cluster do Valkey ou Redis OSS (modo cluster habilitado), consulte [Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON).
## Criação de um grupo de replicação usando um cluster existente (console)
Consulte o tópico [Usando o ElastiCache Console de gerenciamento da AWS](Clusters.AddNode.md#Clusters.AddNode.CON).
## Criação de um grupo de replicação usando um cluster do Valkey ou Redis OSS disponível (AWS CLI)
Existem duas etapas para criar um grupo de replicação com réplicas de leitura ao usar um cluster de cache do Valkey ou Redis OSS disponível para o primário ao usar a AWS CLI.
Ao usar o,AWS CLI você cria um grupo de replicação especificando o nó autônomo disponível como o nó principal do cluster `--primary-cluster-id` e o número de nós que você deseja no cluster usando o comando CLI,. `create-replication-group` Inclua os seguintes parâmetros.
**--replication-group-id**
O nome do grupo de replicação que você está criando. O valor desse parâmetro é usado como a base para os nomes dos nós adicionados com um número sequencial de 3 dígitos acrescentados ao final de `--replication-group-id`. Por exemplo, .`sample-repl-group-001`
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) são as seguintes:
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.
**--replication-group-description**
Descrição do grupo de replicação.
**--num-node-groups**
O número de nós desejados neste cluster. Esse valor inclui o nó primário. Esse parâmetro tem um valor máximo de seis.
**--primary-cluster-id**
O nome do cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível que você deseja que seja o nó primário nesse grupo de replicação.
O comando a seguir cria o grupo de replicação `sample-repl-group` usando o cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível `redis01` como o nó primário do grupo de replicação. Ele cria 2 novos nós que são réplicas de leitura. As configurações de `redis01` (ou seja, grupo de parâmetros, grupo de segurança, tipo de nó, versão do mecanismo, etc.) serão aplicadas a todos os nós no grupo de replicações.
Para Linux, macOS ou Unix:
```
aws elasticache create-replication-group \
--replication-group-id sample-repl-group \
--replication-group-description "demo cluster with replicas" \
--num-cache-clusters 3 \
--primary-cluster-id redis01
```
Para Windows:
```
aws elasticache create-replication-group ^
--replication-group-id sample-repl-group ^
--replication-group-description "demo cluster with replicas" ^
--num-cache-clusters 3 ^
--primary-cluster-id redis01
```
Para obter informações e parâmetros adicionais que você talvez queira usar, consulte o AWS CLI tópico[create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).
**Em seguida, adicione réplicas de leitura ao grupo de replicação**
Após a criação do grupo de replicação, adicione de uma a cinco réplicas de leitura usando o comando `create-cache-cluster`, certificando-se de incluir os seguintes parâmetros.
**--cache-cluster-id**
O nome do cluster que você está adicionando ao grupo de replicação.
As restrições de nomenclatura de cluster são as seguintes:
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.
**--replication-group-id**
O nome do grupo de replicação ao qual você está adicionando esse cluster.
Repita esse comando para cada réplica de leitura que você deseja adicionar ao grupo de replicação, alterando apenas o valor do parâmetro `--cache-cluster-id`.
**nota**
Lembre-se de que um grupo de replicação não pode ter mais de cinco réplicas de leitura. Se você tentar adicionar uma réplica de leitura a um grupo de replicação que já possui cinco réplicas de leitura, a operação falhará.
O código a seguir adiciona a réplica de leitura `my-replica01` ao grupo de replicação `sample-repl-group`. As configurações do cluster primário (grupo de parâmetros, grupo de segurança, tipo de nó etc.) serão aplicadas aos nós como foram adicionadas ao grupo de replicação.
Para Linux, macOS ou Unix:
```
aws elasticache create-cache-cluster \
--cache-cluster-id my-replica01 \
--replication-group-id sample-repl-group
```
Para Windows:
```
aws elasticache create-cache-cluster ^
--cache-cluster-id my-replica01 ^
--replication-group-id sample-repl-group
```
A saída desse comando será semelhante a esta.
```
{
"ReplicationGroup": {
"Status": "creating",
"Description": "demo cluster with replicas",
"ClusterEnabled": false,
"ReplicationGroupId": "sample-repl-group",
"SnapshotRetentionLimit": 1,
"AutomaticFailover": "disabled",
"SnapshotWindow": "00:00-01:00",
"SnapshottingClusterId": "redis01",
"MemberClusters": [
"sample-repl-group-001",
"sample-repl-group-002",
"redis01"
],
"CacheNodeType": "cache.m4.large",
"DataTiering": "disabled",
"PendingModifiedValues": {}
}
}
```
Para obter informações adicionais, consulte os AWS CLI tópicos:
+ [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)
+ [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html)
## Adicionar réplicas a um cluster (API) autônomo Valkey ou Redis OSS (modo de cluster desativado) ElastiCache
Ao usar a ElastiCache API, você cria um grupo de replicação especificando o nó autônomo disponível como o nó principal do cluster `PrimaryClusterId` e o número de nós que você deseja no cluster usando o comando CLI,. `CreateReplicationGroup` Inclua os seguintes parâmetros.
**ReplicationGroupId**
O nome do grupo de replicação que você está criando. O valor desse parâmetro é usado como a base para os nomes dos nós adicionados com um número sequencial de 3 dígitos acrescentados ao final de `ReplicationGroupId`. Por exemplo, .`sample-repl-group-001`
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) são as seguintes:
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.
**ReplicationGroupDescription**
Descrição do cluster com réplicas.
**NumCacheClusters**
O número de nós desejados neste cluster. Esse valor inclui o nó primário. Esse parâmetro tem um valor máximo de seis.
**PrimaryClusterId**
O nome do cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível que você deseja que seja o nó primário nesse cluster.
O comando a seguir cria o cluster com réplicas `sample-repl-group` usando o cluster do Valkey ou Redis OSS (modo cluster desabilitado) disponível `redis01` como o nó primário do grupo de replicação. Ele cria 2 novos nós que são réplicas de leitura. As configurações de `redis01` (ou seja, grupo de parâmetros, grupo de segurança, tipo de nó, versão do mecanismo, etc.) serão aplicadas a todos os nós no grupo de replicações.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateReplicationGroup
&Engine=redis
&EngineVersion=6.0
&ReplicationGroupDescription=Demo%20cluster%20with%20replicas
&ReplicationGroupId=sample-repl-group
&PrimaryClusterId=redis01
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Para obter informações adicionais, consulte os tópicos do ElastiCache APL:
+ [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)
**Em seguida, adicione réplicas de leitura ao grupo de replicação**
Após a criação do grupo de replicação, adicione de uma a cinco réplicas de leitura usando a operação `CreateCacheCluster`, certificando-se de incluir os seguintes parâmetros.
**CacheClusterId**
O nome do cluster que você está adicionando ao grupo de replicação.
As restrições de nomenclatura de cluster são as seguintes:
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.
**ReplicationGroupId**
O nome do grupo de replicação ao qual você está adicionando esse cluster.
Repita essa operação para cada réplica de leitura que você deseja adicionar ao grupo de replicação, alterando apenas o valor do parâmetro `CacheClusterId`.
O código a seguir adiciona a réplica de leitura `myReplica01` ao grupo de replicação `myReplGroup`. As configurações do cluster primário (grupo de parâmetros, grupo de segurança, tipo de nó etc.) serão aplicadas a nós conforme eles forem adicionados ao grupo de replicação.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateCacheCluster
&CacheClusterId=myReplica01
&ReplicationGroupId=myReplGroup
&SignatureMethod=HmacSHA256
&SignatureVersion=4
&Version=2015-02-02
&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
&X-Amz-Credential=[your-access-key-id]/20150202/us-west-2/elasticache/aws4_request
&X-Amz-Date=20150202T170651Z
&X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
&X-Amz-Signature=[signature-value]
```
Para obter informações e parâmetros adicionais que você talvez queira usar, consulte o tópico ElastiCache da API[CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html).
# Criação de um grupo de replicação do Valkey ou Redis OSS do início
Veja a seguir como criar um grupo de replicação do Valkey ou Redis OSS sem usar um cluster do Valkey ou Redis OSS existente como primário. Você pode criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) ou do Valkey ou Redis OSS (modo cluster habilitado) do início usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache.
Antes de continuar, decida se deseja criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) ou do Valkey ou Redis OSS (modo cluster habilitado). Para obter orientação nessa decisão, consulte [Replicação: Modo de cluster Valkey e Redis OSS desativado versus ativado](Replication.Redis-RedisCluster.md).
**Topics**
+ [Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início](Replication.CreatingReplGroup.NoExistingCluster.Classic.md)
+ [Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md)
# Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início
Você pode criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) a partir do início usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache. Um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) sempre possui um grupo de nó, um cluster primário e até cinco réplicas de leitura. Os grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado) não são compatíveis com o particionamento dos seus dados.
**nota**
O limite de nó/fragmento pode ser aumentado para um máximo de 500 por cluster. Para solicitar um aumento de limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e inclua o tipo de instância na solicitação.
Para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início, siga uma das seguintes abordagens:
## Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início (AWS CLI)
O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) usando a AWS CLI.
Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para o comando `create-replication-group` da AWS CLI. Inclua os seguintes parâmetros.
**--replication-group-id**
O nome do grupo de replicação que você está criando.
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) são as seguintes:
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.
**--replication-group-description**
Descrição do grupo de replicação.
**--num-cache-clusters**
O número de nós que você deseja criar com esse grupo de replicação, com réplicas primárias e de leitura combinadas.
Se você habilitar o Multi-AZ (`--automatic-failover-enabled`), o valor de `--num-cache-clusters` deverá ser pelo menos 2.
**--cache-node-type**
O tipo de nó para cada nó no grupo de replicação.
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).
**--data-tiering-enabled**
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).
**--cache-parameter-group**
Especifique um grupo de parâmetros que corresponda à versão do seu mecanismo. Se estiver executando o Redis OSS 3.2.4 ou posterior, especifique o grupo de parâmetros `default.redis3.2` ou um grupo de parâmetros de `default.redis3.2` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado). Para obter mais informações, consulte [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis).
**--network-type**
`ipv4`, `ipv6` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como`ipv4` ou `ipv6`.
**--engine**
redis
**--engine-version**
Para ter o conjunto mais amplo de recursos, escolha a versão mais recente do mecanismo.
Os nomes dos nós serão derivados do nome do grupo de replicação depois de adicionar `-00`*\$1* ao nome do grupo de replicação. Por exemplo, usando o nome do grupo de replicação `myReplGroup`, o nome para o primário será `myReplGroup-001` e as réplicas de leitura `myReplGroup-002` e `myReplGroup-006`.
Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `--transit-encryption-enabled` ou `--at-rest-encryption-enabled` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `--cache-subnet-group`.
+ Você também deve incluir o parâmetro `--auth-token` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.
A seguinte operação cria um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) `sample-repl-group` com três nós, um primário e duas réplicas.
Para Linux, macOS ou Unix:
```
aws elasticache create-replication-group \
--replication-group-id sample-repl-group \
--replication-group-description "Demo cluster with replicas" \
--num-cache-clusters 3 \
--cache-node-type cache.m4.large \
--engine redis
```
Para Windows:
```
aws elasticache create-replication-group ^
--replication-group-id sample-repl-group ^
--replication-group-description "Demo cluster with replicas" ^
--num-cache-clusters 3 ^
--cache-node-type cache.m4.large ^
--engine redis
```
A saída desse comando é semelhante a esta.
```
{
"ReplicationGroup": {
"Status": "creating",
"Description": "Demo cluster with replicas",
"ClusterEnabled": false,
"ReplicationGroupId": "sample-repl-group",
"SnapshotRetentionLimit": 0,
"AutomaticFailover": "disabled",
"SnapshotWindow": "01:30-02:30",
"MemberClusters": [
"sample-repl-group-001",
"sample-repl-group-002",
"sample-repl-group-003"
],
"CacheNodeType": "cache.m4.large",
"DataTiering": "disabled",
"PendingModifiedValues": {}
}
}
```
Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico da AWS CLI [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).
## Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início (API do ElastiCache)
O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) usando a API do ElastiCache.
Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para a operação `CreateReplicationGroup` da API do ElastiCache. Inclua os seguintes parâmetros.
**ReplicationGroupId**
O nome do grupo de replicação que você está criando.
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) são as seguintes:
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.
**ReplicationGroupDescription**
Sua descrição do grupo de replicação.
**NumCacheClusters**
O número total de nós que você deseja criar com esse grupo de replicação, com réplicas primárias e de leitura combinadas.
Se você habilitar o Multi-AZ (`AutomaticFailoverEnabled=true`), o valor de `NumCacheClusters` deverá ser pelo menos 2.
**CacheNodeType**
O tipo de nó para cada nó no grupo de replicação.
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).
**--data-tiering-enabled**
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).
**CacheParameterGroup**
Especifique um grupo de parâmetros que corresponda à versão do seu mecanismo. Se estiver executando o Redis OSS 3.2.4 ou posterior, especifique o grupo de parâmetros `default.redis3.2` ou um grupo de parâmetros de `default.redis3.2` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado). Para obter mais informações, consulte [Parâmetros do Valkey e do Redis OSS](ParameterGroups.Engine.md#ParameterGroups.Redis).
**--network-type**
`ipv4`, `ipv` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como `ipv4` ou `ipv6`.
**Mecanismo**
redis
**EngineVersion**
6.0
Os nomes dos nós serão derivados do nome do grupo de replicação depois de adicionar `-00`*\$1* ao nome do grupo de replicação. Por exemplo, usando o nome do grupo de replicação `myReplGroup`, o nome para o primário será `myReplGroup-001` e as réplicas de leitura `myReplGroup-002` e `myReplGroup-006`.
Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `TransitEncryptionEnabled=true` ou `AtRestEncryptionEnabled=true` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `CacheSubnetGroup`.
+ Você também deve incluir o parâmetro `AuthToken` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.
A seguinte operação cria o grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) `myReplGroup` com três nós, um primário e duas réplicas.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateReplicationGroup
&CacheNodeType=cache.m4.large
&CacheParameterGroup=default.redis6.x
&Engine=redis
&EngineVersion=6.0
&NumCacheClusters=3
&ReplicationGroupDescription=test%20group
&ReplicationGroupId=myReplGroup
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico sobre a API do ElastiCache [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html).
# Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início
Você pode criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) (API/CLI: *grupo de replicação*) usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache. Um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) tem de 1 a 500 fragmentos (API/CLI: grupos de nós), um nó primário em cada fragmento e até 5 réplicas de leitura em cada fragmento. É possível criar um cluster com alto número de fragmentos e baixo número de réplicas totalizando até 90 nós por cluster. Essa configuração do cluster pode variar de 90 fragmentos e 0 réplicas para 15 fragmentos e 5 réplicas, que é o número máximo de réplicas permitidas.
O limite de nó ou fragmento pode ser aumentado para um máximo de 500 por cluster se a versão do mecanismo Valkey ou Redis OSS for 5.0.6 ou posterior. Por exemplo, você pode optar por configurar um cluster de 500 nós que varia entre 83 fragmentos (uma primária e 5 réplicas por fragmento) e 500 fragmentos (primário único e sem réplicas). Verifique se existem endereços IP disponíveis suficientes para acomodar o aumento. As armadilhas comuns incluem as sub-redes no grupo de sub-redes têm um intervalo CIDR muito pequeno ou as sub-redes são compartilhadas e fortemente usadas por outros clusters. Para obter mais informações, consulte [Criação de um grupo de sub-redes](SubnetGroups.Creating.md).
Para versões abaixo de 5.0.6, o limite é 250 por cluster.
Para solicitar um aumento de limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e selecione o tipo de limite **Nodes per cluster per instance type** (Nós por cluster por tipo de instância).
**Topics**
+ [Uso do console do ElastiCache](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON)
+ [Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início (AWS CLI)](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CLI)
+ [Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início (API do ElastiCache)](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.API)
## Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)
Para criar um cluster do Valkey ou Redis OSS (modo cluster habilitado), consulte [Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster). Certifique-se de habilitar o modo de cluster, **Cluster Mode enabled (Scale Out)**, e especifique pelo menos dois fragmentos e um nó de réplica em cada.
## Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início (AWS CLI)
O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) usando a AWS CLI.
Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para o comando `create-replication-group` da AWS CLI. Inclua os seguintes parâmetros.
**--replication-group-id**
O nome do grupo de replicação que você está criando.
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) são as seguintes:
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.
**--replication-group-description**
Descrição do grupo de replicação.
**--cache-node-type**
O tipo de nó para cada nó no grupo de replicação.
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).
**--data-tiering-enabled**
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).
**--cache-parameter-group**
Especifique o grupo de parâmetros `default.redis6.x.cluster.on` ou um grupo de parâmetros derivado de `default.redis6.x.cluster.on` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Para obter mais informações, consulte [Alterações de parâmetros do Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).
**--engine**
redis
**--engine-version**
3.2.4
**--num-node-groups**
O número de grupos de nós neste grupo de replicação. Os valores válidos são 1 a 500.
O limite de nó/fragmento pode ser aumentado para um máximo de 500 por cluster. Para solicitar um aumento do limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e selecione o tipo de limite "Nodes per cluster per instance type" (Nós por cluster por tipo de instância).
**--replicas-per-node-group**
O número de nós de réplica em cada grupo de nós. Os valores válidos são 0 a 5.
**--network-type**
`ipv4`, `ipv` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como `ipv4` ou `ipv6`.
Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `--transit-encryption-enabled` ou `--at-rest-encryption-enabled` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `--cache-subnet-group`.
+ Você também deve incluir o parâmetro `--auth-token` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.
A seguinte operação cria o grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) `sample-repl-group` com três grupos de nós/fragmentos (--num-node-groups), cada um com três nós, uma réplica primária e duas réplicas de leitura (--replicas-per-node-group).
Para Linux, macOS ou Unix:
```
aws elasticache create-replication-group \
--replication-group-id sample-repl-group \
--replication-group-description "Demo cluster with replicas" \
--num-node-groups 3 \
--replicas-per-node-group 2 \
--cache-node-type cache.m4.large \
--engine redis \
--security-group-ids SECURITY_GROUP_ID \
--cache-subnet-group-name SUBNET_GROUP_NAME>
```
Para Windows:
```
aws elasticache create-replication-group ^
--replication-group-id sample-repl-group ^
--replication-group-description "Demo cluster with replicas" ^
--num-node-groups 3 ^
--replicas-per-node-group 2 ^
--cache-node-type cache.m4.large ^
--engine redis ^
--security-group-ids SECURITY_GROUP_ID ^
--cache-subnet-group-name SUBNET_GROUP_NAME>
```
O comando anterior gera a seguinte saída.
```
{
"ReplicationGroup": {
"Status": "creating",
"Description": "Demo cluster with replicas",
"ReplicationGroupId": "sample-repl-group",
"SnapshotRetentionLimit": 0,
"AutomaticFailover": "enabled",
"SnapshotWindow": "05:30-06:30",
"MemberClusters": [
"sample-repl-group-0001-001",
"sample-repl-group-0001-002",
"sample-repl-group-0001-003",
"sample-repl-group-0002-001",
"sample-repl-group-0002-002",
"sample-repl-group-0002-003",
"sample-repl-group-0003-001",
"sample-repl-group-0003-002",
"sample-repl-group-0003-003"
],
"PendingModifiedValues": {}
}
}
```
Quando você cria um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início, você pode configurar cada fragmento do cluster usando o parâmetro `--node-group-configuration`, como mostra o exemplo a seguir, que configura dois grupos de nós (console: fragmentos). O primeiro fragmento tem dois nós: um primário e uma réplica de leitura. O segundo fragmento tem três nós: um primário e duas réplicas de leitura.
**--node-group-configuration**
A configuração para cada grupo de nós. O parâmetro `--node-group-configuration` consiste nos seguintes campos.
+ `PrimaryAvailabilityZone`: a zona de disponibilidade onde o nó primário desse grupo de nós está localizado. Se esse parâmetro for omitido, o ElastiCache escolherá a zona de disponibilidade para o nó primário.
**Exemplo:** us-west-2a.
+ `ReplicaAvailabilityZones`: uma lista separada por vírgulas de zonas de disponibilidade em que as réplicas de leitura estão localizadas. O número de Zonas de disponibilidade nessa lista deve corresponder ao valor de `ReplicaCount`. Se esse parâmetro for omitido, o ElastiCache escolherá as zonas de disponibilidade para os nós de réplica.
**Exemplo:** "us-west-2a,us-west-2b,us-west-2c"
+ `ReplicaCount`: o número de nós de réplica nesse grupo de nós.
+ `Slots`: uma string que especifica o espaço de chaves para o grupo de nós. A string está no formato `startKey-endKey`. Se esse parâmetro for omitido, o ElastiCache alocará as chaves igualmente entre os grupos de nós.
**Exemplo:** "0-4999"
A operação a seguir cria o grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) `new-group` com dois grupos de nós/fragmentos (`--num-node-groups`). Ao contrário do exemplo anterior, cada grupo de nós está configurado de forma diferente do outro grupo de nós (`--node-group-configuration`).
Para Linux, macOS ou Unix:
```
aws elasticache create-replication-group \
--replication-group-id new-group \
--replication-group-description "Sharded replication group" \
--engine redis \
--snapshot-retention-limit 8 \
--cache-node-type cache.m4.medium \
--num-node-groups 2 \
--node-group-configuration \
"ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
"ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"
```
Para Windows:
```
aws elasticache create-replication-group ^
--replication-group-id new-group ^
--replication-group-description "Sharded replication group" ^
--engine redis ^
--snapshot-retention-limit 8 ^
--cache-node-type cache.m4.medium ^
--num-node-groups 2 ^
--node-group-configuration \
"ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
"ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"
```
A operação anterior gera a seguinte saída.
```
{
"ReplicationGroup": {
"Status": "creating",
"Description": "Sharded replication group",
"ReplicationGroupId": "rc-rg",
"SnapshotRetentionLimit": 8,
"AutomaticFailover": "enabled",
"SnapshotWindow": "10:00-11:00",
"MemberClusters": [
"rc-rg-0001-001",
"rc-rg-0001-002",
"rc-rg-0002-001",
"rc-rg-0002-002",
"rc-rg-0002-003"
],
"PendingModifiedValues": {}
}
}
```
Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico sobre a AWS CLI [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).
## Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início (API do ElastiCache)
O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) usando a API do ElastiCache.
Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para a operação `CreateReplicationGroup` da API do ElastiCache. Inclua os seguintes parâmetros.
**ReplicationGroupId**
O nome do grupo de replicação que você está criando.
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) são as seguintes:
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.
**ReplicationGroupDescription**
Descrição do grupo de replicação.
**NumNodeGroups**
O número de grupos de nós que você deseja criar com esse grupo de replicação. Os valores válidos são 1 a 500.
**ReplicasPerNodeGroup**
O número de nós de réplica em cada grupo de nós. Os valores válidos são 1 a 5.
**NodeGroupConfiguration**
A configuração para cada grupo de nós. O parâmetro `NodeGroupConfiguration` consiste nos seguintes campos.
+ `PrimaryAvailabilityZone`: a zona de disponibilidade onde o nó primário desse grupo de nós está localizado. Se esse parâmetro for omitido, o ElastiCache escolherá a zona de disponibilidade para o nó primário.
**Exemplo:** us-west-2a.
+ `ReplicaAvailabilityZones`: uma lista de zonas de disponibilidade em que as réplicas de leitura estão localizadas. O número de Zonas de disponibilidade nessa lista deve corresponder ao valor de `ReplicaCount`. Se esse parâmetro for omitido, o ElastiCache escolherá as zonas de disponibilidade para os nós de réplica.
+ `ReplicaCount`: o número de nós de réplica nesse grupo de nós.
+ `Slots`: uma string que especifica o espaço de chaves para o grupo de nós. A string está no formato `startKey-endKey`. Se esse parâmetro for omitido, o ElastiCache alocará as chaves igualmente entre os grupos de nós.
**Exemplo:** "0-4999"
**CacheNodeType**
O tipo de nó para cada nó no grupo de replicação.
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).
**--data-tiering-enabled**
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).
**CacheParameterGroup**
Especifique o grupo de parâmetros `default.redis6.x.cluster.on` ou um grupo de parâmetros derivado de `default.redis6.x.cluster.on` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Para obter mais informações, consulte [Alterações de parâmetros do Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).
**--network-type**
`ipv4`, `ipv` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como `ipv4` ou `ipv6`.
**Mecanismo**
redis
**EngineVersion**
6.0
Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `TransitEncryptionEnabled=true` ou `AtRestEncryptionEnabled=true` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `CacheSubnetGroup`.
+ Você também deve incluir o parâmetro `AuthToken` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.
As quebras de linha foram adicionadas para legibilidade.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateReplicationGroup
&CacheNodeType=cache.m4.large
&CacheParemeterGroup=default.redis6.xcluster.on
&Engine=redis
&EngineVersion=6.0
&NumNodeGroups=3
&ReplicasPerNodeGroup=2
&ReplicationGroupDescription=test%20group
&ReplicationGroupId=myReplGroup
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico sobre a API do ElastiCache [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html).
# Visualização dos detalhes de um grupo de replicação
Há momentos em que você pode querer visualizar os detalhes de um grupo de replicação. Você pode usar o console do ElastiCache, a AWS CLI para o ElastiCache ou a API do ElastiCache. O processo do console é diferente para Valkey ou Redis OSS (modo cluster desabilitado) e Valkey ou Redis OSS (modo cluster habilitado).
**Contents**
+ [Visualização de um Valkey ou Redis OSS (modo cluster desabilitado) com réplicas](Replication.ViewDetails.Redis.md)
+ [Uso do console do ElastiCache](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.CON)
+ [Como usar o AWS CLI](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.CLI)
+ [Uso da API do ElastiCache](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.API)
+ [Visualização de um grupo de replicação: Valkey ou Redis OSS (modo cluster habilitado)](Replication.ViewDetails.RedisCluster.md)
+ [Uso do console do ElastiCache](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.CON)
+ [Como usar o AWS CLI](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.CLI)
+ [Uso da API do ElastiCache](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.API)
+ [Visualização dos detalhes de um grupo de replicação (AWS CLI)](Replication.ViewDetails.CLI.md)
+ [Visualização dos detalhes de um grupo de replicação (API do ElastiCache)](Replication.ViewDetails.API.md)
# Visualização de um Valkey ou Redis OSS (modo cluster desabilitado) com réplicas
Você pode visualizar os detalhes de um cluster do Valkey ou Redis OSS (modo cluster desabilitado) com réplicas (API/CLI: *grupo de replicação*) usando o console do ElastiCache, a AWS CLI para o ElastiCache ou a API do ElastiCache.
**Contents**
+ [Uso do console do ElastiCache](#Replication.ViewDetails.Redis.CON)
+ [Como usar o AWS CLI](#Replication.ViewDetails.Redis.CLI)
+ [Uso da API do ElastiCache](#Replication.ViewDetails.Redis.API)
## Visualização de detalhes de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) (console)
Para ver os detalhes de um cluster do Valkey ou Redis OSS (modo cluster desabilitado) com réplicas usando o console do ElastiCache, consulte o tópico [Visualização dos detalhes do Valkey ou Redis OSS (modo cluster desabilitado) (console)](Clusters.ViewDetails.md#Clusters.ViewDetails.CON.Redis).
## Visualização de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) (AWS CLI)
Para um exemplo de AWS CLI que exibe os detalhes de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado), consulte [Visualização dos detalhes de um grupo de replicação (AWS CLI)](Replication.ViewDetails.CLI.md).
## Visualização de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) (API do ElastiCache)
Para um exemplo da API do ElastiCache que exibe os detalhes de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado), consulte [Visualização dos detalhes de um grupo de replicação (API do ElastiCache)](Replication.ViewDetails.API.md).
# Visualização de um grupo de replicação: Valkey ou Redis OSS (modo cluster habilitado)
## Visualização de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)
Para ver os detalhes de um cluster do Valkey ou Redis OSS (modo cluster habilitado) usando o console do ElastiCache, consulte [Visualização de detalhes de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)](Clusters.ViewDetails.md#Clusters.ViewDetails.CON.RedisCluster).
## Visualização de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (AWS CLI)
Para um exemplo da CLI do ElastiCache que exibe os detalhes de um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado), consulte [Visualização dos detalhes de um grupo de replicação (AWS CLI)](Replication.ViewDetails.CLI.md).
## Visualização de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (API do ElastiCache)
Para um exemplo da API do ElastiCache que exibe os detalhes de um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado), consulte [Visualização dos detalhes de um grupo de replicação (API do ElastiCache)](Replication.ViewDetails.API.md).
# Visualização dos detalhes de um grupo de replicação (AWS CLI)
É possível visualizar os detalhes de um grupo detalhes replicação usando o comando AWS CLI da `describe-replication-groups`. Use os seguintes parâmetros opcionais para refinar a listagem. A omissão dos parâmetros retorna os detalhes de até 100 grupos de replicação.
**Parâmetros opcionais**
+ `--replication-group-id`: use este parâmetro para listar os detalhes de um grupo de replicação específico. Se o grupo de replicação especificado tiver mais de um grupo de nós, os resultados serão retornados agrupados por grupo de nós.
+ `--max-items`: use este parâmetro para limitar o número de grupos de replicação listados. O valor de `--max-items` não pode ser inferior a 20 ou superior a 100.
**Example**
O código a seguir lista os detalhes para até 100 grupos de replicação.
```
aws elasticache describe-replication-groups
```
O código a seguir lista os detalhes para `sample-repl-group`.
```
aws elasticache describe-replication-groups --replication-group-id sample-repl-group
```
O código a seguir lista os detalhes para `sample-repl-group`.
```
aws elasticache describe-replication-groups --replication-group-id sample-repl-group
```
O código a seguir lista os detalhes para até 25 grupos de replicação.
```
aws elasticache describe-replication-groups --max-items 25
```
O resultado dessa operação deve ser semelhante a este (formato JSON).
```
{
"ReplicationGroups": [
{
"Status": "available",
"Description": "test",
"NodeGroups": [
{
"Status": "available",
"NodeGroupMembers": [
{
"CurrentRole": "primary",
"PreferredAvailabilityZone": "us-west-2a",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "rg-name-001.1abc4d.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "rg-name-001"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2b",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "rg-name-002.1abc4d.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "rg-name-002"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2c",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "rg-name-003.1abc4d.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "rg-name-003"
}
],
"NodeGroupId": "0001",
"PrimaryEndpoint": {
"Port": 6379,
"Address": "rg-name.1abc4d.ng.0001.usw2.cache.amazonaws.com"
}
}
],
"ReplicationGroupId": "rg-name",
"AutomaticFailover": "enabled",
"SnapshottingClusterId": "rg-name-002",
"MemberClusters": [
"rg-name-001",
"rg-name-002",
"rg-name-003"
],
"PendingModifiedValues": {}
},
{
... some output omitted for brevity
}
]
}
```
Para obter mais informações, consulte a AWS CLI para o tópico do ElastiCache [describe-replication-groups](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-replication-groups.html).
# Visualização dos detalhes de um grupo de replicação (API do ElastiCache)
Você pode visualizar os detalhes de uma replicação usando a operação AWS CLI `DescribeReplicationGroups`. Use os seguintes parâmetros opcionais para refinar a listagem. A omissão dos parâmetros retorna os detalhes de até 100 grupos de replicação.
**Parâmetros opcionais**
+ `ReplicationGroupId`: use este parâmetro para listar os detalhes de um grupo de replicação específico. Se o grupo de replicação especificado tiver mais de um grupo de nós, os resultados serão retornados agrupados por grupo de nós.
+ `MaxRecords`: use este parâmetro para limitar o número de grupos de replicação listados. O valor de `MaxRecords` não pode ser inferior a 20 ou superior a 100. O padrão é 100.
**Example**
O código a seguir lista os detalhes para até 100 grupos de replicação.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DescribeReplicationGroups
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
O código a seguir lista os detalhes para `myReplGroup`.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DescribeReplicationGroups
&ReplicationGroupId=myReplGroup
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
O código a seguir lista os detalhes para até 25 clusters.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DescribeReplicationGroups
&MaxRecords=25
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Para obter mais informações, consulte o tópico de referência da API do ElastiCache [DescribeReplicationGroups](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeReplicationGroups.html).
# Localização de endpoints de grupo de replicação
Um aplicativo pode se conectar a qualquer nó em um grupo de replicação, desde que tenha o endpoint DNS e o número da porta desse nó. Dependendo de você estar executando um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) ou do Valkey ou Redis OSS (modo cluster habilitado), você estará interessado em diferentes endpoints.
**Valkey ou Redis OSS (modo cluster desabilitado)**
Os clusters Valkey ou Redis OSS (modo cluster desabilitado) com réplicas têm três tipos de endpoints: o *endpoint primário*, o *endpoint leitor* e os *endpoints de nó*. O endpoint primário é um nome DNS que sempre é resolvido para o nó primário no cluster. O endpoint primário é imune às alterações no seu cluster, como promover uma réplica de leitura para a função primária. Para atividades de gravação, recomendamos que suas aplicações se conectem ao endpoint primário.
Um endpoint de leitor divide uniformemente as conexões de entrada no endpoint entre todas as réplicas de leitura em um cluster do ElastiCache. Fatores adicionais, como quando o aplicativo cria as conexões ou como o aplicativo (re)usa as conexões determinarão a distribuição do tráfego. Os endpoints de leitor acompanham as alterações do cluster em tempo real à medida que réplicas são adicionadas ou removidas. Você pode colocar várias réplicas de leitura do seu cluster do ElastiCache para Redis OSS em diferentes zonas de disponibilidade da AWS (AZ) para garantir a alta disponibilidade dos endpoints leitores.
**nota**
Um endpoint leitor não é um balanceador de carga. É um registro DNS que vai resolver para um endereço IP de um dos nós de réplica em uma forma round robin.
Para atividades de leitura, os aplicativos também podem se conectar a qualquer nó no cluster. Ao contrário do endpoint primário, endpoints de nó são resolvidos para endpoints específicos. Se você fizer uma alteração no cluster, como adicionar ou excluir uma réplica, deverá atualizar os endpoints de nó no seu aplicativo.
**Valkey ou Redis OSS (modo cluster habilitado)**
Clusters do Valkey ou Redis OSS (modo cluster habilitado) com réplicas, como eles têm vários fragmentos (API/CLI: grupos de nós), o que significa que também possuem vários nós primários, possuem uma estrutura de endpoint diferente dos clusters do Valkey ou Redis OSS (modo cluster desabilitado). O Valkey ou Redis OSS (modo cluster habilitado) tem um *endpoint de configuração* que "conhece" todos os endpoints primários e de nó no cluster. Seu aplicativo conecta-se ao endpoint de configuração. Sempre que seu aplicativo grava ou lê no/do endpoint de configuração do cluster, o Valkey ou Redis OSS, nos bastidores, determina a qual fragmento a chave pertence e qual endpoint nesse fragmento deve ser usado. O processo é bastante transparente para o seu aplicativo.
Você pode localizar os endpoints de um cluster usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache.
**Localizar endpoints de grupo de replicação**
Para localizar os endpoints do seu grupo de replicação, consulte um dos seguintes tópicos:
+ [Localização de endpoints de um cluster do Valkey ou do Redis OSS (modo cluster desabilitado) (console)](Endpoints.md#Endpoints.Find.Redis)
+ [Localização de endpoints para um cluster do Valkey ou do Redis OSS (modo cluster habilitado) (console)](Endpoints.md#Endpoints.Find.RedisCluster)
+ [Localização de endpoints para grupos de replicação do Valkey ou Redis OSS (AWS CLI)](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Localização de endpoints para grupos de replicação do Valkey ou Redis OSS (API do ElastiCache)](Endpoints.md#Endpoints.Find.API.ReplGroups)
# Modificação de um grupo de replicação
**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
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
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 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=
&X-Amz-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).
# Exclusão de um grupo de replicação
Se você não precisar mais de um dos seus clusters com réplicas (chamados de *grupos de replicação* na API/CLI), poderá excluí-lo. Quando você exclui um grupo de replicação, o ElastiCache exclui todos os nós nesse grupo.
Depois de ter iniciado essa operação, ela não poderá ser interrompida ou cancelada.
**Atenção**
Ao excluir um cluster do ElastiCache for Redis OSS, seus snapshots manuais são retidos. Você também poderá criar um snapshot final antes da exclusão do cluster. Os snapshots de cache automáticos não são retidos.
É necessário ter a permissão `CreateSnapshot` para criar um snapshot final. Sem essa permissão, a chamada de API falhará com uma exceção `Access Denied`.
## Exclusão de um grupo de replicação (Console)
Para excluir um cluster que possui réplicas, consulte [Excluindo um cluster no ElastiCache](Clusters.Delete.md).
## Excluir um grupo de replicação (AWS CLI)
Use o comando [delete-replication-group](https://docs.aws.amazon.com/AmazonElastiCache/latest/CommandLineReference/CLIReference-cmd-DeleteReplicationGroup.html) para excluir um grupo de replicação.
```
aws elasticache delete-replication-group --replication-group-id my-repgroup
```
Um prompt solicita que você confirme sua decisão. Insira *y* (sim) para iniciar a operação imediatamente. Após o início do processo, ele é irreversível.
```
After you begin deleting this replication group, all of its nodes will be deleted as well.
Are you sure you want to delete this replication group? [Ny]y
REPLICATIONGROUP my-repgroup My replication group deleting
```
## Exclusão de um grupo de replicação (API do ElastiCache)
Chame [DeleteReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DeleteReplicationGroup.html) com o parâmetro `ReplicationGroup`.
**Example**
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DeleteReplicationGroup
&ReplicationGroupId=my-repgroup
&Version=2014-12-01
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20141201T220302Z
&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
&X-Amz-Date=20141201T220302Z
&X-Amz-SignedHeaders=Host
&X-Amz-Expires=20141201T220302Z
&X-Amz-Credential=
&X-Amz-Signature=
```
**nota**
Se você definir o parâmetro `RetainPrimaryCluster` como `true`, todas as réplicas de leitura serão excluídas, mas o cluster primário será mantido.
# Alteração do número de réplicas
Você pode aumentar ou diminuir dinamicamente o número de réplicas de leitura no grupo de replicação do Valkey ou Redis OSS usando o Console de gerenciamento da AWS, a AWS CLI ou a API do ElastiCache. Caso seu grupo de replicação seja um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado), você pode escolher de quais fragmentos (grupos de nós) aumentar ou diminuir o número de réplicas.
Para alterar dinamicamente o número de réplicas no grupo de replicação, escolha a operação na tabela a seguir que se adapte à situação.
| Para fazer isso | Para Valkey ou Redis OSS (modo cluster habilitado) | Para Valkey ou Redis OSS (modo cluster desabilitado) |
| --- | --- | --- |
| Adicionar réplicas | [Aumento do número de réplicas em um fragmento](increase-replica-count.md) | [Aumento do número de réplicas em um fragmento](increase-replica-count.md) [Adição de uma réplica de leitura do Valkey ou do Redis OSS (modo cluster desabilitado)](Replication.AddReadReplica.md) |
| Excluir réplicas | [Diminuição do número de réplicas em um fragmento](decrease-replica-count.md) | [Diminuição do número de réplicas em um fragmento](decrease-replica-count.md) [Exclusão de uma réplica de leitura do Valkey ou do Redis OSS (modo cluster desabilitado)](Replication.RemoveReadReplica.md) |
# Aumento do número de réplicas em um fragmento
Você pode aumentar o número de réplicas em um fragmento do Valkey ou Redis OSS (modo cluster habilitado) ou grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) até um máximo de cinco. Você pode fazer isso usando o Console de gerenciamento da AWS, a AWS CLI ou a API do ElastiCache.
**Topics**
+ [Utilização do Console de gerenciamento da AWS](#increase-replica-count-con)
+ [Como usar o AWS CLI](#increase-replica-count-cli)
+ [Uso da API do ElastiCache](#increase-replica-count-api)
## Utilização do Console de gerenciamento da AWS
O procedimento a seguir usa o console para aumentar o número de réplicas em um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado).
**Para aumentar o número de réplicas em fragmentos**
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. No painel de navegação, escolha **Valkey** ou **Redis OSS** e o nome do grupo de replicação ao qual você deseja adicionar réplicas.
1. Escolha a caixa de cada estilhaço a que você deseja adicionar réplicas.
1. Escolha **Add replicas (Adicionar réplicas)**.
1. Conclua a página **Add Replicas to Shards (Adicionar réplicas a estilhaços)**:
+ Em **New number of replicas/shard (Novo número de réplicas/estilhaço)**, informe o número de réplicas que todos os estilhaços selecionados devem ter. Esse valor deve ser maior que ou igual a **Current Number of Replicas per shard (Número atual de réplicas por estilhaço)** e menor que ou igual a cinco. Recomendamos pelo menos duas réplicas para trabalho mínimo.
+ Em **Availability Zones** (Zonas de disponibilidade), escolha **No preference** (Sem preferência) para o ElastiCache escolher uma zona de disponibilidade para cada nova réplica, ou **Specify Availability Zones** (Especificar zonas de disponibilidade) a fim de escolher uma zona de disponibilidade para cada nova réplica.
Caso você escolha **Specify Availability Zones (Especificar zonas de disponibilidade)**, para cada nova réplica, especifique uma zona de disponibilidade usando a lista.
1. Escolha **Add (Adicionar)** a fim de adicionar as réplicas ou **Cancel (Cancelar)** a fim de cancelar a operação.
## Como usar o AWS CLI
Para aumentar o número de réplicas em um fragmento do Valkey ou Redis OSS, use o comando `increase-replica-count` com os seguintes parâmetros:
+ `--replication-group-id`: obrigatório. Identifica em qual grupo de replicação você deseja aumentar o número de réplicas.
+ `--apply-immediately` ou `--no-apply-immediately`: obrigatório. Especifica se é necessário aumentar a contagem de réplicas imediatamente (`--apply-immediately`) ou na próxima janela de manutenção (`--no-apply-immediately`). Atualmente, `--no-apply-immediately` não é suportado.
+ `--new-replica-count`: opcional. Especifica o número de nós de réplica que você deseja concluir, até um máximo de cinco. Use este parâmetro em grupos de replicação do Valkey ou do Redis OSS (modo cluster desabilitado) nos quais haja apenas um grupo de nós ou o grupo do Valkey ou do Redis OSS (modo cluster habilitado), ou onde você deseja que todos os grupos de nós tenham o mesmo número de réplicas. Caso esse valor não seja maior que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.
+ `--replica-configuration`: opcional. Permite definir o número de réplicas e as zonas de disponibilidade de cada grupo de nós independentemente. Use este parâmetro em grupos do Valkey ou Redis OSS (modo cluster habilitado) onde você deseja configurar cada grupo de nós independentemente.
`--replica-configuration` tem três membros opcionais:
+ `NodeGroupId`: o ID de quatro dígitos do grupo de nós que você está configurando. Para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado), o ID de fragmento é sempre `0001`. Para encontrar o ID de um grupo de nós (fragmento) do Valkey ou Redis OSS (modo cluster habilitado), consulte [Localização de um ID de fragmento](Shards.md#shard-find-id).
+ `NewReplicaCount`: o número de réplicas que você deseja nesse grupo de nós ao final desta operação. O valor deve ser maior que o número atual de réplicas, até um máximo de cinco. Caso esse valor não seja maior que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.
+ `PreferredAvailabilityZones`: uma lista de strings de `PreferredAvailabilityZone` que especificam em quais zonas de disponibilidade os nós do grupo de replicação devem estar. O número de valores `PreferredAvailabilityZone` deve ser igual ao valor de `NewReplicaCount` mais 1 para contabilizar o nó primário. Caso esse membro de `--replica-configuration` seja omitido, o ElastiCache para Redis OSS escolherá a zona de disponibilidade para cada uma das novas réplicas.
**Importante**
Você deve incluir o parâmetro `--new-replica-count` ou `--replica-configuration`, mas não ambos, na chamada.
**Example**
O exemplo a seguir aumenta o número de réplicas no grupo de replicação `sample-repl-group` para três. Quando o exemplo é concluído, existem três réplicas em cada grupo de nós. Esse número se aplica caso este seja um grupo do Valkey ou Redis OSS (modo cluster desabilitado) com um grupo de nós único ou um grupo do Valkey ou Redis OSS (modo cluster habilitado) com vários grupos de nós.
Para Linux, macOS ou Unix:
```
aws elasticache increase-replica-count \
--replication-group-id sample-repl-group \
--new-replica-count 3 \
--apply-immediately
```
Para Windows:
```
aws elasticache increase-replica-count ^
--replication-group-id sample-repl-group ^
--new-replica-count 3 ^
--apply-immediately
```
O exemplo a seguir aumenta o número de réplicas no grupo de replicação `sample-repl-group` para o valor especificado para os dois grupos de nós especificados. Como há vários grupos de nós, este é um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Durante a especificação do `PreferredAvailabilityZones` opcional, o número de zonas de disponibilidade listadas deve ser igual ao valor de `NewReplicaCount` mais 1. Essa abordagem contabiliza o nó primário do grupo identificado por `NodeGroupId`.
Para Linux, macOS ou Unix:
```
aws elasticache increase-replica-count \
--replication-group-id sample-repl-group \
--replica-configuration \
NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c,us-east-1b \
NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c,us-east-1c \
--apply-immediately
```
Para Windows:
```
aws elasticache increase-replica-count ^
--replication-group-id sample-repl-group ^
--replica-configuration ^
NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c,us-east-1b ^
NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c,us-east-1c \
--apply-immediately
```
Para obter mais informações sobre como aumentar o número de réplicas usando a CLI, consulte [increase-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html) na *Referência da linha de comando do Amazon ElastiCache*.
## Uso da API do ElastiCache
Para aumentar o número de réplicas em um fragmento do Valkey ou Redis OSS, use a ação `IncreaseReplicaCount` com os seguintes parâmetros:
+ `ReplicationGroupId`: obrigatório. Identifica em qual grupo de replicação você deseja aumentar o número de réplicas.
+ `ApplyImmediately`: obrigatório. Especifica se é necessário aumentar a contagem de réplicas imediatamente (`ApplyImmediately=True`) ou na próxima janela de manutenção (`ApplyImmediately=False`). Atualmente, `ApplyImmediately=False` não é suportado.
+ `NewReplicaCount`: opcional. Especifica o número de nós de réplica que você deseja concluir, até um máximo de cinco. Use este parâmetro em grupos de replicação do Valkey ou do Redis OSS (modo cluster desabilitado) nos quais haja apenas um grupo de nós, ou grupos do Valkey ou do Redis OSS (modo cluster habilitado) onde você deseja que todos os grupos de nós tenham o mesmo número de réplicas. Caso esse valor não seja maior que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.
+ `ReplicaConfiguration`: opcional. Permite definir o número de réplicas e as zonas de disponibilidade de cada grupo de nós independentemente. Use este parâmetro em grupos do Valkey ou Redis OSS (modo cluster habilitado) onde você deseja configurar cada grupo de nós independentemente.
`ReplicaConfiguraion` tem três membros opcionais:
+ `NodeGroupId`: o ID de quatro dígitos do grupo de nós que você está configurando. Para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado), o ID do grupo de nós (fragmento) é sempre `0001`. Para encontrar o ID de um grupo de nós (fragmento) do Valkey ou Redis OSS (modo cluster habilitado), consulte [Localização de um ID de fragmento](Shards.md#shard-find-id).
+ `NewReplicaCount`: o número de réplicas que você deseja nesse grupo de nós ao final desta operação. O valor deve ser maior que o número atual de réplicas e um máximo de cinco. Caso esse valor não seja maior que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.
+ `PreferredAvailabilityZones`: uma lista de strings de `PreferredAvailabilityZone` que especificam em quais zonas de disponibilidade os nós do grupo de replicação devem estar. O número de valores `PreferredAvailabilityZone` deve ser igual ao valor de `NewReplicaCount` mais 1 para contabilizar o nó primário. Caso esse membro de `ReplicaConfiguration` seja omitido, o ElastiCache para Redis OSS escolherá a zona de disponibilidade para cada uma das novas réplicas.
**Importante**
Você deve incluir o parâmetro `NewReplicaCount` ou `ReplicaConfiguration`, mas não ambos, na chamada.
**Example**
O exemplo a seguir aumenta o número de réplicas no grupo de replicação `sample-repl-group` para três. Quando o exemplo é concluído, existem três réplicas em cada grupo de nós. Esse número se aplica caso este seja um grupo do Valkey ou Redis OSS (modo cluster desabilitado) com um grupo de nós único, ou um grupo do Valkey ou Redis OSS (modo cluster habilitado) com vários grupos de nós.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=IncreaseReplicaCount
&ApplyImmediately=True
&NewReplicaCount=3
&ReplicationGroupId=sample-repl-group
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
O exemplo a seguir aumenta o número de réplicas no grupo de replicação `sample-repl-group` para o valor especificado para os dois grupos de nós especificados. Como há vários grupos de nós, este é um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Durante a especificação do `PreferredAvailabilityZones` opcional, o número de zonas de disponibilidade listadas deve ser igual ao valor de `NewReplicaCount` mais 1. Essa abordagem contabiliza o nó primário do grupo identificado por `NodeGroupId`.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=IncreaseReplicaCount
&ApplyImmediately=True
&ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
&ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=2
&ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
&ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
&ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1b
&ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
&ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=3
&ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
&ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
&ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1c
&ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
&ReplicationGroupId=sample-repl-group
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Para obter mais informações sobre como aumentar o número de réplicas usando a API, consulte [IncreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html) na *Referência da API do Amazon ElastiCache*.
# Diminuição do número de réplicas em um fragmento
Você pode reduzir o número de réplicas em um fragmento do Valkey ou do Redis OSS (modo cluster habilitado) ou em um grupo de replicação do Valkey ou do Redis OSS (modo cluster desabilitado):
+ Para o Valkey ou Redis OSS (modo cluster desabilitado), é possível reduzir o número de réplicas para um, caso o multi-AZ esteja habilitado, e para zero, caso ele não esteja habilitado.
+ Para o Valkey ou Redis OSS (modo cluster habilitado), você pode diminuir o número de réplicas para zero. No entanto, você não pode fazer failover para uma réplica, caso o nó primário falhe.
Você pode usar o Console de gerenciamento da AWS, a AWS CLI ou a API do ElastiCache para reduzir o número de réplicas em um grupo de nós (fragmento) ou em um grupo de replicação.
**Topics**
+ [Utilização do Console de gerenciamento da AWS](#decrease-replica-count-con)
+ [Como usar o AWS CLI](#decrease-replica-count-cli)
+ [Uso da API do ElastiCache](#decrease-replica-count-api)
## Utilização do Console de gerenciamento da AWS
O procedimento a seguir usa o console para reduzir o número de réplicas em um grupo de replicação do Valkey ou do Redis OSS (modo cluster habilitado).
**Para diminuir o número de réplicas em um fragmento do Valkey ou Redis OSS**
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. No painel de navegação, escolha **Valkey** ou **Redis OSS** e o nome do grupo de replicação do qual você deseja excluir réplicas.
1. Escolha a caixa de cada estilhaço de que você deseja excluir um nó de réplica.
1. Escolha **Delete replicas (Excluir réplicas)**.
1. Conclua a página **Delete Replicas from Shards (Excluir réplicas de estilhaços)**:
1. Em **New number of replicas/shard (Novo número de réplicas/estilhaço)**, informe o número de réplicas que os estilhaços selecionados devem ter. Esse número deve ser maior que ou igual a 1. Recomendamos pelo menos duas réplicas por estilhaço para trabalho mínimo.
1. Escolha **Delete (Excluir)** a fim de excluir as réplicas ou **Cancel (Cancelar)** a fim de cancelar a operação.
**Importante**
Caso você não especifique os nós de réplica a serem excluídos, o ElastiCache para Redis OSS selecionará automaticamente os nós de réplica para exclusão. Ao fazer isso, o ElastiCache para Redis OSS tenta manter a arquitetura multi-AZ do grupo de replicação seguido preservando réplicas com atraso de replicação mínimo em relação ao principal.
Não é possível excluir o primário ou os nós primários em um grupo de replicação. Se você especificar o nó primário para exclusão, a operação falhará com um evento de erro indicando que o nó primário foi selecionado para exclusão.
## Como usar o AWS CLI
Para diminuir o número de réplicas em um fragmento do Valkey ou Redis OSS, use o comando `decrease-replica-count` com os seguintes parâmetros:
+ `--replication-group-id`: obrigatório. Identifica em qual grupo de replicação você deseja diminuir o número de réplicas.
+ `--apply-immediately` ou `--no-apply-immediately`: obrigatório. Especifica se é necessário diminuir a contagem de réplicas imediatamente (`--apply-immediately`) ou na próxima janela de manutenção (`--no-apply-immediately`). Atualmente, `--no-apply-immediately` não é suportado.
+ `--new-replica-count`: opcional. Especifica o número de nós de réplica desejado. O valor de `--new-replica-count` deve ser um valor válido menos o número atual de réplicas nos grupos de nós. Para valores permitidos mínimos, consulte [Diminuição do número de réplicas em um fragmento](#decrease-replica-count). Caso o valor de `--new-replica-count` não atenda a esse requisito, a chama falha.
+ `--replicas-to-remove`: opcional. Contém uma lista de IDs de nó que especificam os nós de réplica a serem removidos.
+ `--replica-configuration`: opcional. Permite definir o número de réplicas e as zonas de disponibilidade de cada grupo de nós independentemente. Use este parâmetro em grupos do Valkey ou Redis OSS (modo cluster habilitado) onde você deseja configurar cada grupo de nós independentemente.
`--replica-configuration` tem três membros opcionais:
+ `NodeGroupId`: o ID de quatro dígitos do grupo de nós que você está configurando. Para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado), o ID de fragmento é sempre `0001`. Para encontrar o ID de um grupo de nós (fragmento) do Valkey ou Redis OSS (modo cluster habilitado), consulte [Localização de um ID de fragmento](Shards.md#shard-find-id).
+ `NewReplicaCount`: um parâmetro opcional que especifica o número de nós de réplica desejado. O valor de `NewReplicaCount` deve ser um valor válido menos o número atual de réplicas nos grupos de nós. Para valores permitidos mínimos, consulte [Diminuição do número de réplicas em um fragmento](#decrease-replica-count). Caso o valor de `NewReplicaCount` não atenda a esse requisito, a chama falha.
+ `PreferredAvailabilityZones`: uma lista de strings de `PreferredAvailabilityZone` que especificam em quais zonas de disponibilidade os nós do grupo de replicação estão. O número de valores `PreferredAvailabilityZone` deve ser igual ao valor de `NewReplicaCount` mais 1 para contabilizar o nó primário. Caso esse membro de `--replica-configuration` seja omitido, o ElastiCache para Redis OSS escolherá a zona de disponibilidade para cada uma das novas réplicas.
**Importante**
Você deve incluir um, e somente um, parâmetro `--new-replica-count`, `--replicas-to-remove`, ou `--replica-configuration`.
**Example**
O exemplo a seguir usa `--new-replica-count` para diminuir o número de réplicas no grupo de replicação `sample-repl-group` para um. Quando o exemplo é concluído, existe uma réplica em cada grupo de nós. Esse número se aplica caso este seja um grupo do Valkey ou Redis OSS (modo cluster desabilitado) com um grupo de nós único ou um grupo do Valkey ou Redis OSS (modo cluster habilitado) com vários grupos de nós.
Para Linux, macOS ou Unix:
```
aws elasticache decrease-replica-count
--replication-group-id sample-repl-group \
--new-replica-count 1 \
--apply-immediately
```
Para Windows:
```
aws elasticache decrease-replica-count ^
--replication-group-id sample-repl-group ^
--new-replica-count 1 ^
--apply-immediately
```
O exemplo a seguir diminui o número de réplicas no grupo de replicação `sample-repl-group` removendo duas réplicas especificadas (`0001` e `0003`) do grupo de nós.
Para Linux, macOS ou Unix:
```
aws elasticache decrease-replica-count \
--replication-group-id sample-repl-group \
--replicas-to-remove 0001,0003 \
--apply-immediately
```
Para Windows:
```
aws elasticache decrease-replica-count ^
--replication-group-id sample-repl-group ^
--replicas-to-remove 0001,0003 \
--apply-immediately
```
O exemplo a seguir usa `--replica-configuration` a fim de diminuir o número de réplicas no grupo de replicação `sample-repl-group` para o valor especificado para os dois grupos de nós especificados. Como há vários grupos de nós, este é um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Durante a especificação do `PreferredAvailabilityZones` opcional, o número de zonas de disponibilidade listadas deve ser igual ao valor de `NewReplicaCount` mais 1. Essa abordagem contabiliza o nó primário do grupo identificado por `NodeGroupId`.
Para Linux, macOS ou Unix:
```
aws elasticache decrease-replica-count \
--replication-group-id sample-repl-group \
--replica-configuration \
NodeGroupId=0001,NewReplicaCount=1,PreferredAvailabilityZones=us-east-1a,us-east-1c \
NodeGroupId=0003,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
--apply-immediately
```
Para Windows:
```
aws elasticache decrease-replica-count ^
--replication-group-id sample-repl-group ^
--replica-configuration ^
NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c ^
NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
--apply-immediately
```
Para obter mais informações sobre como reduzir o número de réplicas usando a CLI, consulte [decrease-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-replica-count.html) na *Referência da linha de comando do Amazon ElastiCache*.
## Uso da API do ElastiCache
Para diminuir o número de réplicas em um fragmento do Valkey ou Redis OSS, use a ação `DecreaseReplicaCount` com os seguintes parâmetros:
+ `ReplicationGroupId`: obrigatório. Identifica em qual grupo de replicação você deseja diminuir o número de réplicas.
+ `ApplyImmediately`: obrigatório. Especifica se é necessário diminuir a contagem de réplicas imediatamente (`ApplyImmediately=True`) ou na próxima janela de manutenção (`ApplyImmediately=False`). Atualmente, `ApplyImmediately=False` não é suportado.
+ `NewReplicaCount`: opcional. Especifica o número de nós de réplica desejado. O valor de `NewReplicaCount` deve ser um valor válido menos o número atual de réplicas nos grupos de nós. Para valores permitidos mínimos, consulte [Diminuição do número de réplicas em um fragmento](#decrease-replica-count). Caso o valor de `--new-replica-count` não atenda a esse requisito, a chama falha.
+ `ReplicasToRemove`: opcional. Contém uma lista de IDs de nó que especificam os nós de réplica a serem removidos.
+ `ReplicaConfiguration`: opcional. Contém uma lista de grupos de nós que permite definir o número de réplicas e as zonas de disponibilidade de cada grupo de nós independentemente. Use este parâmetro em grupos do Valkey ou Redis OSS (modo cluster habilitado) onde você deseja configurar cada grupo de nós independentemente.
`ReplicaConfiguraion` tem três membros opcionais:
+ `NodeGroupId`: o ID de quatro dígitos do grupo de nós que você está configurando. Para grupos de replicação do Valkey ou do Redis OSS (modo cluster desabilitado), o ID do grupo de nós é sempre `0001`. Para encontrar o ID de um grupo de nós (fragmento) do Valkey ou Redis OSS (modo cluster habilitado), consulte [Localização de um ID de fragmento](Shards.md#shard-find-id).
+ `NewReplicaCount`: o número de réplicas que você deseja nesse grupo de nós ao final desta operação. O valor deve ser menor que o número atual de réplicas até um mínimo de 1, caso o Multi-AZ esteja habilitado ou 0 caso o Multi-AZ com failover automático não esteja habilitado. Caso esse valor não seja menor que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.
+ `PreferredAvailabilityZones`: uma lista de strings de `PreferredAvailabilityZone` que especificam em quais zonas de disponibilidade os nós do grupo de replicação estão. O número de valores `PreferredAvailabilityZone` deve ser igual ao valor de `NewReplicaCount` mais 1 para contabilizar o nó primário. Caso esse membro de `ReplicaConfiguration` seja omitido, o ElastiCache para Redis OSS escolherá a zona de disponibilidade para cada uma das novas réplicas.
**Importante**
Você deve incluir um, e somente um, parâmetro `NewReplicaCount`, `ReplicasToRemove`, ou `ReplicaConfiguration`.
**Example**
O exemplo a seguir usa `NewReplicaCount` para diminuir o número de réplicas no grupo de replicação `sample-repl-group` para um. Quando o exemplo é concluído, existe uma réplica em cada grupo de nós. Esse número se aplica caso este seja um grupo do Valkey ou Redis OSS (modo cluster desabilitado) com um grupo de nós único ou um grupo do Valkey ou Redis OSS (modo cluster habilitado) com vários grupos de nós.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DecreaseReplicaCount
&ApplyImmediately=True
&NewReplicaCount=1
&ReplicationGroupId=sample-repl-group
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
O exemplo a seguir diminui o número de réplicas no grupo de replicação `sample-repl-group` removendo duas réplicas especificadas (`0001` e `0003`) do grupo de nós.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DecreaseReplicaCount
&ApplyImmediately=True
&ReplicasToRemove.ReplicaToRemove.1=0001
&ReplicasToRemove.ReplicaToRemove.2=0003
&ReplicationGroupId=sample-repl-group
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
O exemplo a seguir usa `ReplicaConfiguration` a fim de diminuir o número de réplicas no grupo de replicação `sample-repl-group` para o valor especificado para os dois grupos de nós especificados. Como há vários grupos de nós, este é um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Durante a especificação do `PreferredAvailabilityZones` opcional, o número de zonas de disponibilidade listadas deve ser igual ao valor de `NewReplicaCount` mais 1. Essa abordagem contabiliza o nó primário do grupo identificado por `NodeGroupId`.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DecreaseReplicaCount
&ApplyImmediately=True
&ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
&ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=1
&ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
&ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
&ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
&ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=2
&ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
&ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
&ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
&ReplicationGroupId=sample-repl-group
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Para obter mais informações sobre como reduzir o número de réplicas usando a API, consulte [DecreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DecreaseReplicaCount.html) na *Referência da API do Amazon ElastiCache*.
# Adição de uma réplica de leitura do Valkey ou do Redis OSS (modo cluster desabilitado)
As informações no tópico a seguir só se aplicam a grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado).
À medida que seu tráfego de leitura aumentar, talvez você queira espalhar essas leituras em mais nós e reduzir a pressão de leitura em qualquer nó. Neste tópico, você pode descobrir como adicionar uma réplica de leitura a um cluster do Valkey ou Redis OSS (modo cluster desabilitado).
Um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) pode ter no máximo cinco réplicas de leitura. Se você tentar adicionar uma réplica de leitura a um grupo de replicação que já tenha cinco réplicas de leitura, a operação falhará.
Para obter informações sobre como adicionar réplicas a um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado), consulte o seguinte:
+ [Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado)](scaling-redis-cluster-mode-enabled.md)
+ [Aumento do número de réplicas em um fragmento](increase-replica-count.md)
Você pode adicionar uma réplica de leitura a um cluster do Valkey ou Redis OSS (modo cluster desabilitado) usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache.
**Tópicos relacionados**
+ [Adicionar nós a um ElastiCache cluster](Clusters.AddNode.md)
+ [Adição de uma réplica de leitura a um grupo de replicação (AWS CLI)](#Replication.AddReadReplica.CLI)
+ [Adição de uma réplica de leitura a um grupo de replicação usando a API](#Replication.AddReadReplica.API)
## Adição de uma réplica de leitura a um grupo de replicação (AWS CLI)
Para adicionar uma réplica de leitura a um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado), use o comando `create-cache-cluster` da AWS CLI com o parâmetro `--replication-group-id` para especificar a qual grupo de replicação adicionar o cluster (nó).
O exemplo a seguir cria o cluster `my-read replica` e o adiciona ao grupo de replicação `my-replication-group`. Os tipos de nós, os grupos de parâmetros, os grupos de segurança, as janelas de manutenção e outras configurações da réplica de leitura são os mesmos dos outros nós em `my-replication-group`.
Para Linux, macOS ou Unix:
```
aws elasticache create-cache-cluster \
--cache-cluster-id my-read-replica \
--replication-group-id my-replication-group
```
Para Windows:
```
aws elasticache create-cache-cluster ^
--cache-cluster-id my-read-replica ^
--replication-group-id my-replication-group
```
Para obter mais informações sobre como adicionar uma réplica de leitura usando a CLI, consulte [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html) na *Referência da linha de comando do Amazon ElastiCache.*
## Adição de uma réplica de leitura a um grupo de replicação usando a API
Para adicionar uma réplica de leitura a um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado), use a operação `CreateCacheCluster` do ElastiCache com o parâmetro `ReplicationGroupId` para especificar a qual grupo de replicação adicionar o cluster (nó).
O exemplo a seguir cria o cluster `myReadReplica` e o adiciona ao grupo de replicação `myReplicationGroup`. Os tipos de nós, os grupos de parâmetros, os grupos de segurança, as janelas de manutenção e outras configurações da réplica de leitura são os mesmos dos outros nós `myReplicationGroup`.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateCacheCluster
&CacheClusterId=myReadReplica
&ReplicationGroupId=myReplicationGroup
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Para obter mais informações sobre como adicionar uma réplica de leitura usando a API, consulte [CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html) na *Referência da API do Amazon ElastiCache.*
# Exclusão de uma réplica de leitura do Valkey ou do Redis OSS (modo cluster desabilitado)
As informações no tópico a seguir só se aplicam a grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado).
À medida que o tráfego de leitura no seu grupo de replicação Valkey ou Redis OSS mudar, talvez você queira adicionar ou remover réplicas de leitura. Remover um nó de um grupo de replicação é o mesmo que simplesmente excluir um cluster, embora existam restrições:
+ Não é possível remover o primário de um grupo de replicação. Se quiser excluir o primário, você deverá fazer o seguinte:
1. Promover uma réplica de leitura para primário. Para obter mais informações sobre como promover uma réplica de leitura para primário, consulte [Promoção de uma réplica de leitura a primário, para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado)](Replication.PromoteReplica.md).
1. Exclua o primário antigo. Para uma restrição nesse método, consulte o próximo ponto.
+ Se o recurso Multi-AZ estiver habilitado em um grupo de replicação, você não poderá remover a última réplica de leitura do grupo de replicação. Nesse caso, faça o seguinte:
1. Modifique o grupo de replicação desabilitando o Multi-AZ. Para obter mais informações, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
1. Exclua a réplica de leitura.
Você pode remover uma réplica de leitura de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) usando o console do ElastiCache, a AWS CLI para o ElastiCache ou a API do ElastiCache.
Para obter orientações sobre como excluir um cluster de um grupo de replicação Valkey ou Redis OSS, consulte o seguinte:
+ [Usando o Console de gerenciamento da AWS](Clusters.Delete.md#Clusters.Delete.CON)
+ [Usando o AWS CLI para excluir um ElastiCache cluster](Clusters.Delete.md#Clusters.Delete.CLI)
+ [Usando a ElastiCache API](Clusters.Delete.md#Clusters.Delete.API)
+ [Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado)](scaling-redis-cluster-mode-enabled.md)
+ [Diminuição do número de réplicas em um fragmento](decrease-replica-count.md)
# Promoção de uma réplica de leitura a primário, para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado)
As informações no tópico a seguir só se aplicam a grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado).
Você pode promover uma réplica de leitura de um cluster do Valkey ou Redis OSS (modo cluster desabilitado) a primário usando o Console de gerenciamento da AWS, a AWS CLI ou a API do ElastiCache. Você não pode promover uma réplica de leitura para primária enquanto Multi-AZ com failover automático estiver habilitado no grupo de replicação . Para promover uma réplica do Valkey ou Redis OSS (modo cluster desabilitado) para primário em um grupo de replicação habilitado para multi-AZ, faça o seguinte:
1. Modifique o grupo de replicação para desabilitar Multi-AZ (isso não requer que todos os clusters estejam na mesma zona de disponibilidade). Para obter mais informações, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
1. Promova a réplica de leitura para primário.
1. Modifique o grupo de replicação para reabilitar o Multi-AZ.
O Multi-AZ não está disponível em grupos de replicação que executam o Valkey ou Redis OSS 2.6.13 ou anterior.
## Utilização do Console de gerenciamento da AWS
O procedimento a seguir usa o console para promover um nó de réplica para primária.
**Para promover uma réplica de leitura para primário (console)**
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. Se a réplica que você quiser promover for membro de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) em que o multi-AZ estiver habilitado, modifique o grupo de replicação para desabilitar o multi-AZ para continuar. Para obter mais informações, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
1. Escolha **Valkey** ou **Redis OSS**, na lista de clusters, escolha o grupo de replicação que você deseja modificar. Esse grupo de replicação deve estar executando o mecanismo "Redis", e não o mecanismo "Clustered Redis", e deve ter dois ou mais nós.
1. Na lista de nós, escolha o nó de réplica que você deseja promover para primária, em **Actions (Ações)**, escolha **Promote (Promover)**.
1. Na caixa de diálogo **Promote Read Replica (Promover réplica de leitura)**, faça o seguinte:
1. Em **Apply Immediately (Aplicar imediatamente)**, escolha **Yes (Sim)** para promover a réplica de leitura imediatamente, ou **No (Não)** para promovê-la na próxima janela de manutenção do cluster.
1. Escolha **Promote** para promover a réplica de leitura ou **Cancel** para cancelar a operação.
1. Caso o cluster tenha Multi-AZ habilitado antes de você começar o processo de promoção, aguarde o status do grupo de replicação estar **available (disponível)**, modifique o cluster para reabilitar Multi-AZ. Para obter mais informações, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
## Usar a AWS CLI
Você não pode promover uma réplica de leitura para primária caso o grupo de replicação esteja habilitado para Multi-AZ. Em alguns casos, a réplica que você deseja promover pode ser um membro de um grupo de replicação onde o recurso do Multi-AZ está habilitado. Nesses casos, você deve modificar o grupo de replicação para desabilitar o recurso do Multi-AZ antes de continuar. Isso não requer que todos os clusters estejam na mesma zona de disponibilidade. Para obter mais informações sobre como modificar um grupo de replicação, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
O seguinte comando AWS CLI modifica o grupo de replicação `sample-repl-group`, tornando a réplica de leitura `my-replica-1` o primário no grupo de replicação.
Para Linux, macOS ou Unix:
```
aws elasticache modify-replication-group \
--replication-group-id sample-repl-group \
--primary-cluster-id my-replica-1
```
Para Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id sample-repl-group ^
--primary-cluster-id my-replica-1
```
Para obter mais informações sobre como modificar um grupo de replicação, consulte [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) na *Referência da linha de comando do Amazon ElastiCache.*
## Uso da API do ElastiCache
Você não pode promover uma réplica de leitura para primária caso o grupo de replicação esteja habilitado para Multi-AZ. Em alguns casos, a réplica que você deseja promover pode ser um membro de um grupo de replicação onde o recurso do Multi-AZ está habilitado. Nesses casos, você deve modificar o grupo de replicação para desabilitar o recurso do Multi-AZ antes de continuar. Isso não requer que todos os clusters estejam na mesma zona de disponibilidade. Para obter mais informações sobre como modificar um grupo de replicação, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
A seguinte ação da API do ElastiCache modifica o grupo de replicação `myReplGroup`, tornando a réplica de leitura `myReplica-1` o primário no grupo de replicação.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=ModifyReplicationGroup
&ReplicationGroupId=myReplGroup
&PrimaryClusterId=myReplica-1
&Version=2014-12-01
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20141201T220302Z
&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
&X-Amz-Date=20141201T220302Z
&X-Amz-SignedHeaders=Host
&X-Amz-Expires=20141201T220302Z
&X-Amz-Credential=
&X-Amz-Signature=
```
Para obter mais informações sobre como modificar um grupo de replicação, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) na *Referência da API do Amazon ElastiCache.*