> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Restaurar snapshot de la aplicación

> Restaura un snapshot concreto en una aplicación o base de datos y, después, reconstruye o reinicia el recurso automáticamente.

**id** `string` *required*

El ID de la aplicación o de la base de datos en la que restaurar el snapshot.

**snapshot\_id** `string` *required*

El ID del snapshot que quieres restaurar.

**scope** `string` *required*

El tipo de recurso. Valores posibles: `applications`, `databases`.

**resource\_id** `string`

Opcional. Sustituye el recurso de destino para una restauración entre recursos. Si se omite, se restaura en el recurso indicado por `id`.

**restore\_image\_version** `boolean`

Solo para una aplicación que ejecuta una imagen Docker personalizada. Con `true`, la restauración también vuelve a la versión de la imagen que ejecutaba la aplicación cuando se tomó el snapshot, si todavía existe. Por defecto `false`: solo se restauran los datos y la aplicación mantiene su versión de imagen actual.

### Respuesta

**response** `object`

Confirmación de que se inició el proceso de restauración.

**Mostrar objeto**

**message** `string`

Un mensaje que confirma que la restauración se inició.

**warning** `string`

Aparece cuando `restore_image_version` era `true`, pero la versión de imagen registrada en el snapshot ya no existe: `IMAGE_VERSION_NOT_FOUND`. Solo se restauraron los datos y la aplicación sigue en su versión actual.

```json Response theme={null}
{
  "response": {
    "message": "Restoration started and rebuild triggered"
  }
}
```

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (`403`).
* `USER_NOT_FOUND`: No se encontró el usuario autenticado.
* `APP_NOT_FOUND`: La aplicación indicada no existe.
* `DATABASE_NOT_FOUND`: La base de datos indicada no existe.
* `ACCESS_DENIED`: El usuario no es propietario del recurso o del snapshot.
* `RESTORE_COOLDOWN`: Se hizo una restauración hace poco en este recurso. Espera antes de volver a intentarlo.
* `TYPE_MISMATCH`: El tipo de recurso del snapshot no coincide con el tipo del recurso de destino.
* `SNAPSHOT_ENGINE_MISMATCH`: El snapshot pertenece a un motor de base de datos distinto al del destino (`400`).
* `SNAPSHOT_VERSION_NEWER`: El snapshot se tomó en una versión mayor más nueva que la base de datos de destino; no se cambia nada (`400`).
* `SNAPSHOT_NOT_FOUND`: El snapshot indicado no existe.
* `INVALID_ZIP_STRUCTURE`: El archivo del snapshot está dañado, o un snapshot de aplicación no tiene archivos (`400`). La restauración se rechaza antes de cambiar nada: los archivos de la aplicación y la base de datos siguen como estaban.
* `OPERATION_IN_PROGRESS`: Otra operación de ciclo de vida sobre el mismo recurso ya está en curso (`409`). No se restauró nada; espera unos segundos y vuelve a intentarlo. Consulta [Códigos de error comunes](https://docs.vertracloud.app/es-es/api-reference/introduction.md#qué-códigos-de-error-puede-devolver-la-api).
* `SNAPSHOT_IMPORT_FAILED`: La restauración falló al cargar los datos (`500`). La base de datos queda en ejecución y vacía; el snapshot sigue disponible para volver a intentarlo.
* `INTERNAL_SERVER_ERROR`: Se produjo un error inesperado en el servidor.

```json Error Response (401) theme={null}
{
  "code": "AUTH_TOKEN_MISSING"
}
```

```json Error Response (403) theme={null}
{
  "code": "ACCESS_DENIED"
}
```

```json Error Response (404) theme={null}
{
  "code": "APP_NOT_FOUND"
}
```

```json Error Response (404) theme={null}
{
  "code": "SNAPSHOT_NOT_FOUND"
}
```

```json Error Response (429) theme={null}
{
  "code": "RESTORE_COOLDOWN"
}
```

```json Error Response (400) theme={null}
{
  "code": "TYPE_MISMATCH",
  "message": "Cannot restore snapshot to a different resource type"
}
```

```json Error Response (400) theme={null}
{
  "code": "SNAPSHOT_ENGINE_MISMATCH"
}
```

```json Error Response (500) theme={null}
{
  "code": "SNAPSHOT_IMPORT_FAILED"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.