

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Promotion d'un réplica en lecture au rang de réplica principal, pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé)

Les informations de la rubrique suivante s'appliquent uniquement aux groupes de réplication Valkey ou Redis OSS (mode cluster désactivé).

Vous pouvez promouvoir une réplique de lecture Valkey ou Redis OSS (mode cluster désactivé) au rang de réplique principale à l'aide de l' Console de gestion AWS AWS CLI API ou de l' ElastiCache API. Vous ne pouvez pas promouvoir un réplica de lecture au rang de réplica principal alors que Multi-AZ le basculement automatique est activé sur le groupe de réplication. Pour promouvoir un réplica Valkey ou Redis OSS (mode cluster désactivé) au rang de réplica principal sur un groupe de réplication Multi-AZ activé, procédez comme suit :

1. Modifiez le groupe de réplication pour le désactiver Multi-AZ (cela ne nécessite pas que tous vos clusters se trouvent dans la même zone de disponibilité). Pour de plus amples informations, veuillez consulter [Modification d'un groupe de réplication](Replication.Modify.md).

1. Promouvez le réplica en lecture en réplica principal.

1. Modifiez le groupe de réplication pour le réactiver Multi-AZ.

## Utilisation de Console de gestion AWS
<a name="Replication.PromoteReplica.CON"></a>

La procédure suivante utilise la console pour promouvoir un nœud de réplica et nœud principal. 

**Pour promouvoir un réplica en lecture en réplica principal (console)**

1. Connectez-vous à Console de gestion AWS et ouvrez la ElastiCache console à l'adresse [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).

1. Si le réplica que vous souhaitez promouvoir est membre d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) où il Multi-AZ est activé, modifiez le groupe de réplication pour le désactiver Multi-AZ avant de continuer. Pour de plus amples informations, veuillez consulter [Modification d'un groupe de réplication](Replication.Modify.md).

1. Choisissez ** Valkey ** ou ** Redis OSS**, puis dans la liste des clusters, choisissez le groupe de réplication que vous souhaitez modifier. Ce groupe de réplication doit exécuter le moteur « Redis », et non le moteur « Clustered Redis », et doit avoir au moins 2 nœuds.

1. Dans la liste des nœuds, choisissez le nœud de réplica que vous souhaitez promouvoir en nœud principal, puis, dans **Actions**, choisissez **Promote (Promouvoir)**.

1. Dans la boîte de dialogue **Promote Read Replica (Promouvoir le réplica en lecture)**, exécutez l'une des actions suivantes :

   1. Pour **Apply Immediately (Appliquer immédiatement)**, choisissez **Yes (Oui)** pour promouvoir immédiatement le réplica en lecture, ou **No (Non)** pour le promouvoir au créneau de maintenance suivant du cluster.

   1. Choisissez **Promote** pour promouvoir le réplica en lecture ou **Cancel** pour annuler l'opération.

1. Si le cluster était Multi-AZ activé avant le début du processus de promotion, attendez que l'état du groupe de réplication soit ** disponible**, puis modifiez le cluster pour le réactiver Multi-AZ. Pour de plus amples informations, veuillez consulter [Modification d'un groupe de réplication](Replication.Modify.md).

## Utilisation de AWS CLI
<a name="Replication.PromoteReplica.CLI"></a>

Vous ne pouvez pas promouvoir un réplica en lecture au rang de réplica principal si le groupe de réplication est Multi-AZ activé. Dans certains cas, le réplica que vous souhaitez promouvoir peut être membre d'un groupe de réplication où cette option Multi-AZ est activée. Dans ces cas, vous devez modifier le groupe de réplication pour le désactiver Multi-AZ avant de continuer. Pour cela, tous les clusters ne doivent pas obligatoirement se trouver dans la même zone de disponibilité. Pour plus d'informations sur la modification d'un groupe de réplication, consultez [Modification d'un groupe de réplication](Replication.Modify.md).

La AWS CLI commande suivante modifie le groupe de réplication`sample-repl-group`, faisant de la réplique en lecture `my-replica-1` la principale du groupe de réplication.

Pour Linux, macOS ou Unix :

```
aws elasticache modify-replication-group \
   --replication-group-id {{sample-repl-group}} \
   --primary-cluster-id {{my-replica-1}}
```

Pour Windows :

```
aws elasticache modify-replication-group ^
   --replication-group-id {{sample-repl-group}} ^
   --primary-cluster-id {{my-replica-1}}
```

Pour plus d'informations sur la modification d'un groupe de réplication, consultez [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) le manuel * Amazon ElastiCache Command Line Reference. *

## Utilisation de l' ElastiCache API
<a name="Replication.PromoteReplica.API"></a>

Vous ne pouvez pas promouvoir un réplica en lecture au rang de réplica principal si le groupe de réplication est Multi-AZ activé. Dans certains cas, le réplica que vous souhaitez promouvoir peut être membre d'un groupe de réplication où cette option Multi-AZ est activée. Dans ces cas, vous devez modifier le groupe de réplication pour le désactiver Multi-AZ avant de continuer. Pour cela, tous les clusters ne doivent pas obligatoirement se trouver dans la même zone de disponibilité. Pour plus d'informations sur la modification d'un groupe de réplication, consultez [Modification d'un groupe de réplication](Replication.Modify.md).

L'action d' ElastiCache API suivante modifie le groupe de réplication`myReplGroup`, faisant de la réplique en lecture `myReplica-1` la principale du groupe de réplication.

```
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=<credential>
   &X-Amz-Signature=<signature>
```

Pour plus d'informations sur la modification d'un groupe de réplication, consultez [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) le manuel * Amazon ElastiCache API Reference. *