# Actualización de una versión del motor de instantáneas de base de datos de PostgreSQL
<a name="USER_UpgradeDBSnapshot.PostgreSQL"></a>

Con Amazon RDS, puede crear una instantánea de base de datos de volumen de almacenamiento de su instancia de base de datos de PostgreSQL. Cuando se crea una instantánea de base de datos, se basa en la versión del motor empleada por la instancia de Amazon RDS. Puede actualizar la versión del motor para las instantáneas de base de datos. 

Después de restaurar una instantánea de base de datos actualizada a una nueva versión del motor, asegúrese que la actualización se ha realizado correctamente. Para obtener más información acerca de una actualización de versión principal, consulte [Actualizaciones del motor de base de datos de RDS para PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.md). Para aprender a restaurar una instantánea de base de datos, consulte [Restauración a una instancia de base de datos](USER_RestoreFromSnapshot.md).

Puede actualizar las instantáneas de base de datos manuales que están cifradas o no. 

Para ver las versiones de motor disponibles para la instantánea de base de datos de RDS para PostgreSQL, utilice el siguiente ejemplo de AWS CLI. 

```
aws rds describe-db-engine-versions --engine postgres  --engine-version example-engine-version --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text --include-all
```

Para obtener más información sobre las versiones de motor disponibles para las instantáneas de base de datos de RDS para PostgreSQL, consulte [Elección de una versión principal para una actualización de RDS para PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.MajorVersion.md).

**nota**  
No puede actualizar las instantáneas de base de datos automatizadas que se creen durante el proceso de backup automatizado.

## Consola
<a name="USER_UpgradeDBSnapshot.PostgreSQL.Console"></a>

**Para actualizar una instantánea 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 **Snapshots (Instantáneas)**.

1. Elija la instantánea que desea actualizar. 

1. En **Actions (Acciones)**, seleccione **Upgrade Snapshot (Actualizar instantánea)**. Aparece la página **Upgrade snapshot**. 

1. Elija la **New engine version (Nueva versión del motor)** a la que actualizarse.

1. Elija **Save changes (Guardar cambios)** para actualizar la instantánea.

   Durante el proceso de actualización, todas las acciones están deshabilitadas para esta instantánea de base de datos. Además, el estado de la instantánea de base de datos cambia de **available** a **upgrading** y después cambia a **active** al completarse. Si la instantánea de base de datos no se puede actualizar porque se ha dañado, el estado cambia a **unavailable**. No puede recuperar el snapshot desde este estado. 
**nota**  
Si la actualización de la base de datos falla, la instantánea se revierte al estado original con la versión original.

## AWS CLI
<a name="USER_UpgradeDBSnapshot.PostgreSQL.CLI"></a>

Para actualizar una instantánea de base de datos a una nueva versión del motor de base de datos, use el comando [modify-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-snapshot.html) de la AWS CLI. 

**Parameters**
+ `--db-snapshot-identifier`: identificador de la instantánea de base de datos que se va a actualizar. El identificador debe ser un Nombre de recurso de Amazon (ARN). Para obtener más información, consulte [Nombres de recursos de Amazon (ARN) en Amazon RDS](USER_Tagging.ARN.md).
+ `--engine-version`: versión del motor a la que se va a actualizar la instantánea de base de datos.

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

```
1. aws rds modify-db-snapshot \
2.     --db-snapshot-identifier my_db_snapshot \
3.     --engine-version new_version
```
Para Windows:  

```
1. aws rds modify-db-snapshot ^
2.     --db-snapshot-identifier my_db_snapshot ^
3.     --engine-version new_version
```

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

Para actualizar una instantánea de base de datos a una nueva versión del motor de base de datos, llame a la operación [ ModifyDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBSnapshot.html) de la API de Amazon RDS. 
+ `DBSnapshotIdentifier`: identificador de la instantánea de base de datos que se va a actualizar. El identificador debe ser un Nombre de recurso de Amazon (ARN). Para obtener más información, consulte [Nombres de recursos de Amazon (ARN) en Amazon RDS](USER_Tagging.ARN.md). 
+ `EngineVersion`: versión del motor a la que se va a actualizar la instantánea de base de datos.