# Modificar uma instância de banco de dados do Amazon RDS
<a name="Overview.DBInstance.Modifying"></a>

Você pode alterar as configurações de uma instância de banco de dados para realizar tarefas, como adicionar mais armazenamento ou alterar a classe da instância de banco de dados. Neste tópico, é possível descobrir como modificar uma instância de banco de dados do Amazon RDS e saber mais sobre as configurações para instâncias de banco de dados. 

Convém testar todas as alterações na instância de teste antes de modificar a instância de produção. Isso ajuda você a entender completamente o impacto de cada alteração. Testar é importante especialmente ao atualizar as versões do banco de dados. 

A maioria das modificações em uma instância de banco de dados podem ser aplicadas imediatamente ou adiadas até a próxima janela de manutenção. Algumas modificações, como alterações em grupos de parâmetros, exigem que você reinicie manualmente sua instância de banco de dados para que a alteração entre em vigor. 

**Importante**  
Algumas modificações resultam em inatividade, pois o Amazon RDS deve reiniciar sua instância de banco de dados para que a alteração entre em vigor. Analise o impacto sobre o seu banco de dados e os seus aplicativos antes de modificar as configurações da instância do banco de dados. 

## Console
<a name="USER_ModifyInstance.Console"></a>

**Como modificar uma instância de banco de dados**

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 **Databases (Bancos de dados)** e a instância de banco de dados que você deseja modificar. 

1. Selecione **Modify**. A página **Modify DB instance (Modificar instância de banco de dados)** será exibida.

1. Altere qualquer uma das configurações desejadas. Para obter informações sobre cada configuração, consulte [Configurações para instâncias de banco de dados](USER_ModifyInstance.Settings.md). 

1. Quando todas as alterações estiverem conforme o desejado, escolha **Continue (Continuar)** e verifique o resumo das modificações. 

1. (Opcional) Escolha **Apply immediately (Aplicar imediatamente)** para aplicar as alterações imediatamente. Escolher essa opção pode causar uma inatividade em alguns casos. Para ter mais informações, consulte [Usar a configuração de programação de modificações](USER_ModifyInstance.ApplyImmediately.md). 

1. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha **Modify DB Instance (Modificar instância de banco de dados)** para salvar suas alterações. 

   Ou selecione **Back (Voltar)** para editar as alterações ou **Cancel (Cancelar)** para cancelar as alterações. 

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

Para modificar uma instância de banco de dados usando a AWS CLI, chame o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html). Especifique o identificador da instância de banco de dados e os valores para as configurações que deseja modificar. Para ter mais informações sobre cada opção, consulte [Configurações para instâncias de banco de dados](USER_ModifyInstance.Settings.md). 

**Example**  
O código a seguir modifica `mydbinstance` configurando o período de retenção de backup como 1 semana (7 dias). O código habilita a proteção contra exclusão usando `--deletion-protection`. Para desativar a proteção contra exclusão, use `--no-deletion-protection`. As alterações serão aplicadas durante a janela de manutenção usando `--no-apply-immediately`. Use `--apply-immediately` para aplicar as alterações imediatamente. Para ter mais informações, consulte [Usar a configuração de programação de modificações](USER_ModifyInstance.ApplyImmediately.md).   
Para Linux, macOS ou Unix:  

```
aws rds modify-db-instance \
    --db-instance-identifier {{mydbinstance}} \
    --backup-retention-period {{7}} \
    {{--deletion-protection}} \
    {{--no-apply-immediately}}
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier {{mydbinstance}} ^
    --backup-retention-period {{7}} ^
    {{--deletion-protection}} ^
    {{--no-apply-immediately}}
```

**Example**  
O exemplo a seguir adiciona um volume de armazenamento a uma instância de banco de dados do RDS para Oracle. O volume adicional usa armazenamento gp3 com 5 mil GiB de armazenamento alocado e 12 mil IOPS.  

```
aws rds modify-db-instance \
     --db-instance-identifier my-oracle-instance \
     --additional-storage-volumes '[{ \
             "VolumeName": "rdsdbdata2", \
             "StorageType": "gp3",
             "AllocatedStorage": 5000, \
             "IOPS": 12000 \
         }]'
```

## API do RDS
<a name="USER_ModifyInstance.API"></a>

Para modificar uma instância de banco de dados usando a API do Amazon RDS, chame a operação [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Especifique o DB instance identifier e os parâmetros para as configurações que você deseja modificar. Para obter informações sobre cada parâmetro, consulte [Configurações para instâncias de banco de dados](USER_ModifyInstance.Settings.md).