# Modificar configurações do armazenamento SSD de uso geral (gp3)
<a name="USER_PIOPS.gp3"></a>

Modifique as configurações de uma instância de banco de dados que usa o armazenamento SSD de uso geral (gp3) utilizando o console do Amazon RDS, a AWS CLI ou a API do Amazon RDS. Especifique o tipo de armazenamento, o armazenamento alocado, a quantidade de IOPS provisionadas e o throughput de armazenamento necessários.

Embora seja possível reduzir a quantidade de IOPS provisionadas e de throughput de armazenamento da instância de banco de dados, não é possível reduzir o tamanho do armazenamento.

Na maioria dos casos, não é necessário realizar uma interrupção para escalar o armazenamento. Depois de modificar as IOPS de armazenamento de uma instância de banco de dados, o status dessa instância será **storage-optimization**. Você pode esperar latências elevadas, mas ainda no intervalo de milissegundo de um dígito, durante a otimização do armazenamento. A instância de banco de dados fica totalmente operacional após uma modificação de armazenamento.

**nota**  
Não é possível fazer outras modificações de armazenamento até seis (6) horas após a conclusão da otimização de armazenamento na instância.

Para obter informações sobre os intervalos de armazenamento alocado, IOPS provisionadas e throughput disponíveis para cada mecanismo de banco de dados, consulte [Armazenamento gp3 (recomendado)](CHAP_Storage.md#gp3-storage).

## Console
<a name="USER_PIOPS.gp3.Console"></a>

**Como alterar as configurações de performance de armazenamento para 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)**.

   Para filtrar a lista de instâncias de banco de dados, em **Filter databases (Filtrar bancos de dados)**, digite uma string de texto para que o Amazon RDS use nos filtros dos resultados. Serão exibidas apenas as instâncias de banco de dados cujos nomes contiverem a string.

1. Selecione a instância de banco de dados com armazenamento gp3 que você deseja modificar.

1. Escolha **Modificar**.

1. Na página **Modificar instância de banco de dados**, selecione **SSD de uso geral (gp3)** em **Tipo de armazenamento** e faça o seguinte:

   1. Em **Provisioned IOPS** (IOPS provisionadas), selecione um valor.

      Se o valor especificado para **Allocated storage** (Armazenamento alocado) ou **Provisioned IOPS** (IOPS provisionadas) estiver fora dos limites aceitos pelo outro parâmetro, uma mensagem de aviso será exibida. Essa mensagem fornece o intervalo de valores necessários para os outros parâmetros.

   1. Em **Storage throughput** (Throughput de armazenamento), selecione um valor.

      Se o valor especificado para **Provisioned IOPS** (IOPS provisionadas) ou **Storage throughput** (Throughput de armazenamento) estiver fora dos limites aceitos pelo outro parâmetro, uma mensagem de aviso será exibida. Essa mensagem fornece o intervalo de valores necessários para os outros parâmetros.

1. Escolha **Continue**.

1. Selecione **Apply immediately** (Aplicar imediatamente) na seção **Scheduling of modifications** (Agendamento de modificações) para aplicar as alterações à instância de banco de dados imediatamente. Ou escolha **Apply during the next scheduled maintenance window (Aplicar durante a próxima janela de manutenção programada)** para aplicar as alterações na próxima janela de manutenção.

1. Revise os parâmetros a serem alterados e escolha **Modify DB instance (Modificar instância de banco de dados)** para concluir a modificação.

   O novo valor de IOPS provisionadas é exibido na coluna **Status**.

## AWS CLI
<a name="USER_PIOPS.gp3.CLI"></a>

Para alterar as configurações de performance de armazenamento para uma instância de banco de dados, use o comando [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) da AWS CLI. Defina os seguintes parâmetros:
+ `--storage-type`: defina como `gp3` para SSD de uso geral (gp3).
+ `--allocated-storage`: quantidade de armazenamento a ser alocada para a instância de banco de dados, em gibibytes.
+ `--iops`: a nova quantidade de IOPS provisionadas para a instância de banco de dados, expressa em operações de E/S por segundo.
+ `--storage-throughput`: o novo throughput de armazenamento para a instância de banco de dados, expressa em MiBps.
+ `--apply-immediately`: use `--apply-immediately` para aplicar as alterações imediatamente. Use `--no-apply-immediately` (o padrão) para aplicar as alterações durante a próxima janela de manutenção.

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

Para alterar as configurações de armazenamento para uma instância de banco de dados, utilize a operação de API do Amazon RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Defina os seguintes parâmetros:
+ `StorageType`: defina como `gp3` para SSD de uso geral (gp3).
+ `AllocatedStorage`: quantidade de armazenamento a ser alocada para a instância de banco de dados, em gibibytes.
+ `Iops`: a nova taxa de IOPS para a instância de banco de dados, expressa em operações de E/S por segundo.
+ `StorageThroughput`: o novo throughput de armazenamento para a instância de banco de dados, expressa em MiBps.
+ `ApplyImmediately`: defina essa opção como `True` para aplicar as alterações imediatamente. Defina essa opção como `False` (o padrão) para aplicar as alterações durante a próxima janela de manutenção.