# Modificación de una instancia de base de datos de Amazon RDS
<a name="Overview.DBInstance.Modifying"></a>

Puede cambiar la configuración de una instancia de base de datos para realizar tareas tales como añadir almacenamiento adicional o cambiar la clase de instancia de base de datos. En este tema, aprenderá a modificar una instancia de base de datos de Amazon RDS y acerca de la configuración de las instancias de base de datos. 

Recomendamos que pruebe cualquier cambio en una instancia de prueba antes de modificar una instancia de producción para que pueda entender completamente el impacto de cada cambio. Esto le ayuda a comprender completamente el impacto de cada cambio. La prueba es especialmente importante al actualizar versiones de bases de datos. 

La mayoría de las modificaciones realizadas en una instancia de base de datos se pueden aplicar inmediatamente o se puede posponer hasta el siguiente periodo de mantenimiento. Algunas modificaciones, como los cambios de grupo de parámetros, requieren que reinicie manualmente la instancia de base de datos para que el cambio surta efecto. 

**importante**  
Algunas modificaciones provocan un tiempo de inactividad porque Amazon RDS debe reiniciar la instancia de base de datos para que el cambio surta efecto. Antes de modificar la configuración de una instancia de base de datos, evalúe los efectos que puede tener en la base de datos y en las aplicaciones. 

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

**Para modificar una instancia de base de datos**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación, elija **Databases (Bases de datos)** y, a continuación, seleccione la instancia de base de datos que desee modificar. 

1. Elija **Modify**. Aparece la página **Modify DB instance (Modificar instancia de base de datos)**.

1. Cambie los parámetros que desee. Para obtener más información acerca de cada ajuste, consulte [Configuración de instancias de base de datos](USER_ModifyInstance.Settings.md). 

1. Cuando haya realizado todos los cambios que desee, elija **Continue** y compruebe el resumen de las modificaciones. 

1. (Opcional) Seleccione **Apply immediately (Aplicar inmediatamente)** para aplicar los cambios inmediatamente. Si se selecciona esta opción, puede producirse un tiempo de inactividad en algunos casos. Para obtener más información, consulte [Uso de la configuración de la programación de modificaciones](USER_ModifyInstance.ApplyImmediately.md). 

1. En la página de confirmación, revise los cambios. Si son correctos, elija **Modify DB instance (Modificar instancia de base de datos)** para guardar los cambios. 

   O bien, elija **Back (Atrás)** para editar los cambios o **Cancel (Cancelar)** para cancelarlos. 

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

Para modificar una instancia de base de datos mediante la AWS CLI, llame al comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html). Especifique el identificador de instancias de bases de datos y los valores de las opciones que desea modificar. Para obtener más información acerca de cada opción, consulte [Configuración de instancias de base de datos](USER_ModifyInstance.Settings.md). 

**Example**  
El siguiente código modifica `mydbinstance` configurando el período de retención de copia de seguridad en 1 semana (7 días). El código permite la protección de eliminación mediante el uso de `--deletion-protection`. Para deshabilitar la protección de eliminación, use `--no-deletion-protection`. Los cambios se aplican durante el siguiente periodo de mantenimiento si se utiliza el parámetro `--no-apply-immediately`. Utilice `--apply-immediately` para aplicar los cambios inmediatamente. Para obtener más información, consulte [Uso de la configuración de la programación de modificaciones](USER_ModifyInstance.ApplyImmediately.md).   
Para Linux, macOS o 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**  
En el siguiente ejemplo, se agrega un volumen de almacenamiento a una instancia de base de datos de RDS para Oracle. El volumen adicional utiliza el almacenamiento gp3 con 5000 GiB de almacenamiento asignado y 12 000 IOPS.  

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

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

Para modificar una instancia de base de datos mediante la API de Amazon RDS, llame a la operación [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Especifique el identificador de instancias de bases de datos y los parámetros de la configuración que desea modificar. Para obtener información acerca de cada parámetro, consulte [Configuración de instancias de base de datos](USER_ModifyInstance.Settings.md).