

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

# Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado)
<a name="scaling-redis-cluster-mode-enabled"></a>

À medida que a demanda nos clusters muda, você pode optar por aumentar a performance ou reduzir os custos alterando o número de fragmentos no seu cluster do Valkey ou Redis OSS (modo cluster habilitado). Recomendamos o uso da escalabilidade horizontal online para esse ajuste, pois permite que o seu cluster continue a atender às solicitações durante o processo de escalabilidade.

As condições sob as quais você pode decidir redimensionar seu cluster incluem o seguinte:
+ **Uso intenso de memória:**

  Se os nós no cluster estão sob uso intenso da memória, você pode optar por aumentar a escala e ter mais recursos para melhor armazenar dados e atender a solicitações.

  Você pode determinar se seus nós estão sob pressão de memória monitorando as seguintes métricas: *FreeableMemory*SwapUsage**, *BytesUsedForCache*e.
+ **CPU ou gargalo de rede:**

  Se os latency/throughput problemas estiverem afetando seu cluster, talvez seja necessário escalar para resolvê-los.

  Você pode monitorar seus níveis de latência e taxa de transferência monitorando as seguintes métricas: *CPUUtilization*, *NetworkBytesIn*, *NetworkBytesOut*CurrConnections**, e. *NewConnections*
+ **Seu cluster está acima da escala:**

  A demanda atual no cluster permite que haja uma redução na escala sem afetar o desempenho e proporcionando corte de custos.

  Você pode monitorar o uso do seu cluster para determinar se você pode ou não escalar com segurança usando as seguintes métricas: *FreeableMemory*SwapUsage*BytesUsedForCache*CPUUtilization****, *NetworkBytesIn*, *NetworkBytesOut*, *CurrConnections*,, *NewConnections*e.

**Impacto da escalabilidade no desempenho**  
Quando você altera a escala usando o processo offline, seu cluster fica offline para uma parte significativa do processo e, por conseguinte, não é capaz de atender a solicitações. Quando você altera a escala usando o método online, como a escalabilidade é uma operação com uso intensivo de computação, há queda no desempenho, mas ainda assim seu cluster continua atendendo a solicitações durante a operação de escalabilidade. O quanto o desempenho é afetado depende do seu uso normal da CPU e dos seus dados.

Existem duas maneiras de escalar seu cluster do Valkey ou Redis OSS (modo cluster desabilitado): com escalabilidade horizontal e vertical.
+ A escalabilidade horizontal permite alterar o número de grupos de nós (estilhaços) no grupo de replicação adicionando ou removendo grupos de nós (estilhaços). O processo de refragmentação on-line permite a escalabilidade in/out enquanto o cluster continua atendendo às solicitações recebidas. 

  Configurar os slots em seu novo cluster de forma diferente como que eles foram configurados no cluster antigo. Apenas no método offline.
+ Escalabilidade vertical — altere o tipo de nó para redimensionar o cluster. O escalonamento vertical on-line permite o escalonamento up/down enquanto o cluster continua atendendo às solicitações recebidas.

Se estiver reduzindo o tamanho e a capacidade de memória do cluster, reduzindo ou expandindo, garanta que a nova configuração tenha memória suficiente para seus dados e a sobrecarga do Valkey ou Redis OSS. 

Para obter mais informações, consulte [Escolha do tamanho do nó](CacheNodes.SelectSize.md).

**Contents**
+ [

## Refragmentação offline para o Valkey ou o Redis OSS (modo cluster habilitado)
](#redis-cluster-resharding-offline)
+ [

## Refragmentação online para o Valkey ou o Redis OSS (modo cluster habilitado)
](#redis-cluster-resharding-online)
  + [

### Adição de fragmentos com refragmentação online
](#redis-cluster-resharding-online-add)
  + [

### Remoção de fragmentos com refragmentação online
](#redis-cluster-resharding-online-remove)
    + [

#### Remoção de fragmentos (console)
](#redis-cluster-resharding-online-remove-console)
    + [

#### Remoção de fragmentos (AWS CLI)
](#redis-cluster-resharding-online-remove-cli)
    + [

#### Removendo fragmentos (ElastiCacheAPI)
](#redis-cluster-resharding-online-remove-api)
  + [

### Rebalanceamento de frgamentos online
](#redis-cluster-resharding-online-rebalance)
    + [

#### Rebalanceamento de fragmentos online (Console)
](#redis-cluster-resharding-online-rebalance-console)
    + [

#### Rebalanceamento de fragmentos online (AWS CLI)
](#redis-cluster-resharding-online-rebalance-cli)
    + [

#### Rebalanceamento de fragmentos on-line (API) ElastiCache
](#redis-cluster-resharding-online-rebalance-api)
+ [

# Escalabilidade vertical online com modificação do tipo de nó
](redis-cluster-vertical-scaling.md)
  + [

## Aumento de escala vertical online
](redis-cluster-vertical-scaling.md#redis-cluster-vertical-scaling-scaling-up)
    + [

### Aumento de escala na vertical de clusters do Valkey ou Redis OSS (console)
](redis-cluster-vertical-scaling.md#redis-cluster-vertical-scaling-console)
    + [

### Aumento da escala na vertical de clusters do Valkey ou Redis OSS (AWS CLI)
](redis-cluster-vertical-scaling.md#Scaling.RedisStandalone.ScaleUp.CLI)
    + [

### Ampliando clusters OSS Valkey ou Redis (API) ElastiCache
](redis-cluster-vertical-scaling.md#VeticalScaling.RedisReplGrps.ScaleUp.API)
  + [

## Redução de escala vertical online
](redis-cluster-vertical-scaling.md#redis-cluster-vertical-scaling-scaling-down)
    + [

### Redução de escala na vertical de clusters do Valkey ou Redis OSS (console)
](redis-cluster-vertical-scaling.md#redis-cluster-vertical-scaling-down-console)
    + [

### Redução de escala na vertical de clusters do Valkey ou Redis OSS (AWS CLI)
](redis-cluster-vertical-scaling.md#Scaling.RedisStandalone.ScaleDown.CLI)
    + [

### Reduzindo a escala de clusters OSS Valkey ou Redis (API) ElastiCache
](redis-cluster-vertical-scaling.md#Scaling.Vertical.ScaleDown.API)

## Refragmentação offline para o Valkey ou o Redis OSS (modo cluster habilitado)
<a name="redis-cluster-resharding-offline"></a>

A principal vantagem de obter a reconfiguração de estilhaços offline é que você pode fazer mais do que simplesmente adicionar ou remover estilhaços do seu grupo de replicação. Quando você faz a refragmentação e o rebalanceamento offline, além de alterar o número de fragmentos no seu grupo de replicação, é possível fazer o seguinte:

**nota**  
A refragmentação offline não é compatível com clusters do Valkey ou Redis OSS que tenham a classificação de dados em níveis ativada. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).
+ Alterar o tipo de nó do seu grupo de replicação.
+ Especificar a zona de disponibilidade para cada nó no grupo de replicação.
+ Fazer o upgrade para uma versão mais recente do mecanismo.
+ Especificar o número de nós de réplica em cada estilhaço de forma independente.
+ Especificar o espaço de chaves para cada estilhaço.

A principal desvantagem da reconfiguração de fragmentos offline é que o cluster fica offline começando com a parte de restauração do processo e continua até você atualizar os endpoints no aplicativo. O tempo em que o cluster fica offline depende da quantidade de dados no seu cluster.

**Para reconfigurar seus fragmentos offline no cluster do Valkey ou Redis OSS (modo cluster habilitado)**

1. Crie um backup manual do seu cluster Valkey ou Redis OSS existente. Para obter mais informações, consulte [Realização de backups manuais](backups-manual.md).

1. Crie um novo cluster fazendo a restauração a partir do backup. Para obter mais informações, consulte [Restauração de um backup para um novo cache](backups-restoring.md).

1. Atualize os endpoints no seu aplicativo para os endpoints do novo cluster. Para obter mais informações, consulte [Encontrar endpoints de conexão no ElastiCache](Endpoints.md).

## Refragmentação online para o Valkey ou o Redis OSS (modo cluster habilitado)
<a name="redis-cluster-resharding-online"></a>

Ao usar a refragmentação on-line e o rebalanceamento de fragmentos com o ElastiCache Valkey 7.2 ou mais recente, ou o Redis OSS versão 3.2.10 ou mais recente, você pode escalar dinamicamente seu cluster Valkey ou Redis OSS (modo de cluster ativado) sem tempo de inatividade. Essa abordagem significa que seu cluster pode continuar atendendo a solicitações mesmo durante a escalabilidade ou o rebalanceamento.

Você pode fazer o seguinte:
+ **Aumentar a escala horizontalmente**: aumente a capacidade de leitura e gravação adicionando fragmentos (grupos de nós) ao seu cluster do Valkey ou Redis OSS (modo cluster habilitado) (grupo de replicação).

  Se você adicionar um ou mais fragmentos ao grupo de replicação, o número de nós em cada novo fragmento será o mesmo que o número de nós no menor dos fragmentos existentes.
+ **Reduzir a escala horizontalmente**: reduza de capacidade de leitura e gravação e, por conseguinte, os custos, removendo fragmentos do cluster do Valkey ou Redis OSS (modo cluster habilitado).
+ **Rebalancear**: mova os espaços de chave entre os fragmentos em seu cluster do Valkey ou Redis OSS (modo cluster habilitado) a fim de que eles sejam distribuídos de modo uniforme entre os fragmentos.

Você não pode fazer o seguinte:
+ **Configurar os fragmentos de forma independente:**

  Não é possível especificar o espaço de chave para os fragmentos de forma independente. Para fazer isso, você deve usar o processo offline.

Atualmente, as seguintes limitações se aplicam à fragmentação e ao rebalanceamento ElastiCache on-line:
+ Esses processos exigem o Valkey 7.2 ou mais recente ou Redis OSS 3.2.10 ou mais recente. Para obter informações sobre como atualizar sue versão de mecanismo, consulte [Gerenciamento de versões para ElastiCache](VersionManagement.md).
+ Há limitações em relação a slots ou espaços de chave e itens grandes:

  Se qualquer uma das chaves em um fragmento contiver um item grande, essa chave não será migrada para um novo fragmento durante o aumento da escala ou o rebalanceamento. Essa funcionalidade pode resultar em fragmentos desbalanceados.

  Se qualquer uma das chaves em um fragmento contiver um item grande (itens maiores do que 256 MB após a serialização), o fragmento não será excluído na redução da escala. Essa funcionalidade pode resultar na não exclusão de alguns fragmentos.
+ Ao aumentar a escala, o número de nós em novos fragmentos fica igual ao número de nós no menor dos fragmentos existentes.
+ No aumento de escala, qualquer tag comum a todos os fragmentos existentes é copiada para os novos fragmentos.
+ Ao escalar um cluster de armazenamento de dados global, não ElastiCache replicará automaticamente as funções de um dos nós existentes para o (s) novo (s) nó (s). Recomendamos carregar suas funções nos novos fragmentos depois de aumentar a escala horizontalmente do seu cluster para que todos os fragmentos tenham as mesmas funções. 

**nota**  
No ElastiCache Valkey 7.2 e superior e no Redis OSS versão 7 e ElastiCache superior: ao escalar seu cluster, ElastiCache replicará automaticamente as funções carregadas em um dos nós existentes (selecionados aleatoriamente) para o (s) novo (s) nó (s). Se sua aplicação usa [Functions](https://valkey.io/topics/functions-intro/) (Funções), recomendamos carregar todas as suas funções em todos os fragmentos antes de aumentar a escala horizontalmente, para que seu cluster do não tenha definições de função diferentes em fragmentos diferentes.

Para obter mais informações, consulte [Redimensionamento de cluster on-line](best-practices-online-resharding.md).

Você pode escalar ou reequilibrar horizontalmente seus clusters Valkey ou Redis OSS (modo de cluster ativado) usando a Console de gerenciamento da AWS, a e a API.AWS CLI ElastiCache 

### Adição de fragmentos com refragmentação online
<a name="redis-cluster-resharding-online-add"></a>

Você pode adicionar fragmentos ao seu cluster Valkey ou Redis OSS (modo de cluster ativado) usando a API Console de gerenciamento da AWS,AWS CLI ou. ElastiCache Quando você adiciona fragmentos a um cluster do Valkey ou Redis OSS (modo cluster habilitado), qualquer tag nos fragmentos existentes é copiada para os novos fragmentos.

**Topics**

#### Adição de fragmentos (console)
<a name="redis-cluster-resharding-online-add-console"></a>

Você pode usar o Console de gerenciamento da AWS para adicionar um ou mais fragmentos ao seu cluster Valkey ou Redis OSS (modo de cluster ativado). O procedimento a seguir descreve o processo.

**Como adicionar fragmentos ao seu cluster do Valkey ou Redis OSS (modo cluster habilitado)**

1. Abra o ElastiCache console em [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. No painel de navegação, escolha **Clusters do Valkey** ou **Clusters do Redis OSS**.

1. Localize e escolha o nome, não a caixa à esquerda do nome do cluster, do cluster do Valkey ou Redis OSS (modo cluster habilitado) ao qual você deseja adicionar fragmentos.
**dica**  
O Valkey ou Redis OSS (modo cluster habilitado) exibe **Clustered Valkey** ou **Clustered Redis OSS** na coluna **Mode** (Modo)

1. Escolha **Add shard** (Adicionar fragmento).

   1. Para **Number of shards to be added**, escolha o número de fragmentos que deseja adicionar a este cluster.

   1. Para **Availability zone(s)** (Zonas de disponibilidade), escolha **No preference** (Sem preferência) ou **Specify availability zones** (Especificar zonas de disponibilidade).

   1. Se você optar por **Specify availability zones** (Especificar zonsa de disponibilidade), para cada nó em cada fragmento, selecione a zona de disponibilidade do nó na lista de zonas de disponibilidade.

   1. Escolha **Add** (Adicionar).

#### Adição de fragmentos (AWS CLI)
<a name="redis-cluster-resharding-online-add-cli"></a>

O processo a seguir descreve como reconfigurar os fragmentos no seu cluster do Valkey ou Redis OSS (modo cluster habilitado) adicionando fragmentos por meio da AWS CLI.

Use os parâmetros a seguir com `modify-replication-group-shard-configuration`.

**Parâmetros**
+ `--apply-immediately`: obrigatório. Especifica que a operação de reconfiguração de fragmento começará imediatamente.
+ `--replication-group-id`: obrigatório. Especifica em qual grupo de replicação (cluster) a operação de reconfiguração de fragmento será executada.
+ `--node-group-count`: obrigatório. Especifica o número de fragmentos (grupos de nós) que devem existir quando a operação for concluída. Ao adicionar fragmentos, o valor de `--node-group-count` deve ser maior que o número atual de fragmentos.

  Como opção, você pode especificar a zona de disponibilidade para cada nó no grupo de replicação usando `--resharding-configuration`.
+ `--resharding-configuration`: opcional. Uma lista de zonas de disponibilidade preferenciais para cada nó em cada fragmento no grupo de replicação. Use este parâmetro somente se o valor de `--node-group-count` for maior que o número atual de fragmentos. Se esse parâmetro for omitido ao adicionar fragmentos, a Amazon ElastiCache selecionará as zonas de disponibilidade para os novos nós.

O exemplo a seguir reconfigura os espaços de chave em quatro fragmentos em um cluster do Valkey ou Redis OSS (modo cluster habilitado) `my-cluster`. O exemplo também especifica a zona de disponibilidade para cada nó em cada fragmento. A operação começa imediatamente.

**Example Adicionar fragmentos**  
Para Linux, macOS ou Unix:  

```
aws elasticache modify-replication-group-shard-configuration \
    --replication-group-id my-cluster \
    --node-group-count 4 \
    --resharding-configuration \
        "PreferredAvailabilityZones=us-east-2a,us-east-2c" \
        "PreferredAvailabilityZones=us-east-2b,us-east-2a" \
        "PreferredAvailabilityZones=us-east-2c,us-east-2d" \
        "PreferredAvailabilityZones=us-east-2d,us-east-2c" \
    --apply-immediately
```
Para Windows:  

```
aws elasticache modify-replication-group-shard-configuration ^
    --replication-group-id my-cluster ^
    --node-group-count 4 ^
    --resharding-configuration ^
        "PreferredAvailabilityZones=us-east-2a,us-east-2c" ^
        "PreferredAvailabilityZones=us-east-2b,us-east-2a" ^
        "PreferredAvailabilityZones=us-east-2c,us-east-2d" ^
        "PreferredAvailabilityZones=us-east-2d,us-east-2c" ^
    --apply-immediately
```

Para obter mais informações, consulte [modify-replication-group-shard-configuration](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group-shard-configuration.html) na AWS CLI documentação.

#### Adicionar fragmentos (ElastiCache API)
<a name="redis-cluster-resharding-online-add-api"></a>

Você pode usar a ElastiCache API para reconfigurar os fragmentos em seu cluster Valkey ou Redis OSS (modo de cluster ativado) on-line usando a operação. `ModifyReplicationGroupShardConfiguration`

Use os parâmetros a seguir com `ModifyReplicationGroupShardConfiguration`.

**Parâmetros**
+ `ApplyImmediately=true`: obrigatório. Especifica que a operação de reconfiguração de fragmento começará imediatamente.
+ `ReplicationGroupId`: obrigatório. Especifica em qual grupo de replicação (cluster) a operação de reconfiguração de fragmento será executada.
+ `NodeGroupCount`: obrigatório. Especifica o número de fragmentos (grupos de nós) que devem existir quando a operação for concluída. Ao adicionar fragmentos, o valor de `NodeGroupCount` deve ser maior que o número atual de fragmentos.

  Como opção, você pode especificar a zona de disponibilidade para cada nó no grupo de replicação usando `ReshardingConfiguration`.
+ `ReshardingConfiguration`: opcional. Uma lista de zonas de disponibilidade preferenciais para cada nó em cada fragmento no grupo de replicação. Use este parâmetro somente se o valor de `NodeGroupCount` for maior que o número atual de fragmentos. Se esse parâmetro for omitido ao adicionar fragmentos, a Amazon ElastiCache selecionará as zonas de disponibilidade para os novos nós.

O processo a seguir descreve como reconfigurar os fragmentos em seu cluster Valkey ou Redis OSS (modo de cluster ativado) adicionando fragmentos usando a API. ElastiCache 

**Example Adicionar fragmentos**  
O exemplo a seguir adiciona grupos de nós ao cluster do Valkey ou Redis OSS (modo cluster habilitado) `my-cluster` de modo que haja um total de quatro grupos de nós quando a operação for concluída. O exemplo também especifica a zona de disponibilidade para cada nó em cada fragmento. A operação começa imediatamente.  

```
https://elasticache.us-east-2.amazonaws.com/
    ?Action=ModifyReplicationGroupShardConfiguration
    &ApplyImmediately=true
    &NodeGroupCount=4
    &ReplicationGroupId=my-cluster
    &ReshardingConfiguration.ReshardingConfiguration.1.PreferredAvailabilityZones.AvailabilityZone.1=us-east-2a 
    &ReshardingConfiguration.ReshardingConfiguration.1.PreferredAvailabilityZones.AvailabilityZone.2=us-east-2c 
    &ReshardingConfiguration.ReshardingConfiguration.2.PreferredAvailabilityZones.AvailabilityZone.1=us-east-2b 
    &ReshardingConfiguration.ReshardingConfiguration.2.PreferredAvailabilityZones.AvailabilityZone.2=us-east-2a 
    &ReshardingConfiguration.ReshardingConfiguration.3.PreferredAvailabilityZones.AvailabilityZone.1=us-east-2c 
    &ReshardingConfiguration.ReshardingConfiguration.3.PreferredAvailabilityZones.AvailabilityZone.2=us-east-2d 
    &ReshardingConfiguration.ReshardingConfiguration.4.PreferredAvailabilityZones.AvailabilityZone.1=us-east-2d 
    &ReshardingConfiguration.ReshardingConfiguration.4.PreferredAvailabilityZones.AvailabilityZone.2=us-east-2c 
    &Version=2015-02-02
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20171002T192317Z
    &X-Amz-Credential=<credential>
```

Para obter mais informações, consulte [ModifyReplicationGroupShardConfiguration](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroupShardConfiguration.html)a Referência ElastiCache da API.

### Remoção de fragmentos com refragmentação online
<a name="redis-cluster-resharding-online-remove"></a>

Você pode remover fragmentos do seu cluster Valkey ou Redis OSS (modo de cluster ativado) usando a API Console de gerenciamento da AWS,AWS CLI ou. ElastiCache 

**Topics**
+ [

#### Remoção de fragmentos (console)
](#redis-cluster-resharding-online-remove-console)
+ [

#### Remoção de fragmentos (AWS CLI)
](#redis-cluster-resharding-online-remove-cli)
+ [

#### Removendo fragmentos (ElastiCacheAPI)
](#redis-cluster-resharding-online-remove-api)

#### Remoção de fragmentos (console)
<a name="redis-cluster-resharding-online-remove-console"></a>

O processo a seguir descreve como reconfigurar os fragmentos no seu cluster do Valkey ou Redis OSS (modo cluster habilitado) removendo fragmentos por meio da Console de gerenciamento da AWS.

Antes de remover grupos de nós (fragmentos) do seu grupo de replicação, certifique-se ElastiCache de que todos os seus dados caibam nos fragmentos restantes. Se os dados couberem, os fragmentos especificados serão excluídos do grupo de replicação como solicitado. Se os dados não couberem nos grupos de nós restantes, o processo será encerrado e o grupo de replicação será deixado com a mesma configuração do grupo de nós anterior à solicitação.

Você pode usar o Console de gerenciamento da AWS para remover um ou mais fragmentos do seu cluster Valkey ou Redis OSS (modo de cluster ativado). Não é possível remover todos os fragmentos de um grupo de replicação. Nesse caso, você deve excluir o grupo de replicação. Para obter mais informações, consulte [Exclusão de um grupo de replicação](Replication.DeletingRepGroup.md). O procedimento a seguir descreve o processo para excluir um ou mais fragmentos.

**Para remover fragmentos do seu cluster do Valkey ou Redis OSS (modo cluster habilitado)**

1. Abra o ElastiCache console em [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. No painel de navegação, escolha **Clusters do Valkey** ou **Clusters do Redis OSS**.

1. Localize e escolha o nome, não a caixa à esquerda do nome do cluster, do cluster do Valkey ou Redis OSS (modo cluster habilitado) do qual você deseja remover fragmentos.
**dica**  
Os clusters do Valkey ou Redis OSS (modo cluster habilitado) têm um valor igual ou superior a 1 na coluna **Shards** (Fragmentos).

1. Na lista de fragmentos, escolha a caixa à esquerda do nome de cada fragmento que você gostaria de excluir.

1. Escolha **Delete shard** (Excluir fragmento).

#### Remoção de fragmentos (AWS CLI)
<a name="redis-cluster-resharding-online-remove-cli"></a>

O processo a seguir descreve como reconfigurar os fragmentos no seu cluster do Valkey ou Redis OSS (modo cluster habilitado) removendo fragmentos por meio da AWS CLI.

**Importante**  
Antes de remover grupos de nós (fragmentos) do seu grupo de replicação, certifique-se ElastiCache de que todos os seus dados caibam nos fragmentos restantes. Se os dados couberem, os fragmentos especificados (`--node-groups-to-remove`) serão excluídos do grupo de replicação como solicitado e seus espaços de chave serão mapeados para os fragmentos restantes. Se os dados não couberem nos grupos de nós restantes, o processo será encerrado e o grupo de replicação será deixado com a mesma configuração do grupo de nós anterior à solicitação.

Você pode usar o AWS CLI para remover um ou mais fragmentos do seu cluster Valkey ou Redis OSS (modo de cluster ativado). Não é possível remover todos os fragmentos de um grupo de replicação. Nesse caso, você deve excluir o grupo de replicação. Para obter mais informações, consulte [Exclusão de um grupo de replicação](Replication.DeletingRepGroup.md).

Use os parâmetros a seguir com `modify-replication-group-shard-configuration`.

**Parâmetros**
+ `--apply-immediately`: obrigatório. Especifica que a operação de reconfiguração de fragmento começará imediatamente.
+ `--replication-group-id`: obrigatório. Especifica em qual grupo de replicação (cluster) a operação de reconfiguração de fragmento será executada.
+ `--node-group-count`: obrigatório. Especifica o número de fragmentos (grupos de nós) que devem existir quando a operação for concluída. Ao remover fragmentos, o valor de `--node-group-count` deve ser menor que o número atual de fragmentos.

  
+ `--node-groups-to-remove`: obrigatório quando `--node-group-count` for menor do que o número atual de grupos de nós (fragmentos). Uma lista de fragmentos (grupo de nós) IDs a serem removidos do grupo de replicação.

O procedimento a seguir descreve o processo para excluir um ou mais fragmentos.

**Example Remover fragmentos**  
O exemplo a seguir remove dois grupos de nós do cluster do Valkey ou Redis OSS (modo cluster habilitado) `my-cluster` de modo que haja um total de dois grupos de nós quando a operação for concluída. Os espaços de chave dos fragmentos removidos são distribuídos uniformemente entre os fragmentos restantes.  
Para Linux, macOS ou Unix:  

```
aws elasticache modify-replication-group-shard-configuration \
    --replication-group-id my-cluster \
    --node-group-count 2 \
    --node-groups-to-remove "0002" "0003" \
    --apply-immediately
```
Para Windows:  

```
aws elasticache modify-replication-group-shard-configuration ^
    --replication-group-id my-cluster ^
    --node-group-count 2 ^
    --node-groups-to-remove "0002" "0003" ^
    --apply-immediately
```

#### Removendo fragmentos (ElastiCacheAPI)
<a name="redis-cluster-resharding-online-remove-api"></a>

Você pode usar a ElastiCache API para reconfigurar os fragmentos em seu cluster Valkey ou Redis OSS (modo de cluster ativado) on-line usando a operação. `ModifyReplicationGroupShardConfiguration`

O processo a seguir descreve como reconfigurar os fragmentos em seu cluster Valkey ou Redis OSS (modo de cluster ativado) removendo fragmentos usando a API. ElastiCache 

**Importante**  
Antes de remover grupos de nós (fragmentos) do seu grupo de replicação, certifique-se ElastiCache de que todos os seus dados caibam nos fragmentos restantes. Se os dados couberem, os fragmentos especificados (`NodeGroupsToRemove`) serão excluídos do grupo de replicação como solicitado e seus espaços de chave serão mapeados para os fragmentos restantes. Se os dados não couberem nos grupos de nós restantes, o processo será encerrado e o grupo de replicação será deixado com a mesma configuração do grupo de nós anterior à solicitação.

Você pode usar a ElastiCache API para remover um ou mais fragmentos do seu cluster Valkey ou Redis OSS (modo de cluster ativado). Não é possível remover todos os fragmentos de um grupo de replicação. Nesse caso, você deve excluir o grupo de replicação. Para obter mais informações, consulte [Exclusão de um grupo de replicação](Replication.DeletingRepGroup.md).

Use os parâmetros a seguir com `ModifyReplicationGroupShardConfiguration`.

**Parâmetros**
+ `ApplyImmediately=true`: obrigatório. Especifica que a operação de reconfiguração de fragmento começará imediatamente.
+ `ReplicationGroupId`: obrigatório. Especifica em qual grupo de replicação (cluster) a operação de reconfiguração de fragmento será executada.
+ `NodeGroupCount`: obrigatório. Especifica o número de fragmentos (grupos de nós) que devem existir quando a operação for concluída. Ao remover fragmentos, o valor de `NodeGroupCount` deve ser menor que o número atual de fragmentos.
+ `NodeGroupsToRemove`: obrigatório quando `--node-group-count` for menor do que o número atual de grupos de nós (fragmentos). Uma lista de fragmentos (grupo de nós) IDs a serem removidos do grupo de replicação.

O procedimento a seguir descreve o processo para excluir um ou mais fragmentos.

**Example Remover fragmentos**  
O exemplo a seguir remove dois grupos de nós do cluster do Valkey ou Redis OSS (modo cluster habilitado) `my-cluster` de modo que haja um total de dois grupos de nós quando a operação for concluída. Os espaços de chave dos fragmentos removidos são distribuídos uniformemente entre os fragmentos restantes.  

```
https://elasticache.us-east-2.amazonaws.com/
    ?Action=ModifyReplicationGroupShardConfiguration
    &ApplyImmediately=true
    &NodeGroupCount=2
    &ReplicationGroupId=my-cluster
    &NodeGroupsToRemove.member.1=0002
    &NodeGroupsToRemove.member.2=0003
    &Version=2015-02-02
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20171002T192317Z
    &X-Amz-Credential=<credential>
```

### Rebalanceamento de frgamentos online
<a name="redis-cluster-resharding-online-rebalance"></a>

Você pode reequilibrar os fragmentos em seu cluster Valkey ou Redis OSS (modo de cluster ativado) usando a Console de gerenciamento da AWS API, ou.AWS CLI ElastiCache 

**Topics**
+ [

#### Rebalanceamento de fragmentos online (Console)
](#redis-cluster-resharding-online-rebalance-console)
+ [

#### Rebalanceamento de fragmentos online (AWS CLI)
](#redis-cluster-resharding-online-rebalance-cli)
+ [

#### Rebalanceamento de fragmentos on-line (API) ElastiCache
](#redis-cluster-resharding-online-rebalance-api)

#### Rebalanceamento de fragmentos online (Console)
<a name="redis-cluster-resharding-online-rebalance-console"></a>

O processo a seguir descreve como reconfigurar os fragmentos no seu cluster do Valkey ou Redis OSS (modo cluster habilitado) rebalanceando fragmentos por meio da Console de gerenciamento da AWS.

**Para rebalancear os espaços de chave entre os fragmentos no seu cluster do Valkey ou Redis OSS (modo cluster habilitado)**

1. Abra o ElastiCache console em [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. No painel de navegação, escolha **Clusters do Valkey** ou **Clusters do Redis OSS**.

1. Escolha o nome do cluster (não a caixa à esquerda do nome do cluster) do Valkey ou Redis OSS (modo cluster habilitado) que você gostaria de rebalancear.
**dica**  
Os clusters do Valkey ou Redis OSS (modo cluster habilitado) têm um valor igual ou superior a 1 na coluna **Shards** (Fragmentos).

1. Escolha **Rebalance** (Rebalancear).

1. Quando solicitado, escolha **Rebalance** (Rebalancear). Você pode ver uma mensagem semelhante a esta:*Slots in the replication group are uniformly distributed. Nothing to do. (Service: AmazonElastiCache; Status Code: 400; Error Code: InvalidReplicationGroupState; Request ID: 2246cebd-9721-11e7-8d5b-e1b0f086c8cf)*. Se isso acontecer, escolha **Cancel** (Cancelar).

#### Rebalanceamento de fragmentos online (AWS CLI)
<a name="redis-cluster-resharding-online-rebalance-cli"></a>

Use os parâmetros a seguir com `modify-replication-group-shard-configuration`.

**Parâmetros**
+ `-apply-immediately`: obrigatório. Especifica que a operação de reconfiguração de fragmento começará imediatamente.
+ `--replication-group-id`: obrigatório. Especifica em qual grupo de replicação (cluster) a operação de reconfiguração de fragmento será executada.
+ `--node-group-count`: obrigatório. Para rebalancear os espaços de chave entre todos os fragmentos no cluster, esse valor deve ser igual ao número atual de fragmentos.

O processo a seguir descreve como reconfigurar os fragmentos no seu cluster do Valkey ou Redis OSS (modo cluster habilitado) rebalanceando fragmentos por meio da AWS CLI.

**Example - Rebalanceando os fragmentos em um cluster**  
O exemplo a seguir rebalanceia os slots no cluster do Valkey ou Redis OSS (modo cluster habilitado) `my-cluster` de modo que os slots sejam distribuídos da forma mais uniforme possível. O valor de `--node-group-count` (`4`) é o número de fragmentos atualmente no cluster.  
Para Linux, macOS ou Unix:  

```
aws elasticache modify-replication-group-shard-configuration \
    --replication-group-id my-cluster \
    --node-group-count 4 \
    --apply-immediately
```
Para Windows:  

```
aws elasticache modify-replication-group-shard-configuration ^
    --replication-group-id my-cluster ^
    --node-group-count 4 ^
    --apply-immediately
```

#### Rebalanceamento de fragmentos on-line (API) ElastiCache
<a name="redis-cluster-resharding-online-rebalance-api"></a>

Você pode usar a ElastiCache API para reconfigurar os fragmentos em seu cluster Valkey ou Redis OSS (modo de cluster ativado) on-line usando a operação. `ModifyReplicationGroupShardConfiguration`

Use os parâmetros a seguir com `ModifyReplicationGroupShardConfiguration`.

**Parâmetros**
+ `ApplyImmediately=true`: obrigatório. Especifica que a operação de reconfiguração de fragmento começará imediatamente.
+ `ReplicationGroupId`: obrigatório. Especifica em qual grupo de replicação (cluster) a operação de reconfiguração de fragmento será executada.
+ `NodeGroupCount`: obrigatório. Para rebalancear os espaços de chave entre todos os fragmentos no cluster, esse valor deve ser igual ao número atual de fragmentos.

O processo a seguir descreve como reconfigurar os fragmentos em seu cluster Valkey ou Redis OSS (modo de cluster ativado) reequilibrando os fragmentos usando a API. ElastiCache 

**Example - Rebalanceamento do cluster**  
O exemplo a seguir rebalanceia os slots no cluster do Valkey ou Redis OSS (modo cluster habilitado) `my-cluster` de modo que os slots sejam distribuídos da forma mais uniforme possível. O valor de `NodeGroupCount` (`4`) é o número de fragmentos atualmente no cluster.  

```
https://elasticache.us-east-2.amazonaws.com/
    ?Action=ModifyReplicationGroupShardConfiguration
    &ApplyImmediately=true
    &NodeGroupCount=4
    &ReplicationGroupId=my-cluster
    &Version=2015-02-02
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20171002T192317Z
    &X-Amz-Credential=<credential>
```

# Escalabilidade vertical online com modificação do tipo de nó
<a name="redis-cluster-vertical-scaling"></a>

Ao usar a escalabilidade vertical on-line com o Valkey versão 7.2 ou mais recente, ou Redis OSS versão 3.2.10 ou mais recente, você pode escalar clusters do Valkey ou Redis OSS dinamicamente com tempo de inatividade mínimo. Isso permite que o cluster do Valkey ou Redis OSS veicule solicitações mesmo ao ser escalado.

**nota**  
Não há compatibilidade com escalabilidade entre um cluster de classificação de dados em níveis (p. ex., um cluster que use um tipo de nó r6gd) e um cluster sem classificação de dados em níveis (p. ex., um cluster que use um tipo de nó r6g). Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).

Você pode fazer o seguinte:
+ **Aumentar a escala verticalmente**: aumente a capacidade de leitura e gravação ajustando o tipo de nó do cluster do Valkey ou Redis OSS para usar um tipo de nó maior.

  ElastiCache redimensiona dinamicamente seu cluster enquanto permanece on-line e atende às solicitações.
+ **Redução de escala vertical**: reduza a capacidade de leitura e gravação ajustando o tipo de nó para usar um nó menor. Novamente, redimensiona ElastiCache dinamicamente seu cluster enquanto permanece on-line e atende às solicitações. Nesse caso, você reduz os custos diminuindo o nó.

**nota**  
Os processos de expansão e redução dependem da criação de clusters com tipos de nó recém-selecionados e da sincronização dos novos nós com os anteriores. Para garantir um up/down fluxo de escala suave, faça o seguinte:  
Verifique se você tem capacidade suficiente de ENI (interface de rede elástica). Se estiver reduzindo, garanta que o nó menor tenha memória suficiente para absorver o tráfego esperado.   
Para ver as melhores práticas para o gerenciamento da memória, consulte [Gerenciamento de memória reservada para Valkey e Redis OSS](redis-memory-management.md). 
Embora o processo de escalabilidade vertical seja desenvolvido para permanecer totalmente online, ele depende da sincronização dos dados entre o nó antigo e o novo nó. Recomendamos iniciar a expansão/redução no horário em que você acredita que o tráfego de dados seja mínimo. 
Teste o comportamento de seu aplicativo durante a escalabilidade em um ambiente de preparação, se possível. 

**Contents**
+ [

## Aumento de escala vertical online
](#redis-cluster-vertical-scaling-scaling-up)
  + [

### Aumento de escala na vertical de clusters do Valkey ou Redis OSS (console)
](#redis-cluster-vertical-scaling-console)
  + [

### Aumento da escala na vertical de clusters do Valkey ou Redis OSS (AWS CLI)
](#Scaling.RedisStandalone.ScaleUp.CLI)
  + [

### Ampliando clusters OSS Valkey ou Redis (API) ElastiCache
](#VeticalScaling.RedisReplGrps.ScaleUp.API)
+ [

## Redução de escala vertical online
](#redis-cluster-vertical-scaling-scaling-down)
  + [

### Redução de escala na vertical de clusters do Valkey ou Redis OSS (console)
](#redis-cluster-vertical-scaling-down-console)
  + [

### Redução de escala na vertical de clusters do Valkey ou Redis OSS (AWS CLI)
](#Scaling.RedisStandalone.ScaleDown.CLI)
  + [

### Reduzindo a escala de clusters OSS Valkey ou Redis (API) ElastiCache
](#Scaling.Vertical.ScaleDown.API)

## Aumento de escala vertical online
<a name="redis-cluster-vertical-scaling-scaling-up"></a>

**Topics**
+ [

### Aumento de escala na vertical de clusters do Valkey ou Redis OSS (console)
](#redis-cluster-vertical-scaling-console)
+ [

### Aumento da escala na vertical de clusters do Valkey ou Redis OSS (AWS CLI)
](#Scaling.RedisStandalone.ScaleUp.CLI)
+ [

### Ampliando clusters OSS Valkey ou Redis (API) ElastiCache
](#VeticalScaling.RedisReplGrps.ScaleUp.API)

### Aumento de escala na vertical de clusters do Valkey ou Redis OSS (console)
<a name="redis-cluster-vertical-scaling-console"></a>

O procedimento a seguir descreve como escalar um cluster OSS Valkey ou Redis usando o ElastiCache Management Console. Durante esse processo, o cluster continuará a atender solicitações com tempo de inatividade mínimo.

**Para aumentar a escala verticalmente de um cluster do Valkey ou Redis OSS (console)**

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

1. No painel de navegação, escolha **Clusters do Valkey** ou **Clusters do Redis OSS**.

1. Na lista de clusters, escolha o cluster. 

1. Escolha **Modificar**.

1. No assistente **Modify Cluster**:

   1. Na lista **Node type**, escolha o tipo de nó a partir do qual você deseja escalar. Para expandir, selecione um tipo de nó maior do que o nó existente. 

1. Se quiser executar o processo de expansão imediatamente, escolha a caixa **Apply immediately (Aplicar imediatamente)**. Se a caixa **Apply immediately** não for escolhida, o processo de expansão será realizado durante a próxima janela de manutenção desse cluster.

1. Escolha **Modificar**.

   Se você escolheu **Apply immediately** na etapa anterior, o status do cluster mudará para *modifying*. Quando o status mudar para *available*, a modificação estará completa, e você poderá começar a usar o novo cluster.

### Aumento da escala na vertical de clusters do Valkey ou Redis OSS (AWS CLI)
<a name="Scaling.RedisStandalone.ScaleUp.CLI"></a>

O procedimento a seguir descreve como aumentar a escala verticalmente de um cluster do Valkey ou Redis OSS usando a AWS CLI. Durante esse processo, o cluster continuará a atender solicitações com tempo de inatividade mínimo.

**Como aumentar a escala verticalmente de um cluster do Valkey ou Redis OSS (AWS CLI)**

1. Determine os tipos de nós para os quais você pode escalar executando o AWS CLI`list-allowed-node-type-modifications` comando com o parâmetro a seguir.

   Para Linux, macOS ou Unix:

   ```
   aws elasticache list-allowed-node-type-modifications \
   	    --replication-group-id my-replication-group-id
   ```

   Para Windows:

   ```
   aws elasticache list-allowed-node-type-modifications ^
   	    --replication-group-id my-replication-group-id
   ```

   A saída do comando acima é semelhante a esta (formato JSON).

   ```
   {
   	    "ScaleUpModifications": [
   	        "cache.m3.2xlarge", 
   	        "cache.m3.large", 
   	        "cache.m3.xlarge", 
   	        "cache.m4.10xlarge", 
   	        "cache.m4.2xlarge", 
   	        "cache.m4.4xlarge", 
   	        "cache.m4.large", 
   	        "cache.m4.xlarge", 
   	        "cache.r3.2xlarge", 
   	        "cache.r3.4xlarge", 
   	        "cache.r3.8xlarge", 
   	        "cache.r3.large", 
   	        "cache.r3.xlarge"
   	    ]
   	       "ScaleDownModifications": [
   	        "cache.t2.micro", 
   	        "cache.t2.small ", 
   	        "cache.t2.medium",
   	       	"cache.t1.small "
   	    ], 
   }
   ```

   Para obter mais informações, consulte [list-allowed-node-type-modifications](https://docs.aws.amazon.com/cli/latest/reference/elasticache/list-allowed-node-type-modifications.html) na *AWS CLI Referência*.

1. Modifique seu grupo de replicação para escalar até o novo tipo de nó maior usando o AWS CLI`modify-replication-group` comando e os parâmetros a seguir.
   + `--replication-group-id`: o nome do grupo de replicação que você está aumentando a escala vertical. 
   + `--cache-node-type`: o novo tipo de nó para o qual você deseja escalar o cluster. Esse valor deve ser um dos tipos de nós retornados pelo comando `list-allowed-node-type-modifications` na etapa 1.
   + `--cache-parameter-group-name` – [Opcional] Use esse parâmetro se estiver usando `reserved-memory` para gerenciar a memória reservada do cluster. Especifique um parameter group de cache personalizado que reserve a quantidade correta de memória para o seu novo tipo de nó. Se estiver usando `reserved-memory-percent`, você poderá omitir esse parâmetro.
   + `--apply-immediately`: faz com que o processo de aumento de escala vertical seja aplicado imediatamente. Para adiar o processo de expansão para a próxima janela de manutenção do cluster, use o parâmetro `--no-apply-immediately`.

   Para Linux, macOS ou Unix:

   ```
   aws elasticache modify-replication-group  \
   	    --replication-group-id my-redis-cluster \
   	    --cache-node-type cache.m3.xlarge \	    
   	    --apply-immediately
   ```

   Para Windows:

   ```
   aws elasticache modify-replication-group ^
   	    --replication-group-id my-redis-cluster ^
   	    --cache-node-type cache.m3.xlarge ^	   
   	    --apply-immediately
   ```

   A saída do comando acima é semelhante a esta (formato JSON).

   ```
   {
   		"ReplicationGroup": {
           "Status": "modifying",
           "Description": "my-redis-cluster",
           "NodeGroups": [
               {
                   "Status": "modifying",
                   "Slots": "0-16383",
                   "NodeGroupId": "0001",
                   "NodeGroupMembers": [
                       {
                           "PreferredAvailabilityZone": "us-east-1f",
                           "CacheNodeId": "0001",
                           "CacheClusterId": "my-redis-cluster-0001-001"
                       },
                       {
                           "PreferredAvailabilityZone": "us-east-1d",
                           "CacheNodeId": "0001",
                           "CacheClusterId": "my-redis-cluster-0001-002"
                       }
                   ]
               }
           ],
           "ConfigurationEndpoint": {
               "Port": 6379,
               "Address": "my-redis-cluster.r7gdfi.clustercfg.use1.cache.amazonaws.com"
           },
           "ClusterEnabled": true,
           "ReplicationGroupId": "my-redis-cluster",
           "SnapshotRetentionLimit": 1,
           "AutomaticFailover": "enabled",
           "SnapshotWindow": "07:30-08:30",
           "MemberClusters": [
               "my-redis-cluster-0001-001",
               "my-redis-cluster-0001-002"
           ],
           "CacheNodeType": "cache.m3.xlarge",
            "DataTiering": "disabled"
           "PendingModifiedValues": {}
       }
   }
   ```

   Para obter mais informações, consulte [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) na *AWS CLI Referência*.

1. Se você usou o`--apply-immediately`, verifique o status do cluster usando o AWS CLI`describe-cache-clusters` comando com o parâmetro a seguir. Quando o status mudar para *available*, você poderá começar a usar o novo nó de cluster maior.

### Ampliando clusters OSS Valkey ou Redis (API) ElastiCache
<a name="VeticalScaling.RedisReplGrps.ScaleUp.API"></a>

O processo a seguir escala seu cluster do tipo de nó atual para um novo tipo de nó maior usando a ElastiCache API. Durante esse processo, ElastiCache atualiza as entradas de DNS para que elas apontem para os novos nós. Por isso, você não precisa atualizar os endpoints no seu aplicativo. Para o Valkey 7.2 e superiores, Redis OSS 5.0.5 e superiores, você pode escalar clusters habilitados para failover automático enquanto o cluster continua on-line e atendendo a solicitações recebidas. No Redis OSS versão 4.0.10 e anteriores, você pode notar uma breve interrupção de leituras e gravações em versões anteriores do nó primário enquanto a entrada do DNS é atualizada.

O tempo necessário para aumentar a escala verticalmente até um tipo de nó maior varia, dependendo do tipo de nó e da quantidade de dados no seu cluster atual.

**Para escalar um cluster de cache (API) Valkey ou Redis OSS ElastiCache**

1. Determine para quais tipos de nós você pode escalar usando a `ListAllowedNodeTypeModifications` ação da ElastiCache API com o parâmetro a seguir.
   + `ReplicationGroupId` - o nome do grupo de replicação. Use esse parâmetro para descrever um determinado grupo de replicação em vez de todos os grupos de replicação.

   ```
   https://elasticache.us-west-2.amazonaws.com/
   	   ?Action=ListAllowedNodeTypeModifications
   	   &ReplicationGroupId=MyReplGroup
   	   &Version=2015-02-02
   	   &SignatureVersion=4
   	   &SignatureMethod=HmacSHA256
   	   &Timestamp=20150202T192317Z
   	   &X-Amz-Credential=<credential>
   ```

   Para obter mais informações, consulte [ListAllowedNodeTypeModifications](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ListAllowedNodeTypeModifications.html) a *Amazon ElastiCache API Reference*.

1. Dimensione seu grupo de replicação atual até o novo tipo de nó usando a ação da `ModifyReplicationGroup` ElastiCache API e com os parâmetros a seguir.
   + `ReplicationGroupId` - o nome do grupo de replicação.
   + `CacheNodeType`: o novo tipo de nó maior dos clusters nesse grupo de replicação. Esse valor deve ser um dos tipos de instância retornados pela ação `ListAllowedNodeTypeModifications` na etapa anterior.
   + `CacheParameterGroupName` – [Opcional] Use esse parâmetro se estiver usando `reserved-memory` para gerenciar a memória reservada do cluster. Especifique um parameter group de cache personalizado que reserve a quantidade correta de memória para o seu novo tipo de nó. Se estiver usando `reserved-memory-percent`, você poderá omitir esse parâmetro.
   + `ApplyImmediately`: defina como `true` para fazer com que o processo de aumento de escala vertical seja aplicado imediatamente. Para adiar o processo de expansão para a próxima janela de manutenção, use `ApplyImmediately``=false`.

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

   Para obter mais informações, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) a *Amazon ElastiCache API Reference*.

1. Se você usou `ApplyImmediately``=true`, monitore o status do grupo de replicação usando a `DescribeReplicationGroups` ação da ElastiCache API com os parâmetros a seguir. Quando o status mudar de *modifying* para *available*, você poderá começar a gravar no seu novo grupo de replicação expandido.
   + `ReplicationGroupId` - o nome do grupo de replicação. Use esse parâmetro para descrever um grupo de replicação específico em vez de todos os grupos de replicação.

   ```
   https://elasticache.us-west-2.amazonaws.com/
   	   ?Action=DescribeReplicationGroups
   	   &ReplicationGroupId=MyReplGroup
   	   &Version=2015-02-02
   	   &SignatureVersion=4
   	   &SignatureMethod=HmacSHA256
   	   &Timestamp=20150202T192317Z
   	   &X-Amz-Credential=<credential>
   ```

   Para obter mais informações, consulte [DescribeReplicationGroups](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeReplicationGroups.html) a *Amazon ElastiCache API Reference*.

## Redução de escala vertical online
<a name="redis-cluster-vertical-scaling-scaling-down"></a>

**Topics**
+ [

### Redução de escala na vertical de clusters do Valkey ou Redis OSS (console)
](#redis-cluster-vertical-scaling-down-console)
+ [

### Redução de escala na vertical de clusters do Valkey ou Redis OSS (AWS CLI)
](#Scaling.RedisStandalone.ScaleDown.CLI)
+ [

### Reduzindo a escala de clusters OSS Valkey ou Redis (API) ElastiCache
](#Scaling.Vertical.ScaleDown.API)

### Redução de escala na vertical de clusters do Valkey ou Redis OSS (console)
<a name="redis-cluster-vertical-scaling-down-console"></a>

O procedimento a seguir descreve como reduzir um cluster OSS Valkey ou Redis usando o ElastiCache Management Console. Durante esse processo, o cluster do Valkey ou Redis OSS continuará a atender solicitações com tempo de inatividade mínimo.

**Para reduzir a escala verticalmente de um cluster do Valkey ou Redis OSS (console)**

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

1. No painel de navegação, escolha **Clusters do Valkey** ou **Clusters do Redis OSS**.

1. Na lista de clusters, escolha seu cluster preferido. 

1. Escolha **Modificar**.

1. No assistente **Modify Cluster**:

   1. Na lista **Node type**, escolha o tipo de nó a partir do qual você deseja escalar. Para reduzir, selecione um tipo de nó menor do que o nó existente. Observe que nem todos os tipos de nó estão disponíveis para redução.

1. Se quiser executar o processo de redução imediatamente, escolha a caixa **Apply immediately (Aplicar imediatamente)**. Se a caixa **Apply immediately (Aplicar imediatamente)** não for escolhida, o processo de redução será realizado durante a próxima janela de manutenção desse cluster.

1. Escolha **Modificar**.

   Se você escolheu **Apply immediately** na etapa anterior, o status do cluster mudará para *modifying*. Quando o status mudar para *available*, a modificação estará completa, e você poderá começar a usar o novo cluster.

### Redução de escala na vertical de clusters do Valkey ou Redis OSS (AWS CLI)
<a name="Scaling.RedisStandalone.ScaleDown.CLI"></a>

O procedimento a seguir descreve como reduzir a escala verticalmente de um cluster do Valkey ou Redis OSS usando a AWS CLI. Durante esse processo, o cluster continuará a atender solicitações com tempo de inatividade mínimo.

**Como reduzir a escala verticalmente de um cluster do Valkey ou Redis OSS (AWS CLI)**

1. Determine os tipos de nós para os quais você pode reduzir executando o AWS CLI`list-allowed-node-type-modifications` comando com o parâmetro a seguir.

   Para Linux, macOS ou Unix:

   ```
   aws elasticache list-allowed-node-type-modifications \
   	    --replication-group-id my-replication-group-id
   ```

   Para Windows:

   ```
   aws elasticache list-allowed-node-type-modifications ^
   	    --replication-group-id my-replication-group-id
   ```

   A saída do comando acima é semelhante a esta (formato JSON).

   ```
   {
   	    "ScaleUpModifications": [
   	        "cache.m3.2xlarge", 
   	        "cache.m3.large", 
   	        "cache.m3.xlarge", 
   	        "cache.m4.10xlarge", 
   	        "cache.m4.2xlarge", 
   	        "cache.m4.4xlarge", 
   	        "cache.m4.large", 
   	        "cache.m4.xlarge", 
   	        "cache.r3.2xlarge", 
   	        "cache.r3.4xlarge", 
   	        "cache.r3.8xlarge", 
   	        "cache.r3.large", 
   	        "cache.r3.xlarge"
   	    ]
   	
   	       "ScaleDownModifications": [
   	        "cache.t2.micro", 
   	        "cache.t2.small ", 
   	        "cache.t2.medium ",
     	      "cache.t1.small"
   	    ]
   }
   ```

   Para obter mais informações, consulte [list-allowed-node-type-modifications](https://docs.aws.amazon.com/cli/latest/reference/elasticache/list-allowed-node-type-modifications.html) na *AWS CLI Referência*.

1. Modifique seu grupo de replicação para reduzi-lo ao novo tipo de nó menor, usando o AWS CLI`modify-replication-group` comando e os parâmetros a seguir.
   + `--replication-group-id`: o nome do grupo de replicação que você está reduzindo a escala na vertical. 
   + `--cache-node-type`: o novo tipo de nó para o qual você deseja escalar o cluster. Esse valor deve ser um dos tipos de nós retornados pelo comando `list-allowed-node-type-modifications` na etapa 1.
   + `--cache-parameter-group-name` – [Opcional] Use esse parâmetro se estiver usando `reserved-memory` para gerenciar a memória reservada do cluster. Especifique um parameter group de cache personalizado que reserve a quantidade correta de memória para o seu novo tipo de nó. Se estiver usando `reserved-memory-percent`, você poderá omitir esse parâmetro.
   + `--apply-immediately`: faz com que o processo de aumento de escala vertical seja aplicado imediatamente. Para adiar o processo de redução para a próxima janela de manutenção do cluster, use o parâmetro `--no-apply-immediately`.

   Para Linux, macOS ou Unix:

   ```
   aws elasticache modify-replication-group  \
   	    --replication-group-id my-redis-cluster \
   	    --cache-node-type cache.t2.micro \	    
   	    --apply-immediately
   ```

   Para Windows:

   ```
   aws elasticache modify-replication-group ^
   	    --replication-group-id my-redis-cluster ^
   	    --cache-node-type cache.t2.micro ^	   
   	    --apply-immediately
   ```

   A saída do comando acima é semelhante a esta (formato JSON).

   ```
   {	
   		"ReplicationGroup": {
           "Status": "modifying",
           "Description": "my-redis-cluster",
           "NodeGroups": [
               {
                   "Status": "modifying",
                   "Slots": "0-16383",
                   "NodeGroupId": "0001",
                   "NodeGroupMembers": [
                       {
                           "PreferredAvailabilityZone": "us-east-1f",
                           "CacheNodeId": "0001",
                           "CacheClusterId": "my-redis-cluster-0001-001"
                       },
                       {
                           "PreferredAvailabilityZone": "us-east-1d",
                           "CacheNodeId": "0001",
                           "CacheClusterId": "my-redis-cluster-0001-002"
                       }
                   ]
               }
           ],
           "ConfigurationEndpoint": {
               "Port": 6379,
               "Address": "my-redis-cluster.r7gdfi.clustercfg.use1.cache.amazonaws.com"
           },
           "ClusterEnabled": true,
           "ReplicationGroupId": "my-redis-cluster",
           "SnapshotRetentionLimit": 1,
           "AutomaticFailover": "enabled",
           "SnapshotWindow": "07:30-08:30",
           "MemberClusters": [
               "my-redis-cluster-0001-001",
               "my-redis-cluster-0001-002"
           ],
           "CacheNodeType": "cache.t2.micro",
            "DataTiering": "disabled"
           "PendingModifiedValues": {}
       }
   }
   ```

   Para obter mais informações, consulte [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) na *AWS CLI Referência*.

1. Se você usou o`--apply-immediately`, verifique o status do cluster usando o AWS CLI`describe-cache-clusters` comando com o parâmetro a seguir. Quando o status mudar para *available*, você poderá começar a usar o novo nó de cluster menor.

### Reduzindo a escala de clusters OSS Valkey ou Redis (API) ElastiCache
<a name="Scaling.Vertical.ScaleDown.API"></a>

O processo a seguir escala seu grupo de replicação do tipo de nó atual para um novo tipo de nó menor usando a ElastiCache API. Durante esse processo, o cluster do Valkey ou Redis OSS continuará a atender solicitações com tempo de inatividade mínimo.

O tempo necessário para reduzir a escala verticalmente até um tipo de nó menor varia, dependendo do tipo de nó e da quantidade de dados no seu cluster atual.

**Redução de escala (ElastiCache API)**

1. Determine quais tipos de nós você pode reduzir usando a `ListAllowedNodeTypeModifications` ação da ElastiCache API com o parâmetro a seguir.
   + `ReplicationGroupId` - o nome do grupo de replicação. Use esse parâmetro para descrever um determinado grupo de replicação em vez de todos os grupos de replicação.

   ```
   https://elasticache.us-west-2.amazonaws.com/
   	   ?Action=ListAllowedNodeTypeModifications
   	   &ReplicationGroupId=MyReplGroup
   	   &Version=2015-02-02
   	   &SignatureVersion=4
   	   &SignatureMethod=HmacSHA256
   	   &Timestamp=20150202T192317Z
   	   &X-Amz-Credential=<credential>
   ```

   Para obter mais informações, consulte [ListAllowedNodeTypeModifications](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ListAllowedNodeTypeModifications.html) a *Amazon ElastiCache API Reference*.

1. Reduza seu grupo de replicação atual para o novo tipo de nó usando a ação da `ModifyReplicationGroup` ElastiCache API e com os parâmetros a seguir.
   + `ReplicationGroupId` - o nome do grupo de replicação.
   + `CacheNodeType`: o novo tipo de nó menor dos clusters nesse grupo de replicação. Esse valor deve ser um dos tipos de instância retornados pela ação `ListAllowedNodeTypeModifications` na etapa anterior.
   + `CacheParameterGroupName` – [Opcional] Use esse parâmetro se estiver usando `reserved-memory` para gerenciar a memória reservada do cluster. Especifique um parameter group de cache personalizado que reserve a quantidade correta de memória para o seu novo tipo de nó. Se estiver usando `reserved-memory-percent`, você poderá omitir esse parâmetro.
   + `ApplyImmediately`: defina como `true` para fazer com que o processo de redução seja aplicado imediatamente. Para adiar o processo de redução até a próxima janela de manutenção, use `ApplyImmediately``=false`.

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

   Para obter mais informações, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) a *Amazon ElastiCache API Reference*.