本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 針對 Valkey 或 Redis OSS （停用叢集模式） 複寫群組，將僅供讀取複本提升為主要複本
<a name="Replication.PromoteReplica"></a>

下列主題中的資訊僅適用於 Valkey 或 Redis OSS （停用叢集模式） 複寫群組。

您可以使用 AWS CLI、 或 ElastiCache API AWS 管理主控台，將 Valkey 或 Redis OSS （停用叢集模式） 僅供讀取複本提升為主要複本。您無法在 複寫群組上啟用具備自動容錯移轉的異地同步備份時，將僅供讀取複本提升為主要節點。若要將啟用異地同步備份的複寫群組上的 Valkey 或 Redis OSS （停用叢集模式） 複本提升為主要複本，請執行下列動作：

1. 修改複寫群組以停用異地同步備份 (您所有的叢集不需要位於相同可用區域，也能執行此作業)。如需詳細資訊，請參閱[修改複寫群組](Replication.Modify.md)。

1. 將僅供讀取複本提升為主要節點。

1. 修改複寫群組來重新啟用異地同步備份。

多個可用區不適用於執行 Redis OSS 2.6.13 或更早版本的複寫群組。

## 使用 AWS 管理主控台
<a name="Replication.PromoteReplica.CON"></a>

以下程序會使用主控台將複本節點提升為主要節點。

**將僅供讀取複本提升為主節點 (主控台)**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) 的 ElastiCache 主控台。

1. 如果您想要提升的複本是啟用異地同步備份的 Valkey 或 Redis OSS （停用叢集模式） 複寫群組的成員，請在繼續之前修改複寫群組以停用異地同步備份。如需詳細資訊，請參閱[修改複寫群組](Replication.Modify.md)。

1. 選擇 **Valkey** 或 **Redis OSS**，然後從叢集清單中選擇您要修改的複寫群組。此複寫群組必須執行「Redis」引擎而非「Clustered Redis」引擎，並且必須至少擁有兩個以上的節點。

1. 從節點清單中，選擇您希望提升為主要節點的複本節點，然後針對 **Actions (動作)**，選擇 **Promote (提升)**。

1. 在 **Promote Read Replica (提升僅供讀取複本)** 對話方塊中，執行下列作業：

   1. 針對**立即套用**，選擇 **Yes (是)** 來立即提升僅供讀取複本，或是 **No (否)** 來在下一次叢集的維修時間內提升。

   1. 選擇 **Promote (提升)** 以提升僅供讀取複本，或選擇 **Cancel (取消)** 以取消操作。

1. 若在您開始提升程序前該叢集已啟用異地同步備份，請等到複寫群組的狀態成為 **available (可用)** 時再修改叢集以重新啟用異地同步備份。如需詳細資訊，請參閱[修改複寫群組](Replication.Modify.md)。

## 使用 AWS CLI
<a name="Replication.PromoteReplica.CLI"></a>

若複寫群組已啟用異地同步備份，您便無法將僅供讀取複本提升為主要節點。在某些情況下，您要提升的複本可能是已啟用異地同步備份的複寫群組的成員。在這些情況下，您必須先修改複寫群組來停用異地同步備份，之後才能繼續。您所有的叢集不需要位於相同可用區域，也能執行此作業。如需修改複寫群組的詳細資訊，請參閱[修改複寫群組](Replication.Modify.md)。

下列 AWS CLI 命令會修改複寫群組 `sample-repl-group`，使僅供讀取複本`my-replica-1`成為複寫群組中的主要複本。

若為 Linux、macOS 或 Unix：

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

針對 Windows：

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

如需修改複寫群組的詳細資訊，請參閱 *Amazon ElastiCache 命令列參考*中的 [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html)。

## 使用 ElastiCache API
<a name="Replication.PromoteReplica.API"></a>

若複寫群組已啟用異地同步備份，您便無法將僅供讀取複本提升為主要節點。在某些情況下，您要提升的複本可能是已啟用異地同步備份的複寫群組的成員。在這些情況下，您必須先修改複寫群組來停用異地同步備份，之後才能繼續。您所有的叢集不需要位於相同可用區域，也能執行此作業。如需修改複寫群組的詳細資訊，請參閱[修改複寫群組](Replication.Modify.md)。

以下 ElastiCache API 動作會修改 `myReplGroup` 複寫群組，使僅供讀取複本 `myReplica-1` 成為複寫群組中的主節點。

```
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>
```

如需修改複寫群組的詳細資訊，請參閱 *Amazon ElastiCache API 參考*中的 [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)。