# 重命名数据库实例
<a name="USER_RenameInstance"></a>

 您可以使用AWS 管理控制台、AWS CLI `modify-db-instance` 命令或 Amazon RDS API `ModifyDBInstance` 操作重命名数据库实例。重命名数据库实例会产生深远的影响。以下是您在重命名数据库实例之前需了解的注意事项列表。
+  当您重命名数据库实例时，数据库实例的终端节点会发生更改，因为 URL 包含了您分配给数据库实例的名称。您应当始终将流量从旧的 URL 重定向到新的。
+  当您重命名数据库实例时，数据库实例使用的旧的 DNS 名称会立刻被删除，尽管它可能会在缓存中保留几分钟。重命名数据库实例的新 DNS 名称大约在 10 分钟之内生效。重命名的数据库实例在新名称生效前不可用。
+  重命名实例时，不能使用现有的数据库实例名称。
+  重命名后，所有与数据库实例关联的只读副本会保持与该实例的关联。例如，假设您有一个为生产数据库服务的数据库实例，而该实例有多个关联的只读副本。如果您重命名该数据库实例，然后在生产环境中将其替换为数据库快照，则您重命名的数据库实例仍会拥有与它关联的只读副本。
+  如果您重新使用数据库实例的名称，则与数据库实例的名称关联的指标和事件保持不变。例如，如果提升一个只读副本，然后将其重命名为以前主数据库实例的名称，则与该主数据库实例关联的事件和指标与重命名的实例关联。
+  无论是否重命名，数据库实例标签会始终与数据库实例关联在一起。
+  对于重命名的数据库实例，数据库快照也会保留下来。

**注意**  
数据库实例是在云中运行的独立数据库环境。一个数据库实例可承载多个数据库，或一个带有多个架构的 Oracle 数据库。有关更改数据库名称的信息，请参阅数据库引擎文档。

## 重命名以替换现有的数据库实例
<a name="USER_RenameInstance.RR"></a>

重命名数据库实例最常见的原因是要提升只读副本或从数据库快照或时间点恢复 (PITR) 还原数据。通过重命名数据库，您无需更改引用该数据库实例的任何应用程序代码，就可以替换数据库实例。在这些情况下，请执行以下操作：

1. 停止传向主数据库实例的所有流量。这可能包括重定向访问数据库实例中数据库的流量，或采取阻止流量访问数据库实例中数据库的其他方法。

1. 在重命名主数据库实例时，请使用一个表示它不再是本主题下文所述的主数据库实例的名称。

1. 通过从数据库快照还原或提升只读副本而创建一个新的主数据库实例，然后将新实例命名为此前主数据库实例的名称。

1. 将所有只读副本与新的主数据库实例关联。

如果您删除旧的主数据库实例，就必须删除旧的主数据库实例中所有不再需要的数据库快照。

有关提升只读副本的信息，请参阅 [将只读副本提升为独立的数据库实例](USER_ReadRepl.Promote.md)。

**重要**  
重命名之后，数据库实例重启。对于启用了 AlwaysOn 或镜像选项的 RDS for SQL Server 多可用区实例，在重命名操作后重启实例时，预计会进行失效转移。

## 控制台
<a name="USER_RenameInstance.CON"></a>

**要重命名数据库实例，请执行以下操作：**

1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台：[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)。

1. 在导航窗格中，选择 **Databases (数据库)**。

1. 选择要重命名的数据库实例。

1. 选择**修改**。

1. 在**设置**中，为**数据库实例标识符**输入一个新名称。

1. 选择 **Continue (继续)**。

1. 要立即应用更改，请选择**立即应用**。选择此选项在某些情况下可能导致中断。有关更多信息，请参阅“[修改 Amazon RDS 数据库实例](Overview.DBInstance.Modifying.md)”。

1. 在确认页面上，检查您的更改。如果更改正确无误，请选择 **Modify DB Instance (修改数据库实例)** 保存更改。

   或者，选择 **Back (返回)** 编辑您的更改，或者选择 **Cancel (取消)** 取消更改。

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

要重命名数据库实例，请使用 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-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>

要重命名数据库实例，请结合以下参数调用 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` – 实例的新名称