# 重命名 Amazon RDS 的多可用区数据库集群
<a name="multi-az-db-cluster-rename"></a>

您可以使用 Amazon Web Services 管理控制台、Amazon CLI `modify-db-cluster` 命令或 Amazon RDS API `ModifyDBCluster` 操作重命名多可用区数据库集群。重命名多可用区数据库集群可能产生显著影响。以下是您在重命名多可用区数据库集群之前需了解的注意事项列表。
+ 当您重命名多可用区数据库集群时，多可用区数据库集群的集群端点会发生变化。这些端点之所以更改，是因为它们包括您分配给多可用区数据库集群的名称。您可以将流量从旧端点重定向到新端点。有关多可用区数据库集群端点的更多信息，请参阅 [连接到 Amazon RDS 的多可用区数据库集群](multi-az-db-clusters-concepts-connection-management.md)。
+ 当您重命名多可用区数据库集群时，多可用区数据库集群使用的旧 DNS 名称会被删除，尽管它可能会在缓存中保留几分钟。重命名的多可用区数据库集群的新 DNS 名称在大约两分钟内生效。重命名的多可用区数据库集群在新名称生效之前不可用。
+ 重命名集群时，您不能使用现有的多可用区数据库集群名称。
+ 如果您重用数据库实例的名称，则与多可用区数据库集群的名称关联的指标和事件保持不变。
+ 无论重命名如何，多可用区数据库集群标签都会保留在多可用区数据库集群中。
+ 对于重命名的多可用区数据库集群，数据库集群快照也会保留下来。

**注意**  
多可用区数据库集群是在云中运行的独立数据库环境。多可用区数据库集群可承载多个数据库。有关更改数据库名称的信息，请参阅数据库引擎文档。

## 重命名以替换现有的多可用区数据库集群
<a name="multi-az-db-cluster-rename-to-replace"></a>

重命名多可用区数据库集群的最常见场景包括从数据库集群快照还原数据或执行时间点故障恢复（PITR）。通过重命名多可用区数据库集群，您可以在不更改任何引用多可用区数据库集群的应用程序代码的情况下替换多可用区数据库集群。在这些情况下，完成以下步骤：

1. 停止流向多可用区数据库集群的所有流量。您可以重定向流量，使其无法访问多可用区数据库集群上的数据库，或者选择其他方式阻止流量访问多可用区数据库集群中的数据库。

1. 重命名现有的多可用区数据库集群。

1. 通过从数据库集群快照进行还原或恢复到某个时间点，创建新的多可用区数据库集群。然后，为新的多可用区数据库集群提供先前多可用区数据库集群的名称。

如果您删除旧的多可用区数据库集群，则您负责删除旧的多可用区数据库集群的任何不需要的数据库集群快照。

## 控制台
<a name="multi-az-db-cluster-rename.CON"></a>

**重命名多可用区数据库集群**

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

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

1. 选择要重命名的多可用区数据库集群。

1. 选择**修改**。

1. 在 **Settings**（设置）中，为 **DB cluster identifier**（数据库集群标识符）输入新名称。

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

1. 要立即应用更改，请选择**立即应用**。选择此选项在某些情况下可能导致中断。有关更多信息，请参阅 [立即应用更改](modify-multi-az-db-cluster.md#modify-multi-az-db-cluster-apply-immediately)。

1. 在确认页面上，检查您的更改。如果更改正确无误，请选择**修改集群**以保存更改。

   或者，选择 **Back**（返回）以编辑您的更改，或者选择 **Cancel**（取消）以放弃更改。

## Amazon CLI
<a name="multi-az-db-cluster-rename.CLI"></a>

要重命名多可用区数据库集群，请使用 Amazon CLI 命令 [modify-db-cluster](https://docs.amazonaws.cn/cli/latest/reference/rds/modify-db-cluster.html)。提供当前 `--db-cluster-identifier` 值并为 `--new-db-cluster-identifier` 参数提供多可用区数据库集群的新名称。

**Example**  
对于 Linux、macOS 或 Unix：  

```
1. aws rds modify-db-cluster \
2.     --db-cluster-identifier DBClusterIdentifier \
3.     --new-db-cluster-identifier NewDBClusterIdentifier
```
对于 Windows：  

```
1. aws rds modify-db-cluster ^
2.     --db-cluster-identifier DBClusterIdentifier ^
3.     --new-db-cluster-identifier NewDBClusterIdentifier
```

## RDS API
<a name="multi-az-db-cluster-rename.API"></a>

要重命名多可用区数据库集群，请使用以下参数调用 Amazon RDS API 操作 [ModifyDBCluster](https://docs.amazonaws.cn/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html)：
+ `DBClusterIdentifier` – 数据库集群的现有名称。
+ `NewDBClusterIdentifier` – 数据库集群的新名称。