Diminuição do número de réplicas em um fragmento - Amazon ElastiCache (RedisOSS)
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 diminuir o número de réplicas em um fragmento para Redis OSS (modo de cluster ativado) ou em um grupo de replicação para Redis OSS (modo de cluster desativado):

  • Para o Redis OSS (modo de cluster desativado), você pode diminuir o número de réplicas para uma se o Multi-AZ estiver ativado e para zero se não estiver habilitado.

  • Para o Redis OSS (modo de cluster ativado), 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 diminuir o número de réplicas em um grupo de replicação do Redis OSS (modo de cluster ativado).

Para diminuir o número de réplicas em um fragmento do 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 Redis OSS e, em seguida, escolha o nome do grupo de replicação do qual você deseja excluir as 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, o ElastiCache (Redis OSS) selecionará automaticamente os nós de réplica para exclusão. Ao fazer isso, o ElastiCache (Redis 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 a primária.

  • 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 Redis OSS, use o decrease-replica-count comando 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 IDs de nó que especificam 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 esse parâmetro para grupos do Redis OSS (modo de cluster ativado) nos quais você deseja configurar cada grupo de nós de forma independente.

    --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 Redis OSS (modo de cluster desativado), o ID do fragmento é sempre. 0001 Para encontrar a ID de um grupo de nós (fragmento) do Redis OSS (modo de cluster ativado), 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 (Redis OSS) escolherá a Zona de Disponibilidade para cada uma das novas réplicas.

Importante

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

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 se for um grupo Redis OSS (modo de cluster desativado) com um único grupo de nós ou um grupo Redis OSS (modo de cluster ativado) 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, esse é um grupo de replicação do Redis OSS (modo de cluster ativado). 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 Redis OSS, use a DecreaseReplicaCount ação 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 IDs de nó que especificam 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 esse parâmetro para grupos do Redis OSS (modo de cluster ativado) nos quais você deseja configurar cada grupo de nós de forma independente.

    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 Redis OSS (modo de cluster desativado), a ID do grupo de nós é sempre. 0001 Para encontrar a ID de um grupo de nós (fragmento) do Redis OSS (modo de cluster ativado), 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 (Redis OSS) escolherá a Zona de Disponibilidade para cada uma das novas réplicas.

Importante

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

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 se for um grupo Redis OSS (modo de cluster desativado) com um único grupo de nós ou um grupo Redis OSS (modo de cluster ativado) 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, esse é um grupo de replicação do Redis OSS (modo de cluster ativado). 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.