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