Saltar al contenido principal
POST
Restaurar snapshot de la aplicación
string
requerido
El ID de la aplicación o de la base de datos en la que restaurar el snapshot.
string
requerido
El ID del snapshot que quieres restaurar.
string
requerido
El tipo de recurso. Valores posibles: applications, databases.
string
Opcional. Sustituye el recurso de destino para una restauración entre recursos. Si se omite, se restaura en el recurso indicado por id.
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

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

Respuestas de error

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.
  • 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.
Última modificación el 28 de octubre de 2026