# Renomear um cluster de banco de dados multi-AZ para o Amazon RDS
<a name="multi-az-db-cluster-rename"></a>

Você pode renomear um cluster de banco de dados multi-AZ utilizando o Console de gerenciamento da AWS, comando `modify-db-cluster` da AWS CLI ou a operação `ModifyDBCluster` da API do Amazon RDS. Renomear um cluster de banco de dados multi-AZ pode ter efeitos significativos. Veja a seguir uma lista de considerações antes de renomear um cluster de banco de dados multi-AZ.
+ Quando você renomeia um cluster de banco de dados multi-AZ, os endpoints de cluster do cluster de banco de dados multi-AZ são alterados. Esses endpoints mudam porque incluem o nome que você atribuiu ao cluster de banco de dados multi-AZ. Você pode redirecionar o tráfego de um endpoint antigo para um novo. Para obter mais informações sobre endpoints de cluster de banco de dados multi-AZ, consulte [Conectar-se a um cluster de banco de dados multi-AZ no Amazon RDS](multi-az-db-clusters-concepts-connection-management.md).
+ Ao renomear um cluster de banco de dados multi-AZ, o nome DNS antigo que era usado pelo cluster é excluído, embora ele possa permanecer armazenado em cache por alguns minutos. O novo nome DNS do cluster de banco de dados multi-AZ renomeado entra em vigor em, aproximadamente, dois minutos. O cluster de banco de dados multi-AZ renomeado não fica disponível até que o novo nome entre em vigor.
+ Você não pode usar um nome de cluster de banco de dados multi-AZ existente ao renomear um cluster.
+ Métricas e eventos associados ao nome de um cluster de banco de dados multi-AZ serão mantidos se você reutilizar um nome de cluster de banco de dados.
+ As tags de cluster de banco de dados multi-AZ permanecem no cluster de banco de dados multi-AZ, independentemente da renomeação.
+ Snapshots de cluster de banco de dados são retidos para um cluster de banco de dados multi-AZ renomeado.

**nota**  
Um cluster de banco de dados multi-AZ é um ambiente de banco de dados isolado em execução na nuvem. Um cluster de banco de dados multi-AZ pode hospedar vários bancos de dados. Para obter informações sobre como alterar um nome de banco de dados, consulte a documentação do seu mecanismo de banco de dados.

## Renomear para substituir um cluster de banco de dados multi-AZ existente
<a name="multi-az-db-cluster-rename-to-replace"></a>

As situações mais comuns para renomear um cluster de banco de dados multi-AZ incluem restaurar dados de um snapshot de cluster de banco de dados ou realizar uma recuperação a um ponto anterior no tempo (PITR). Ao renomear o cluster de banco de dados multi-AZ, você pode substituir o cluster de banco de dados multi-AZ sem alterar nenhum código de aplicação que faça referência ao cluster de banco de dados multi-AZ. Nesses casos, conclua as seguintes etapas: 

1. Interrompa todo o tráfego para o cluster de banco de dados multi-AZ. É possível redirecionar o tráfego, impedindo-o de acessar os bancos de dados no cluster de banco de dados multi-AZ ou selecionar outra forma de impedir que o tráfego acesse seus bancos de dados no cluster de banco de dados multi-AZ. 

1. Renomeia o cluster de banco de dados multi-AZ existente.

1. Crie um cluster de banco de dados multi-AZ restaurando-o de um snapshot de banco de dados ou recuperando-o para um momento específico. Depois, dê ao cluster de banco de dados multi-AZ o nome do cluster de banco de dados multi-AZ anterior.

Se você excluir o cluster de banco de dados multi-AZ antigo, será responsável por excluir qualquer snapshot de banco de dados indesejado do cluster de banco de dados multi-AZ antigo.

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

**Como renomear um cluster de banco de dados multi-AZ**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, escolha **Bancos de dados**.

1. Selecione o cluster de banco de dados multi-AZ que você deseja renomear.

1. Escolha **Modificar**.

1. Em **Settings** (Configurações), digite um novo nome para **DB cluster identifier** (Identificador do cluster de banco de dados).

1. Escolha **Continue**.

1. Para aplicar as alterações imediatamente, escolha **Apply immediately**. Escolher essa opção pode causar uma interrupção em alguns casos. Para ter mais informações, consulte [Aplicar alterações imediatamente](modify-multi-az-db-cluster.md#modify-multi-az-db-cluster-apply-immediately). 

1. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha **Modify cluster (Modificar cluster)** para salvar as alterações.

   Como alternativa, selecione **Back** (Voltar) para editar suas alterações ou **Cancel** (Cancelar) para cancelar as alterações.

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

Para renomear um cluster de banco de dados multi-AZ, use o comando [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) da AWS CLI. Forneça ao valor `--db-cluster-identifier` atual e ao parâmetro `--new-db-cluster-identifier` o novo nome do cluster de banco de dados multi-AZ.

**Example**  
Para Linux, macOS ou Unix:  

```
1. aws rds modify-db-cluster \
2.     --db-cluster-identifier DBClusterIdentifier \
3.     --new-db-cluster-identifier NewDBClusterIdentifier
```
Para Windows:  

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

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

Para renomear um cluster de bancos de dados multi-AZ, chame a operação [ ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) da API do Amazon RDS com os seguintes parâmetros:
+ `DBClusterIdentifier`: o nome existente do cluster de banco de dados.
+ `NewDBClusterIdentifier`: o novo nome do cluster de banco de dados.