

# Amazon Aurora DB クラスターのフェイルオーバー
<a name="aurora-failover"></a>

例として、プロビジョニングされたライター DB インスタンスを Aurora Serverless v2 ライターインスタンスに置き換える場合などに、Aurora DB クラスターの手動フェイルオーバーを実行できます。

Aurora は、次の 2 つの方法のいずれかで新しいプライマリ DB インスタンスにフェイルオーバーします。
+ 既存のリーダー DB インスタンス を新しいプライマリインスタンスに昇格する
+ 新しいプライマリインスタンスを作成する

DB クラスターに 1 つ以上のリーダー DB インスタンスがある場合は、障害発生中に 1 つのリーダーがプライマリインスタンスに昇格されます。DB クラスターの可用性を高めるために、複数のアベイラビリティーゾーン内で少なくとも 1 つ以上のリーダーインスタンスを作成することをお勧めします。フェイルオーバーのメカニズムについての詳細は、「[Aurora DB クラスターの耐障害性](Concepts.AuroraHighAvailability.md#Aurora.Managing.FaultTolerance)」を参照してください。

AWS マネジメントコンソール、AWS CLI、または RDS API を使用して、手動フェイルオーバーを実行できます。

## コンソール
<a name="aurora-failover.CON"></a>

**DB クラスターをフェイルオーバーするには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。

1. ナビゲーションペインで、**[データベース]** を選択し、フェイルオーバーする DB クラスター で DB インスタンスを選択します。

1. **[アクション]** で、**[フェイルオーバー]** を選択します。

   確認ページが表示されます。

1. [**フェイルオーバー**] を選択します。

   **[データベース]** ページには、DB クラスターのステータスが **[フェイルオーバー]** と表示されます。フェイルオーバーが完了するとステータスは **[使用可能]** に戻り、新規および以前のプライマリ DB インスタンスのロールが表示されます。

## AWS CLI
<a name="aurora-failover.CLI"></a>

AWS CLI を使用して DB クラスターをフェイルオーバーするには、[failover-db-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/failover-db-cluster.html) を呼び出します。以下のパラメータを指定します。
+ `--db-cluster-identifier` – フェイルオーバーする DB クラスター。
+ `--target-db-instance-identifier` – プライマリ DB インスタンスに昇格する DB インスタンスの名前。

**Example**  
Linux、macOS、Unix の場合:  

```
aws rds failover-db-cluster \
    --db-cluster-identifier mydbcluster \
    --target-db-instance-identifier mydbcluster-instance-2
```
Windows の場合:  

```
aws rds failover-db-cluster ^
    --db-cluster-identifier mydbcluster ^
    --target-db-instance-identifier mydbcluster-instance-2
```

## RDS API
<a name="aurora-failover.API"></a>

Amazon RDS API を使用して DB クラスターを変更するには、[FailoverDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_FailoverDBCluster.html) オペレーションを呼び出します。以下のパラメータを指定します。
+ DBClusterIdentifier
+ TargetDBInstanceIdentifier