# Modificar o modo da réplica do RDS para Db2
<a name="db2-replicas-changing-replica-mode"></a>

Você pode alterar o modo da réplica do Db2 existente entre os modos somente leitura e em espera. Essa flexibilidade permite que você adapte sua configuração de réplica com base nas mudanças nos requisitos de workloads de leitura ou nas necessidades de recuperação de desastres. 

Convém alterar os modos da réplica em um dos seguintes cenários:
+ **De somente leitura para em espera**: quando você não precisa mais da capacidade de leitura, mas quer manter os recursos de recuperação de desastres
+ **De em espera para somente leitura**: quando você precisa adicionar capacidade de leitura para workloads de relatórios ou analytics.

Antes de alterar os modos da réplica, garanta que as seguintes condições sejam atendidas:
+ A réplica está em um estado disponível.
+ Nenhuma operação de manutenção ativa está sendo executada na réplica.
+ Você tem as permissões necessárias para modificar a instância de banco de dados.

A operação de alteração pode levar alguns minutos. Durante a operação, o status da instância de banco de dados muda para **modifying (modificando)**. Para obter mais informações sobre alterações de status, consulte [Visualizar o status de uma instância de banco de dados do Amazon RDS](accessing-monitoring.md#Overview.DBInstance.Status). Quando você altera do modo somente leitura para o modo em espera, a réplica desconecta todas as conexões ativas. 

**Importante**  
Como a alteração dos modos de réplica interrompe temporariamente o serviço, planeje a alteração durante uma janela de manutenção a fim de minimizar o impacto em suas aplicações.

Você pode modificar o modo de uma réplica usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.

## Console
<a name="db2-replicas-changing-replica-mode-console"></a>

**Como alterar o modo de uma réplica do Db2**

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. Escolha o banco de dados de réplica que você deseja modificar.

1. Escolha **Modificar**.

1. Em **Modo de réplica**, escolha o modo desejado:
   + **Somente leitura**: para workloads de leitura
   + **Em espera**: para recuperação de desastres

1. Escolha as outras configurações que deseja alterar.

1. Escolha **Continue**.

1. Em **Scheduling of modifications (Programação de modificações)**, selecione **Apply immediately (Aplicar imediatamente)**.

1. Selecione **Modify DB instance (Modificar instância de banco de dados)**.

1. Depois que a modificação for concluída, verifique a alteração do modo de réplica na página **Bancos de dados**. O status da réplica deverá ser exibido como **Disponível** quando a alteração for concluída.

## AWS CLI
<a name="db2-replicas-changing-replica-mode-cli"></a>

Para alterar uma réplica do Db2 do modo somente leitura para o modo em espera, defina `--replica-mode` como `mounted` no comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da AWS CLI. Para alterar uma réplica do Db2 do modo em espera para o modo somente leitura, defina `--replica-mode` como `open-read-only`.

O exemplo a seguir altera uma réplica do modo somente leitura para o modo em espera:

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

```
aws rds modify-db-instance \
    --db-instance-identifier {{my_db2_replica}} \
    --replica-mode mounted
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier {{my_db2_replica}} ^
    --replica-mode mounted
```

O exemplo a seguir altera uma réplica do modo em espera para o modo somente leitura:

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

```
aws rds modify-db-instance \
    --db-instance-identifier {{my_db2_replica}} \
    --replica-mode open-read-only
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier {{my_db2_replica}} ^
    --replica-mode open-read-only
```

## API do RDS
<a name="db2-replicas-changing-replica-mode-api"></a>

Para alterar uma réplica do Db2 do modo somente leitura para o modo em espera, defina `ReplicaMode=mounted` em [ModifyDBInstance](AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Para alterar uma réplica do Db2 do modo em espera para o modo somente leitura, defina `ReplicaMode=open-read-only`.

O seguinte exemplo é de uma chamada de API para alterar o modo da réplica de somente leitura para em espera:

```
{
    "DBInstanceIdentifier": "my_db2_replica",
    "ReplicaMode": "mounted",
    "ApplyImmediately": true
}
```

O seguinte exemplo é de uma chamada de API para alterar o modo da réplica de em espera para somente leitura:

```
{
    "DBInstanceIdentifier": "my_db2_replica",
    "ReplicaMode": "open-read-only",
    "ApplyImmediately": true
}
```

Para acessar informações sobre as diferenças entre modos de réplica, consulte [Trabalhar com réplicas para o Amazon RDS para Db2](db2-replication.md). Para solucionar problemas de réplica, consulte [Solução de problemas de replicação do RDS para Db2](db2-troubleshooting-replicas.md).