Snapshots
Obtener job de snapshot
Lee un job de snapshot o restauración de una aplicación o base de datos. Consúltalo hasta que termine. Requiere el scope snapshots:read.
GET
Obtener job de snapshot
Usa esta ruta para seguir una restauración (
Esta ruta admite 120 peticiones por minuto.
response.job_id) o un snapshot manual
que respondió 202 (response.job_id). Consúltala cada pocos segundos hasta que el status sea ready, skipped o failed.
La forma del job es la descrita en Listar jobs de snapshot.
El ID de la aplicación o de la base de datos a la que pertenece el job. En una restauración, es el recurso que se está restaurando.
Respuesta
El job:
id, kind, resource_id, origin (solo en los jobs de snapshot), status, reason (cuando está failed o skipped), details (los detalles de ese error, cuando los hay), snapshot_id (el snapshot que produjo un job snapshot, siempre presente cuando está ready; en un job restore, el snapshot que se está restaurando), created_at, started_at, finished_at y, mientras está running, progress.Solo mientras el job está
running, y puede faltar (por ejemplo justo al empezar, o cuando no se conoce el progreso). No se envía en ningún otro estado.Respuestas de error
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: Falta la cabeceraAuthorization, 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 scopesnapshots:read(403).ACCESS_DENIED: Eres miembro de un workspace sin el permiso para esta acción, o no enviaste elworkspace_id(403).SNAPSHOT_NOT_FOUND: No se encontró (404).INTERNAL_SERVER_ERROR: Ocurrió un error inesperado del servidor.
Última modificación el 20 de noviembre de 2026