# Adicionar volumes de armazenamento
<a name="USER_PIOPS.ModifyingExisting.AdditionalVolumes"></a>

Para instâncias de banco de dados do RDS para Oracle e RDS para SQL Server, você pode adicionar até três volumes de armazenamento para aumentar sua capacidade total de armazenamento em até 256 TiB por instância. Volumes de armazenamento adicionais permitem que você use diferentes tipos de armazenamento (gp3 e io2) para otimizar custos e performance com base em seus padrões de acesso aos dados.

**nota**  
Para instâncias de banco de dados do RDS para Oracle, você pode adicionar um volume de armazenamento com o tamanho mínimo de armazenamento de 200 GiB.

Você pode adicionar, modificar ou remover volumes de armazenamento adicionais usando o Console de Gerenciamento da AWS ou a AWS CLI. É possível configurar os volumes com diferentes configurações de armazenamento alocado, IOPS e throughput. Por exemplo, você pode colocar dados de alta performance em um volume io2 e dados históricos em um volume gp3.

Os volumes adicionais devem usar os nomes dos volumes mostrados na tabela a seguir.


| Nome do volume do RDS para Oracle | Nome do volume do RDS para SQL Server | 
| --- | --- | 
| rdsdbdata2 | H: | 
| rdsdbdata3 | I: | 
| rdsdbdata4 | J: | 

## Console
<a name="USER_PIOPS.ModifyingExisting.AdditionalVolumes.console"></a>

**Como adicionar um volume de armazenamento a 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)**.

1. Escolha a instância de banco de dados que você deseja modificar.

1. Selecione **Modify**.

1. Na seção **Armazenamento**, escolha **Adicionar volume de armazenamento**.

1. Configure o volume de armazenamento adicional:
   + **Nome do volume**: escolha `rdsdbdata2`, `rdsdbdata3` ou `rdsdbdata4`.
   + **Tipo de armazenamento**: escolha **SSD de uso geral (gp3)** ou **SSD de IOPS provisionadas (io2)**.
   + **Armazenamento alocado**: insira o tamanho do armazenamento em GiB (mínimo de 200 GiB).
   + Para armazenamento io2, configure ** IOPS provisionadas**.
   + Para armazenamento gp3, configure opcionalmente o **throughput de armazenamento**.

1. Escolha **Continuar**.

1. Quando as configurações estiverem de acordo com as suas preferências, escolha **Modify DB instance (Modificar instância de banco de dados)**.

**Importante**  
Quando você adiciona um volume de armazenamento usando a operação `modify-db-instance`, o RDS adiciona o volume de armazenamento imediatamente, independentemente do parâmetro `--no-apply-immediately`. Se você tiver outras modificações na solicitação, o RDS as aplicará com base nas modificações do cronograma. Consulte [Usar a configuração de programação de modificações](USER_ModifyInstance.ApplyImmediately.md).

## AWS CLI
<a name="USER_PIOPS.ModifyingExisting.AdditionalVolumes.cli"></a>

Para adicionar um volume de armazenamento a uma instância de banco de dados, use o comando da 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). Defina os `--additional-storage-volumes` como uma matriz JSON especificando os volumes de armazenamento adicionais a serem incluídos ou modificados.

O exemplo a seguir adiciona um volume de armazenamento chamado `rdsdbdata2` com 5 mil GiB de armazenamento gp3 a `mydbinstance`. 

Quando você adiciona um volume de armazenamento, o RDS aplica a alteração imediatamente, independentemente do parâmetro `--no-apply-immediately`.

```
aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \
    --additional-storage-volumes '[
        {
            "VolumeName": "rdsdbdata2",
            "StorageType": "gp3",
            "AllocatedStorage": 5000,
            "StorageThroughput": 725
        }
    ]'
```

## API do RDS
<a name="USER_PIOPS.ModifyingExisting.AdditionalVolumes.api"></a>

Para adicionar um volume de armazenamento a uma instância de banco de dados, use a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) da API do Amazon RDS. Defina o parâmetro `AdditionalStorageVolumes` como uma matriz de especificações do volume de armazenamento adicional.

Quando você adiciona um volume de armazenamento usando a operação de API ModifyDBInstance, o RDS adiciona o volume de armazenamento imediatamente, independentemente da opção `ApplyImmediately` ser True ou False.