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á.
# Promoção de uma réplica de leitura a primário, para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado)
As informações no tópico a seguir só se aplicam a grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado).
Você pode promover uma réplica de leitura de um cluster do Valkey ou Redis OSS (modo cluster desabilitado) a primário usando o Console de gerenciamento da AWS, a AWS CLI ou a API do ElastiCache. Você não pode promover uma réplica de leitura para primária enquanto Multi-AZ com failover automático estiver habilitado no grupo de replicação . Para promover uma réplica do Valkey ou Redis OSS (modo cluster desabilitado) para primário em um grupo de replicação habilitado para multi-AZ, faça o seguinte:
1. Modifique o grupo de replicação para desabilitar Multi-AZ (isso não requer que todos os clusters estejam na mesma zona de disponibilidade). Para obter mais informações, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
1. Promova a réplica de leitura para primário.
1. Modifique o grupo de replicação para reabilitar o Multi-AZ.
O Multi-AZ não está disponível em grupos de replicação que executam o Valkey ou Redis OSS 2.6.13 ou anterior.
## Utilização do Console de gerenciamento da AWS
O procedimento a seguir usa o console para promover um nó de réplica para primária.
**Para promover uma réplica de leitura para primário (console)**
1. Faça login no Console de gerenciamento da AWS e abra o console do ElastiCache em [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).
1. Se a réplica que você quiser promover for membro de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) em que o multi-AZ estiver habilitado, modifique o grupo de replicação para desabilitar o multi-AZ para continuar. Para obter mais informações, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
1. Escolha **Valkey** ou **Redis OSS**, na lista de clusters, escolha o grupo de replicação que você deseja modificar. Esse grupo de replicação deve estar executando o mecanismo "Redis", e não o mecanismo "Clustered Redis", e deve ter dois ou mais nós.
1. Na lista de nós, escolha o nó de réplica que você deseja promover para primária, em **Actions (Ações)**, escolha **Promote (Promover)**.
1. Na caixa de diálogo **Promote Read Replica (Promover réplica de leitura)**, faça o seguinte:
1. Em **Apply Immediately (Aplicar imediatamente)**, escolha **Yes (Sim)** para promover a réplica de leitura imediatamente, ou **No (Não)** para promovê-la na próxima janela de manutenção do cluster.
1. Escolha **Promote** para promover a réplica de leitura ou **Cancel** para cancelar a operação.
1. Caso o cluster tenha Multi-AZ habilitado antes de você começar o processo de promoção, aguarde o status do grupo de replicação estar **available (disponível)**, modifique o cluster para reabilitar Multi-AZ. Para obter mais informações, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
## Usar a AWS CLI
Você não pode promover uma réplica de leitura para primária caso o grupo de replicação esteja habilitado para Multi-AZ. Em alguns casos, a réplica que você deseja promover pode ser um membro de um grupo de replicação onde o recurso do Multi-AZ está habilitado. Nesses casos, você deve modificar o grupo de replicação para desabilitar o recurso do Multi-AZ antes de continuar. Isso não requer que todos os clusters estejam na mesma zona de disponibilidade. Para obter mais informações sobre como modificar um grupo de replicação, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
O seguinte comando AWS CLI modifica o grupo de replicação `sample-repl-group`, tornando a réplica de leitura `my-replica-1` o primário no grupo de replicação.
Para Linux, macOS ou Unix:
```
aws elasticache modify-replication-group \
--replication-group-id sample-repl-group \
--primary-cluster-id my-replica-1
```
Para Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id sample-repl-group ^
--primary-cluster-id my-replica-1
```
Para obter mais informações sobre como modificar um grupo de replicação, consulte [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) na *Referência da linha de comando do Amazon ElastiCache.*
## Uso da API do ElastiCache
Você não pode promover uma réplica de leitura para primária caso o grupo de replicação esteja habilitado para Multi-AZ. Em alguns casos, a réplica que você deseja promover pode ser um membro de um grupo de replicação onde o recurso do Multi-AZ está habilitado. Nesses casos, você deve modificar o grupo de replicação para desabilitar o recurso do Multi-AZ antes de continuar. Isso não requer que todos os clusters estejam na mesma zona de disponibilidade. Para obter mais informações sobre como modificar um grupo de replicação, consulte [Modificação de um grupo de replicação](Replication.Modify.md).
A seguinte ação da API do ElastiCache modifica o grupo de replicação `myReplGroup`, tornando a réplica de leitura `myReplica-1` o primário no grupo de replicação.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=ModifyReplicationGroup
&ReplicationGroupId=myReplGroup
&PrimaryClusterId=myReplica-1
&Version=2014-12-01
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20141201T220302Z
&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
&X-Amz-Date=20141201T220302Z
&X-Amz-SignedHeaders=Host
&X-Amz-Expires=20141201T220302Z
&X-Amz-Credential=
&X-Amz-Signature=
```
Para obter mais informações sobre como modificar um grupo de replicação, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) na *Referência da API do Amazon ElastiCache.*