# DB インスタンスの名前を変更する
<a name="USER_RenameInstance"></a>

 AWS マネジメントコンソール、AWS CLI `modify-db-instance` コマンド、または Amazon RDS API `ModifyDBInstance` アクションを使用して、DB インスタンスの名前を変更できます。DB インスタンスの名前を変更すると、広範囲に影響が及びます。以下は、DB インスタンスの名前を変更する前の考慮事項の一覧です。
+  DB インスタンスの名前を変更すると、DB インスタンスに割り当てた名前が URL に含まれているので、DB インスタンスのエンドポイントが変わります。必ず古い URL のトラフィックを新しい URL にリダイレクトする必要があります。
+  DB インスタンスの名前を変更すると、DB インスタンスによって使用されていた古い DNS 名はすぐに削除されますが、数分間キャッシュされたままの場合があります。名前を変更した DB インスタンスの新しい DNS 名は、10 分程度で有効になります。名前を変更した DB インスタンスは、新しい名前が有効になるまで使用できません。
+  インスタンスの名前を変更する際に既存の DB インスタンスの名前を使用することはできません。
+  DB インスタンスに関連付けられたすべてのリードレプリカは、名前を変更した後もインスタンスに関連付けられたままです。例えば、本稼働データベースを提供する DB インスタンスと、リードレプリカが複数関連付けられているインスタンスがあるとします。DB インスタンスの名前を変更し、本稼働環境で DB スナップショットを置き換えた場合、名前を変更した DB インスタンスにはリードレプリカが関連付けられたままです。
+  DB インスタンスの名前に関連付けられたメトリクスとイベントは、DB インスタンス名を再利用する場合も維持されます。例えば、リードレプリカを昇格させ、前のプライマリ DB インスタンスの名前となるように名前を変更した場合、プライマリ DB インスタンスに関連付けられたイベントとメトリクスは、名前が変更されたインスタンスに関連付けられます。
+  DB インスタンスのタグは、名前を変更するかどうかにかかわらず DB インスタンスに残ります。
+  名前を変更した DB インスタンスの DB スナップショットは保持されます。

**注記**  
DB インスタンスはクラウドで実行される独立したデータベース環境です。DB インスタンスは、複数のデータベース、または複数のスキーマを使用する 1 つの Oracle データベースをホストすることができます。データベース名の変更の詳細については、DB エンジンのドキュメントを参照してください。

## 名前を変更して既存の DB インスタンスを置き換える
<a name="USER_RenameInstance.RR"></a>

DB インスタンスの名前を変更する最も一般的な理由は、リードレプリカを昇格させること、または DB スナップショットまたは ポイントインタイムリカバリ (PITR) からデータを復元することです。データベースの名前を変更することにより、DB インスタンスを参照するアプリケーションコードを変更せずに DB インスタンスを置き換えることができます。このような場合、次の作業を行います。

1. プライマリ DB インスタンスに向かうトラフィックを停止します。これを行うには、DB インスタンスでデータベースにアクセスするトラフィックをリダイレクトしたり、他の方法を使用してトラフィックが DB インスタンスでデータベースにアクセスしないようにする必要があります。

1. このトピックで後述するように、プライマリ DB インスタンスの名前を、プライマリ DB インスタンスではなくなったことを示す名前に変更します。

1. DB スナップショットから復元するか、リードレプリカを昇格させることにより、新しいプライマリ DB インスタンスを作成し、新しいインスタンスに以前のプライマリ DB インスタンスの名前を付けます。

1. リードレプリカに新しいプライマリ DB インスタンスを関連付けます。

古いプライマリ DB インスタンスを削除した場合、古いプライマリ DB インスタンスの不要な DB スナップショットをすべて削除する必要があります。

リードレプリカの昇格については、「[リードレプリカをスタンドアロン DB インスタンスに昇格させる](USER_ReadRepl.Promote.md)」を参照してください。

**重要**  
DB インスタンスは名前が変更されると再起動されます。常時オプションやミラーリングオプションが有効になっている RDS for SQL Server のマルチ AZ インスタンスの場合、名前変更オペレーション後にインスタンスを再起動すると、フェイルオーバーが予想されます。

## コンソール
<a name="USER_RenameInstance.CON"></a>

**DB インスタンスの名前を変更するには**

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

1. ナビゲーションペインで、[**データベース**] を選択します。

1. 名前を変更する DB インスタンスを選択します。

1. **[Modify]** (変更) を選択します。

1. [**設定**] で､[**DB インスタンス識別子**] に新しい名前を入力します。

1. [**続行**] をクリックしてください。

1. 変更をすぐに反映させるには、[**Apply immediately**] を選択します。このオプションを選択すると、停止状態になる場合があります。詳細については、「[Amazon RDS DB インスタンスを変更する](Overview.DBInstance.Modifying.md)」を参照してください。

1. 確認ページで、変更内容を確認します。正しい場合は、[**Modify DB Instance (DB インスタンスを変更)**] を選択して変更を保存します。

   または、[**Back**] を選択して変更を編集するか、[**Cancel**] を選択して変更をキャンセルします。

## AWS CLI
<a name="USER_RenameInstance.CLI"></a>

DB インスタンスの名前を変更するには、AWS CLI コマンド [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) を使用します。DB インスタンスの新しい名前とともに、現在の `--db-instance-identifier` 値および `--new-db-instance-identifier` パラメータを指定します。

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

```
1. aws rds modify-db-instance \
2.     --db-instance-identifier DBInstanceIdentifier \
3.     --new-db-instance-identifier NewDBInstanceIdentifier
```
Windows の場合:  

```
1. aws rds modify-db-instance ^
2.     --db-instance-identifier DBInstanceIdentifier ^
3.     --new-db-instance-identifier NewDBInstanceIdentifier
```

## RDS API
<a name="USER_RenameInstance.API"></a>

DB インスタンスの名前を変更するには、以下のパラメータを指定して Amazon RDS API オペレーション [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) を呼び出します。
+ `DBInstanceIdentifier` — インスタンスの既存の名前
+ `NewDBInstanceIdentifier` — インスタンスの新しい名前