

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

# Escalar nós de réplica para Valkey ou Redis OSS (modo cluster desativado)
<a name="Scaling.RedisReplGrps"></a>

Um cluster Valkey ou Redis OSS com nós de réplica (chamado de *grupo de replicação* na API/CLI) fornece alta disponibilidade por meio de uma replicação que possui o recurso Multi-AZ com failover automático habilitado. Um cluster com nós de réplica é um conjunto lógico de até seis clusters Valkey ou Redis OSS em que um nó, o primário, pode atender a solicitações de leitura e gravação. Todos os outros nós do cluster são réplicas somente leitura do primário. Os dados escritos no primário são replicados de forma assíncrona para todas as réplicas de leitura no cluster. Como o Valkey ou Redis OSS (modo cluster desabilitado) não oferece suporte ao particionamento dos seus dados em vários clusters, cada nó em um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) contém todo o conjunto de dados do cache. Clusters do Valkey ou Redis OSS (modo cluster habilitado) oferecem suporte para o particionamento dos seus dados até 500 fragmentos.

Para alterar a capacidade de dados do seu cluster, você deve expandi-lo para um tipo de nó maior ou reduzi-lo para um tipo de nó menor.

Para alterar a capacidade de leitura do seu cluster, adicione mais réplicas de leitura, até um máximo de 5, ou remova réplicas de leitura.

O processo ElastiCache de escalabilidade foi projetado para fazer o melhor esforço para reter seus dados existentes e requer uma replicação bem-sucedida do Valkey ou do Redis OSS. Para clusters Valkey ou Redis OSS com réplicas, recomendamos que uma memória suficiente seja disponibilizada para o Valkey ou Redis OSS. 

**Topics**
+ [Aumento de escala vertical de clusters do Valkey ou Redis OSS com réplicas](#Scaling.RedisReplGrps.ScaleUp)
+ [Redução de escala vertical de clusters do Valkey ou Redis OSS com réplicas](#Scaling.RedisReplGrps.ScaleDown)
+ [Aumento da capacidade de leitura](#Scaling.RedisReplGrps.ScaleOut)
+ [Redução da capacidade de leitura](#Scaling.RedisReplGrps.ScaleIn)

**Related Topics**
+ [Alta disponibilidade com o uso de grupos de replicação](Replication.md)
+ [Replicação: Modo de cluster Valkey e Redis OSS desativado versus ativado](Replication.Redis-RedisCluster.md)
+ [Minimizar o tempo de inatividade no ElastiCache usando o Multi-AZ com Valkey e Redis OSS](AutoFailover.md)
+ [Garantir que você tem memória suficiente para criar um snapshot do Valkey ou Redis OSS](BestPractices.BGSAVE.md)

**Topics**
+ [Aumento de escala vertical de clusters do Valkey ou Redis OSS com réplicas](#Scaling.RedisReplGrps.ScaleUp)
+ [Redução de escala vertical de clusters do Valkey ou Redis OSS com réplicas](#Scaling.RedisReplGrps.ScaleDown)
+ [Aumento da capacidade de leitura](#Scaling.RedisReplGrps.ScaleOut)
+ [Redução da capacidade de leitura](#Scaling.RedisReplGrps.ScaleIn)

## Aumento de escala vertical de clusters do Valkey ou Redis OSS com réplicas
<a name="Scaling.RedisReplGrps.ScaleUp"></a>

 ElastiCache A Amazon fornece suporte de console, CLI e API para escalar seu grupo de replicação Valkey ou Redis OSS (modo de cluster desativado). 

Quando o processo de aumento de escala é iniciado, ElastiCache faça o seguinte:

1. Executa um grupo de replicação usando o novo tipo de nó.

1. Copia todos os dados do nó primário atual para o novo nó primário.

1. Sincroniza as novas réplicas de leitura com o novo nó primário.

1. Atualiza as entradas do 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 ou 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ê perceberá uma breve interrupção de leituras e gravações em versões anteriores do nó primário enquanto a entrada de DNS é atualizada. 

1. Exclui os nós antigos (CLI/API: grupo de replicação). Você perceberá uma breve interrupção (alguns segundos) nas leituras e gravações dos nós antigos porque as conexões aos nós antigos serão desconectadas.

O tempo necessário para esse processo depende do tipo de nó e da quantidade de dados no seu cluster.

Conforme mostrado na tabela a seguir, sua operação de expansão do Valkey ou Redis OSS será bloqueada se você tiver uma atualização do mecanismo programada para a próxima janela de manutenção do cluster.


**Operações bloqueadas do Valkey ou do Redis OSS**  


- **Amplie a sua capacidade**
  - Atualização imediata do mecanismo

- **Atualização do mecanismo**
  - Expansão imediata

- **Expansão e atualização do mecanismo**
  - Expansão imediata
  - Atualização imediata do mecanismo



Se você tiver uma operação pendente que está bloqueando você, será possível tomar uma destas providências.
+ Planeje sua operação de expansão do Valkey ou Redis OSS para a próxima janela de manutenção, desmarcando a caixa de seleção **Apply immediately** (CLI use: `--no-apply-immediately`, API use: `ApplyImmediately=false`).
+ Aguarde até sua próxima janela de manutenção (ou depois) para realizar sua operação de expansão do Valkey ou Redis OSS.
+ Adicione a atualização do mecanismo Valkey ou Redis OSS a essa modificação de cluster com a caixa de seleção **Apply Immediately** (Aplicar imediatamente) marcada (CLI use: `--apply-immediately`, API use: `ApplyImmediately=true`). Isso desbloqueia sua operação de expansão, fazendo com que a atualização do mecanismo seja realizada imediatamente.

As seções a seguir descrevem como escalar seu cluster OSS Valkey ou Redis com réplicas usando o ElastiCache console, o e a API AWS CLI. ElastiCache 

**Importante**  
Se o seu parameter group usar `reserved-memory` para reservar a memória para a sobrecarga do Valkey ou Redis OSS, antes de iniciar a escalabilidade, certifique-se de ter um parameter group personalizado que reserve a quantidade correta de memória para o seu novo tipo de nó. Como alternativa, você pode modificar um parameter group personalizado para que ele use `reserved-memory-percent` e usar esse parameter group para seu novo cluster.  
Se você estiver usando `reserved-memory-percent`, não será necessário fazer isso.   
Para obter mais informações, consulte [Gerenciamento de memória reservada para Valkey e Redis OSS](redis-memory-management.md).

### Aumento de escala vertical de um cluster do Valkey ou Redis OSS com réplicas (console)
<a name="Scaling.RedisReplGrps.ScaleUp.CON"></a>

O tempo necessário para expandir para um tipo de nó maior varia dependendo do tipo de nó e da quantidade de dados no seu cluster atual.

O processo a seguir escala seu cluster com réplicas do tipo de nó atual para um novo tipo de nó maior usando o ElastiCache console. Durante esse processo, poderá haver uma breve interrupção de leituras e gravações de outras versões do nó primário enquanto a entrada de DNS é atualizada. Talvez você observe menos de 1 segundo de tempo de inatividade para os nós executados nas versões 5.0.5 e posteriores e alguns segundos para as versões mais antigas. 

**Para aumentar a escala vertical de um cluster do Valkey ou Redis OSS com réplicas (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 que você deseja expandir. Esse cluster deve estar executando o mecanismo Valkey ou Redis OSS, e não o mecanismo clustered Valkey ou Redis OSS.

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. Observe que nem todos os tipos de nó estão disponíveis para redução.

   1. Se você estiver usando `reserved-memory` para gerenciar sua memória, na lista **Parameter Group**, escolha o parameter group personalizado que reserva a quantidade correta de memória para o seu novo tipo de nó.

1. Se quiser executar o processo de expansão imediatamente, escolha a caixa de seleção **Apply immediately**. Se a caixa de seleção **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**.

1. Quando o status do cluster muda de *modifying* para *available*, significa que o seu cluster foi escalonado para o novo tipo de nó. Não é necessário atualizar os endpoints no seu aplicativo.

### Aumento de escala vertical de um grupo de replicação do Valkey ou Redis OSS (AWS CLI)
<a name="Scaling.RedisReplGrps.ScaleUp.CLI"></a>

O processo a seguir dimensiona o grupo de replicação do tipo de nó atual para um novo tipo de nó maior usando a AWS CLI. 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 ou 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. Nas versões 4.0.10 e anteriores, você perceberá uma breve interrupção de leituras e gravações em versões anteriores do nó primário enquanto a entrada de 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 aumentar a escala verticalmente de um grupo de replicação Valkey ou Redis OSS (AWS CLI)**

1. Determine para quais tipos de nós você pode escalar executando o AWS CLI`list-allowed-node-type-modifications` comando com o parâmetro a seguir.
   + `--replication-group-id` - 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.

   Para Linux, macOS ou Unix:

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

   Para Windows:

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

   O resultado dessa operação é semelhante a este (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"
   	    ]
   	}
   ```

   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. Dimensione seu grupo de replicação atual até o novo tipo de nó usando o AWS CLI`modify-replication-group` comando com os parâmetros a seguir.
   + `--replication-group-id` - o nome do grupo de replicação.
   + `--cache-node-type`: o novo tipo de nó maior dos clusters nesse grupo de replicação. Esse valor deve ser um dos tipos de instância retornados pelo comando `list-allowed-node-type-modifications` na etapa anterior.
   + `--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 a operação de expansão para a próxima janela de manutenção, use `--no-apply-immediately`.

   Para Linux, macOS ou Unix:

   ```
   aws elasticache modify-replication-group \
   	    --replication-group-id {{my-repl-group}} \
   	    --cache-node-type {{cache.m3.xlarge}} \
   	    --cache-parameter-group-name {{redis32-m3-2xl}} \
   	    --apply-immediately
   ```

   Para Windows:

   ```
   aws elasticache modify-replication-group ^
   	    --replication-group-id {{my-repl-group}} ^
   	    --cache-node-type {{cache.m3.xlarge}} ^
   	    --cache-parameter-group-name {{redis32-m3-2xl}} \
   	    --apply-immediately
   ```

   O resultado desse comando é semelhante a este (formato JSON).

   ```
   {
   	"ReplicationGroup": {
   		"Status": "available",
   		"Description": "Some description",
   		"NodeGroups": [{
   			"Status": "available",
   			"NodeGroupMembers": [{
   					"CurrentRole": "primary",
   					"PreferredAvailabilityZone": "us-west-2b",
   					"CacheNodeId": "0001",
   					"ReadEndpoint": {
   						"Port": 6379,
   						"Address": "my-repl-group-001.8fdx4s.0001.usw2.cache.amazonaws.com"
   					},
   					"CacheClusterId": "my-repl-group-001"
   				},
   				{
   					"CurrentRole": "replica",
   					"PreferredAvailabilityZone": "us-west-2c",
   					"CacheNodeId": "0001",
   					"ReadEndpoint": {
   						"Port": 6379,
   						"Address": "my-repl-group-002.8fdx4s.0001.usw2.cache.amazonaws.com"
   					},
   					"CacheClusterId": "my-repl-group-002"
   				}
   			],
   			"NodeGroupId": "0001",
   			"PrimaryEndpoint": {
   				"Port": 6379,
   				"Address": "my-repl-group.8fdx4s.ng.0001.usw2.cache.amazonaws.com"
   			}
   		}],
   		"ReplicationGroupId": "my-repl-group",
   		"SnapshotRetentionLimit": 1,
   		"AutomaticFailover": "disabled",
   		"SnapshotWindow": "12:00-13:00",
   		"SnapshottingClusterId": "my-repl-group-002",
   		"MemberClusters": [
   			"my-repl-group-001",
   			"my-repl-group-002"
   		],
   		"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` parâmetro, monitore o status do grupo de replicação usando o AWS CLI`describe-replication-group` comando com o parâmetro a seguir. Enquanto o status ainda for *modifying* (em modificação), você poderá observar menos de 1 segundo de tempo de inatividade para os nós executados nas versões 5.0.6 e posteriores, e uma breve interrupção de leituras e gravações para as versões mais antigas do nó primário enquanto a entrada do DNS é atualizada.
   + `--replication-group-id` - 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.

   Para Linux, macOS ou Unix:

   ```
   aws elasticache describe-replication-groups \
   	    --replication-group-id {{my-replication-group}}
   ```

   Para Windows:

   ```
   aws elasticache describe-replication-groups ^
   	    --replication-group-id {{my-replication-group}}
   ```

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

### Escalando um grupo de replicação (API) Valkey ou Redis OSS ElastiCache
<a name="Scaling.RedisReplGrps.ScaleUp.API"></a>

O processo a seguir escala seu grupo de replicação do tipo de nó atual para um novo tipo de nó maior usando a ElastiCache API. Para o Valkey 7.2 e superiores ou 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 grupo de replicação (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 de clusters do Valkey ou Redis OSS com réplicas
<a name="Scaling.RedisReplGrps.ScaleDown"></a>

As seções a seguir demonstram passo a passo o processo de reduzir a escala vertical de um cluster Valkey ou Redis OSS (modo cluster desabilitado) com nós de réplica para um tipo de nó menor. Garantir que o novo tipo de nó menor seja suficientemente grande para acomodar todos os dados e a sobrecarga é muito importante para o sucesso. Para obter mais informações, consulte [Garantir que você tem memória suficiente para criar um snapshot do Valkey ou Redis OSS](BestPractices.BGSAVE.md).

**nota**  
Para clusters que executam o tipo de nó r6gd, você só pode escalar para tamanhos de nó dentro da família de nós r6gd.

**Importante**  
Se o seu parameter group usar `reserved-memory` para reservar a memória para a sobrecarga do Valkey ou Redis OSS, antes de iniciar a escalabilidade, certifique-se de ter um parameter group personalizado que reserve a quantidade correta de memória para o seu novo tipo de nó. Como alternativa, você pode modificar um parameter group personalizado para que ele use `reserved-memory-percent` e usar esse parameter group para seu novo cluster.  
Se você estiver usando `reserved-memory-percent`, não será necessário fazer isso.   
Para obter mais informações, consulte [Gerenciamento de memória reservada para Valkey e Redis OSS](redis-memory-management.md).

**Topics**

### Redução de escala vertical de um cluster do Valkey ou Redis OSS com réplicas (console)
<a name="Scaling.RedisReplGrps.ScaleDown.CON"></a>

O processo a seguir dimensiona seu cluster OSS Valkey ou Redis com nós de réplica para um tipo de nó menor usando o console. ElastiCache 

**Para reduzir a escala vertical um cluster do Valkey ou Redis OSS com nós de réplica (console)**

1. Certifique-se de que o tipo de nó menor seja adequado para suas necessidades de dados e sobrecarga. 

1. Se o seu parameter group usar `reserved-memory` para reservar memória para a sobrecarga do Valkey ou Redis OSS, certifique-se de ter um parameter group personalizado para reservar a quantidade correta de memória para o seu novo tipo de nó.

   Alternativamente, você pode modificar seu parameter group personalizado para usar `reserved-memory-percent`. Para obter mais informações, consulte [Gerenciamento de memória reservada para Valkey e Redis OSS](redis-memory-management.md).

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. Na lista de clusters, escolha o cluster que você deseja reduzir. Esse cluster deve estar executando o mecanismo Valkey ou Redis OSS, e não o mecanismo clustered Valkey ou Redis OSS.

1. Escolha **Modificar**.

1. No assistente **Modify Cluster**:

   1. Na lista **Node type (Tipo de nó)**, escolha o tipo de nó para o qual deseja reduzir.

   1. Se você estiver usando `reserved-memory` para gerenciar sua memória, na lista **Parameter Group**, escolha o parameter group personalizado que reserva a quantidade correta de memória para o seu novo tipo de nó.

1. Se desejar executar o processo de redução imediatamente, escolha a caixa de seleção **Apply immediately (Aplicar imediatamente)**. Se a caixa de seleção **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**.

1. Quando o status do cluster muda de *modifying* para *available*, significa que o seu cluster foi escalonado para o novo tipo de nó. Não é necessário atualizar os endpoints no seu aplicativo.

### Redução de escala vertical de um grupo de replicação do Valkey ou Redis OSS (AWS CLI)
<a name="Scaling.RedisReplGrps.ScaleUp.CLI"></a>

O processo a seguir dimensiona grupo de replicação do tipo de nó atual para um novo tipo de nó menor usando a AWS CLI. 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 ou 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. Nas versões 4.0.10 e anteriores, você perceberá uma breve interrupção de leituras e gravações em versões anteriores do nó primário enquanto a entrada de DNS é atualizada.

No entanto, as leituras dos clusters de réplica de leitura continuam ininterruptas.

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.

**Para reduzir a escala verticalmente de um grupo de replicação do Valkey ou Redis OSS (AWS CLI)**

1. Determine para quais tipos de nós você pode reduzir executando o AWS CLI`list-allowed-node-type-modifications` comando com o parâmetro a seguir.
   + `--replication-group-id` - 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.

   Para Linux, macOS ou Unix:

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

   Para Windows:

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

   O resultado dessa operação é semelhante a este (formato JSON).

   ```
   {
   	    "ScaleDownModifications": [
   	        "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"
   	    ]
   	}
   ```

   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. Dimensione seu grupo de replicação atual até o novo tipo de nó usando o AWS CLI`modify-replication-group` comando com os parâmetros a seguir.
   + `--replication-group-id` - o nome do grupo de replicação.
   + `--cache-node-type`: o novo tipo de nó menor dos clusters nesse grupo de replicação. Esse valor deve ser um dos tipos de instância retornados pelo comando `list-allowed-node-type-modifications` na etapa anterior.
   + `--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 a operação de expansão para a próxima janela de manutenção, use `--no-apply-immediately`.

   Para Linux, macOS ou Unix:

   ```
   aws elasticache modify-replication-group \
   	    --replication-group-id {{my-repl-group}} \
   	    --cache-node-type {{cache.t2.small }} \
   	    --cache-parameter-group-name {{redis32-m3-2xl}} \
   	    --apply-immediately
   ```

   Para Windows:

   ```
   aws elasticache modify-replication-group ^
   	    --replication-group-id {{my-repl-group}} ^
   	    --cache-node-type {{cache.t2.small }} ^
   	    --cache-parameter-group-name {{redis32-m3-2xl}} \
   	    --apply-immediately
   ```

   O resultado desse comando é semelhante a este (formato JSON).

   ```
   {"ReplicationGroup": {
   	        "Status": "available", 
   	        "Description": "Some description", 
   	        "NodeGroups": [
   	            {
   	                "Status": "available", 
   	                "NodeGroupMembers": [
   	                    {
   	                        "CurrentRole": "primary", 
   	                        "PreferredAvailabilityZone": "us-west-2b", 
   	                        "CacheNodeId": "0001", 
   	                        "ReadEndpoint": {
   	                            "Port": 6379, 
   	                            "Address": "my-repl-group-001.8fdx4s.0001.usw2.cache.amazonaws.com"
   	                        }, 
   	                        "CacheClusterId": "my-repl-group-001"
   	                    }, 
   	                    {
   	                        "CurrentRole": "replica", 
   	                        "PreferredAvailabilityZone": "us-west-2c", 
   	                        "CacheNodeId": "0001", 
   	                        "ReadEndpoint": {
   	                            "Port": 6379, 
   	                            "Address": "my-repl-group-002.8fdx4s.0001.usw2.cache.amazonaws.com"
   	                        }, 
   	                        "CacheClusterId": "my-repl-group-002"
   	                    }
   	                ], 
   	                "NodeGroupId": "0001", 
   	                "PrimaryEndpoint": {
   	                    "Port": 6379, 
   	                    "Address": "my-repl-group.8fdx4s.ng.0001.usw2.cache.amazonaws.com"
   	                }
   	            }
   	        ], 
   	        "ReplicationGroupId": "my-repl-group", 
   	        "SnapshotRetentionLimit": 1, 
   	        "AutomaticFailover": "disabled", 
   	        "SnapshotWindow": "12:00-13:00", 
   	        "SnapshottingClusterId": "my-repl-group-002", 
   	        "MemberClusters": [
   	            "my-repl-group-001", 
   	            "my-repl-group-002", 
   	        ], 
   	        "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` parâmetro, monitore o status do grupo de replicação usando o AWS CLI`describe-replication-group` comando com o parâmetro a seguir. Quando o status mudar de *modifying (modificando)* para *available (disponível)*, você poderá começar a gravar no seu novo grupo de replicação reduzido.
   + `--replication-group-id` - 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.

   Para Linux, macOS ou Unix:

   ```
   aws elasticache describe-replication-group \
   	    --replication-group-id {{my-replication-group}}
   ```

   Para Windows:

   ```
   aws elasticache describe-replication-groups ^
   	    --replication-group-id {{my-replication-group}}
   ```

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

### Reduzindo um grupo de replicação (API) do Valkey ou do Redis OSS ElastiCache
<a name="Scaling.RedisReplGrps.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, 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 ou 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ê perceberá uma breve interrupção de leituras e gravações em versões anteriores do nó primário enquanto a entrada de DNS é atualizada. No entanto, as leituras dos clusters de réplica de leitura continuam ininterruptas.

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.

**Para reduzir um grupo de replicação (API) Valkey ou Redis OSS ElastiCache**

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. 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ó 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 aumento de escala vertical 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.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 (modificando)* para *available (disponível)*, você poderá começar a gravar no seu novo grupo de replicação reduzido.
   + `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*.

## Aumento da capacidade de leitura
<a name="Scaling.RedisReplGrps.ScaleOut"></a>

Para aumentar a capacidade de leitura, adicione réplicas de leitura (até um máximo de cinco) ao seu grupo de replicação Valkey ou Redis OSS.

Você pode escalar a capacidade de leitura do cluster Valkey ou Redis OSS usando o ElastiCache console AWS CLI, o ou a API. ElastiCache Para obter mais informações, consulte [Adição de uma réplica de leitura do Valkey ou do Redis OSS (modo cluster desabilitado)](Replication.AddReadReplica.md).

## Redução da capacidade de leitura
<a name="Scaling.RedisReplGrps.ScaleIn"></a>

Para diminuir a capacidade de leitura, exclua uma ou mais réplicas de leitura do seu cluster Valkey ou Redis OSS com réplicas (chamado de *grupo de replicação* na API/CLI). Se o cluster for habilitado para Multi-AZ com failover automático, não será possível excluir a última réplica de leitura sem primeiro desabilitar o Multi-AZ. Para obter mais informações, consulte [Modificação de um grupo de replicação](Replication.Modify.md).

Para obter mais informações, consulte [Exclusão de uma réplica de leitura do Valkey ou do Redis OSS (modo cluster desabilitado)](Replication.RemoveReadReplica.md).