Diminuição do número de réplicas em um fragmento - Amazon ElastiCache
Usando o AWS Management ConsoleUsando o AWS CLIUsando a ElastiCache API

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

Diminuição do número de réplicas em um fragmento

Você pode reduzir o número de réplicas em um fragmento do Valkey ou do Redis OSS (modo cluster habilitado) ou em um grupo de replicação do Valkey ou do Redis OSS (modo cluster desabilitado):

  • Para o Valkey ou Redis OSS (modo cluster desabilitado), é possível reduzir o número de réplicas para um, caso o multi-AZ esteja habilitado, e para zero, caso ele não esteja habilitado.

  • Para o Valkey ou Redis OSS (modo cluster habilitado), você pode diminuir o número de réplicas para zero. No entanto, você não pode fazer failover para uma réplica, caso o nó primário falhe.

Você pode usar o AWS Management Console, o AWS CLI ou a ElastiCache API para diminuir o número de réplicas em um grupo de nós (fragmento) ou grupo de replicação.

Usando o AWS Management Console

O procedimento a seguir usa o console para reduzir o número de réplicas em um grupo de replicação do Valkey ou do Redis OSS (modo cluster habilitado).

Para diminuir o número de réplicas em um fragmento do Valkey ou Redis OSS

  1. Faça login no AWS Management Console e abra o ElastiCache console em https://console.aws.amazon.com/elasticache/.

  2. No painel de navegação, escolha Valkey ou Redis OSS e o nome do grupo de replicação do qual você deseja excluir réplicas.

  3. Escolha a caixa de cada estilhaço de que você deseja excluir um nó de réplica.

  4. Escolha Delete replicas (Excluir réplicas).

  5. Conclua a página Delete Replicas from Shards (Excluir réplicas de estilhaços):

    1. Em New number of replicas/shard (Novo número de réplicas/estilhaço), informe o número de réplicas que os estilhaços selecionados devem ter. Esse número deve ser maior que ou igual a 1. Recomendamos pelo menos duas réplicas por estilhaço para trabalho mínimo.

    2. Escolha Delete (Excluir) a fim de excluir as réplicas ou Cancel (Cancelar) a fim de cancelar a operação.

Importante

  • Se você não especificar os nós de réplica a serem excluídos, ElastiCache para Redis, o OSS selecionará automaticamente os nós de réplica para exclusão. Ao fazer isso, ElastiCache para Redis, o OSS tenta manter a arquitetura Multi-AZ para seu grupo de replicação, seguida pela retenção de réplicas com atraso mínimo de replicação com o primário.

  • Não é possível excluir o primário ou os nós primários em um grupo de replicação. Se você especificar o nó primário para exclusão, a operação falhará com um evento de erro indicando que o nó primário foi selecionado para exclusão.

Usando o AWS CLI

Para diminuir o número de réplicas em um fragmento do Valkey ou Redis OSS, use o comando decrease-replica-count com os seguintes parâmetros:

  • --replication-group-id: obrigatório. Identifica em qual grupo de replicação você deseja diminuir o número de réplicas.

  • --apply-immediately ou --no-apply-immediately: obrigatório. Especifica se é necessário diminuir a contagem de réplicas imediatamente (--apply-immediately) ou na próxima janela de manutenção (--no-apply-immediately). Atualmente, --no-apply-immediately não é suportado.

  • --new-replica-count: optional. Especifica o número de nós de réplica desejado. O valor de --new-replica-count deve ser um valor válido menos o número atual de réplicas nos grupos de nós. Para valores permitidos mínimos, consulte Diminuição do número de réplicas em um fragmento. Caso o valor de --new-replica-count não atenda a esse requisito, a chama falha.

  • --replicas-to-remove: optional. Contém uma lista de nós IDs especificando os nós de réplica a serem removidos.

  • --replica-configuration: optional. Permite definir o número de réplicas e as zonas de disponibilidade de cada grupo de nós independentemente. Use este parâmetro em grupos do Valkey ou Redis OSS (modo cluster habilitado) onde você deseja configurar cada grupo de nós independentemente.

    --replica-configuration tem três membros opcionais:

    • NodeGroupId: o ID de quatro dígitos do grupo de nós que você está configurando. Para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado), o ID de fragmento é sempre 0001. Para encontrar o ID de um grupo de nós (fragmento) do Valkey ou Redis OSS (modo cluster habilitado), consulte Localização de um ID de fragmento.

    • NewReplicaCount: um parâmetro opcional que especifica o número de nós de réplica desejado. O valor de NewReplicaCount deve ser um valor válido menos o número atual de réplicas nos grupos de nós. Para valores permitidos mínimos, consulte Diminuição do número de réplicas em um fragmento. Caso o valor de NewReplicaCount não atenda a esse requisito, a chama falha.

    • PreferredAvailabilityZones: uma lista de strings de PreferredAvailabilityZone que especificam em quais zonas de disponibilidade os nós do grupo de replicação estão. O número de valores PreferredAvailabilityZone deve ser igual ao valor de NewReplicaCount mais 1 para contabilizar o nó primário. Se esse membro do --replica-configuration for omitido, ElastiCache para Redis, o OSS escolhe a Zona de Disponibilidade para cada uma das novas réplicas.

Importante

Você deve incluir um, e somente um, parâmetro --new-replica-count, --replicas-to-remove, ou --replica-configuration.

O exemplo a seguir usa --new-replica-count para diminuir o número de réplicas no grupo de replicação sample-repl-group para um. Quando o exemplo é concluído, existe uma réplica em cada grupo de nós. Esse número se aplica caso este seja um grupo do Valkey ou Redis OSS (modo cluster desabilitado) com um grupo de nós único ou um grupo do Valkey ou Redis OSS (modo cluster habilitado) com vários grupos de nós.

Para Linux, macOS ou Unix:

aws elasticache decrease-replica-count
    --replication-group-id sample-repl-group \
    --new-replica-count 1 \
    --apply-immediately

Para Windows:

aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 1 ^
    --apply-immediately

O exemplo a seguir diminui o número de réplicas no grupo de replicação sample-repl-group removendo duas réplicas especificadas (0001 e 0003) do grupo de nós.

Para Linux, macOS ou Unix:

aws elasticache decrease-replica-count \
    --replication-group-id sample-repl-group \
    --replicas-to-remove 0001,0003 \
    --apply-immediately

Para Windows:

aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --replicas-to-remove 0001,0003 \
    --apply-immediately

O exemplo a seguir usa --replica-configuration a fim de diminuir o número de réplicas no grupo de replicação sample-repl-group para o valor especificado para os dois grupos de nós especificados. Como há vários grupos de nós, este é um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Durante a especificação do PreferredAvailabilityZones opcional, o número de zonas de disponibilidade listadas deve ser igual ao valor de NewReplicaCount mais 1. Essa abordagem contabiliza o nó primário do grupo identificado por NodeGroupId.

Para Linux, macOS ou Unix:

aws elasticache decrease-replica-count \
    --replication-group-id sample-repl-group \
    --replica-configuration \
        NodeGroupId=0001,NewReplicaCount=1,PreferredAvailabilityZones=us-east-1a,us-east-1c \
        NodeGroupId=0003,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
    --apply-immediately

Para Windows:

aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --replica-configuration ^
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c ^
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
    --apply-immediately

Para obter mais informações sobre como diminuir o número de réplicas usando a CLI, consulte a Referência da Linha de decrease-replica-countComando da Amazon ElastiCache .

Usando a ElastiCache API

Para diminuir o número de réplicas em um fragmento do Valkey ou Redis OSS, use a ação DecreaseReplicaCount com os seguintes parâmetros:

  • ReplicationGroupId: obrigatório. Identifica em qual grupo de replicação você deseja diminuir o número de réplicas.

  • ApplyImmediately: obrigatório. Especifica se é necessário diminuir a contagem de réplicas imediatamente (ApplyImmediately=True) ou na próxima janela de manutenção (ApplyImmediately=False). Atualmente, ApplyImmediately=False não é suportado.

  • NewReplicaCount: optional. Especifica o número de nós de réplica desejado. O valor de NewReplicaCount deve ser um valor válido menos o número atual de réplicas nos grupos de nós. Para valores permitidos mínimos, consulte Diminuição do número de réplicas em um fragmento. Caso o valor de --new-replica-count não atenda a esse requisito, a chama falha.

  • ReplicasToRemove: optional. Contém uma lista de nós IDs especificando os nós de réplica a serem removidos.

  • ReplicaConfiguration: optional. Contém uma lista de grupos de nós que permite definir o número de réplicas e as zonas de disponibilidade de cada grupo de nós independentemente. Use este parâmetro em grupos do Valkey ou Redis OSS (modo cluster habilitado) onde você deseja configurar cada grupo de nós independentemente.

    ReplicaConfiguraion tem três membros opcionais:

    • NodeGroupId: o ID de quatro dígitos do grupo de nós que você está configurando. Para grupos de replicação do Valkey ou do Redis OSS (modo cluster desabilitado), o ID do grupo de nós é sempre 0001. Para encontrar o ID de um grupo de nós (fragmento) do Valkey ou Redis OSS (modo cluster habilitado), consulte Localização de um ID de fragmento.

    • NewReplicaCount: o número de réplicas que você deseja nesse grupo de nós ao final desta operação. O valor deve ser menor que o número atual de réplicas até um mínimo de 1, caso o Multi-AZ esteja habilitado ou 0 caso o Multi-AZ com failover automático não esteja habilitado. Caso esse valor não seja menor que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.

    • PreferredAvailabilityZones: uma lista de strings de PreferredAvailabilityZone que especificam em quais zonas de disponibilidade os nós do grupo de replicação estão. O número de valores PreferredAvailabilityZone deve ser igual ao valor de NewReplicaCount mais 1 para contabilizar o nó primário. Se esse membro do ReplicaConfiguration for omitido, ElastiCache para Redis, o OSS escolhe a Zona de Disponibilidade para cada uma das novas réplicas.

Importante

Você deve incluir um, e somente um, parâmetro NewReplicaCount, ReplicasToRemove, ou ReplicaConfiguration.

O exemplo a seguir usa NewReplicaCount para diminuir o número de réplicas no grupo de replicação sample-repl-group para um. Quando o exemplo é concluído, existe uma réplica em cada grupo de nós. Esse número se aplica caso este seja um grupo do Valkey ou Redis OSS (modo cluster desabilitado) com um grupo de nós único ou um grupo do Valkey ou Redis OSS (modo cluster habilitado) com vários grupos de nós.

https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=1
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

O exemplo a seguir diminui o número de réplicas no grupo de replicação sample-repl-group removendo duas réplicas especificadas (0001 e 0003) do grupo de nós.

https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicasToRemove.ReplicaToRemove.1=0001
      &ReplicasToRemove.ReplicaToRemove.2=0003
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

O exemplo a seguir usa ReplicaConfiguration a fim de diminuir o número de réplicas no grupo de replicação sample-repl-group para o valor especificado para os dois grupos de nós especificados. Como há vários grupos de nós, este é um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Durante a especificação do PreferredAvailabilityZones opcional, o número de zonas de disponibilidade listadas deve ser igual ao valor de NewReplicaCount mais 1. Essa abordagem contabiliza o nó primário do grupo identificado por NodeGroupId.

https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=1
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

Para obter mais informações sobre como diminuir o número de réplicas usando a API, consulte DecreaseReplicaCounta Amazon ElastiCache API Reference.