Snapshots y restauraciones en segundo plano
Crear y restaurar un snapshot ya no tiene que caber en una sola petición. Las aplicaciones y bases de datos grandes ahora funcionan, y puedes seguir cada operación hasta el final.- Restauración. Restaurar un snapshot responde
202al instante con unjob_id, y la restauración se ejecuta en segundo plano. Una aplicación se reconstruye y se reinicia cuando termina. Mientras una restauración se ejecuta, las escrituras en el recurso responden409 RESTORE_IN_PROGRESS; leer y eliminar el recurso siguen permitidos. Una base de datos que no logra cargar los datos conserva los que tenía. - Crear un snapshot. Responde
201con el snapshot cuando queda listo en 90 segundos, o202con unjob_idcuando tarda más. El snapshot aparece en la lista cuando está listo. - Crear una aplicación o una base de datos a partir de un snapshot. Responde
202(antes,201) con unrestore_job_id, sin límite de tamaño más allá del almacenamiento del nuevo recurso (antes, 100 MB para una aplicación). Si la restauración falla, una aplicación creada a partir de código se elimina, mientras que una base de datos y una aplicación que ejecuta una imagen Docker propia se conservan tal como están, para que no se pierda nada de lo que hayas escrito. - Espacio insuficiente. Un snapshot que no cabe en el almacenamiento del destino se rechaza antes de cambiar nada con
SNAPSHOT_EXCEEDS_STORAGE, y en una base de datos la respuesta indica el menor tamaño de memoria que lo admite. - Un snapshot que no coincide con lo registrado cuando se hizo se rechaza con
SNAPSHOT_CORRUPTED, y no cambia nada. - Mientras una aplicación recibe un snapshot, los deploys, rollbacks, reinicios, arranques, paradas, cambios de variables de entorno, restauraciones y las escrituras del gestor de archivos esperan: responden
409 OPERATION_IN_PROGRESS, y puedes reintentar en unos instantes.
API
- Listar jobs de snapshot (
GET /v1/users/{id}/snapshots/jobs) y Obtener job de snapshot (GET /v1/users/{id}/snapshots/jobs/{job_id}) siguen un snapshot o una restauración hasta que elstatusseaready,skippedofailed, con elreasoncuando falla. Ambos usan el scopesnapshots:read. La lista aceptalimitde 1 a 50 (por defecto 10; un valor fuera de ese rango responde400 VALIDATION_ERROR), yscopees opcional al leer un solo job. - Restaurar snapshot responde
202conresponse.job_id. Elmessagede la respuesta anterior ya no existe. - Crear snapshot del stack también responde
202, con elidde la snapshot del stack y un job de snapshot por miembro (response.jobs), primero las bases de datos; antes esperaba a todos los miembros y podía cortarse en un stack grande. Cada miembro es una snapshot manual común, y la cuota y las comprobaciones de todos se hacen antes del202. Listar snapshots del stack muestra la snapshot del stack comopendingy luegoready(status), consnapshot_id: nully eljob_idde cada miembro mientras estápending; una snapshot del stack con un miembro fallido no se lista, y las que salieron bien siguen como snapshots comunes. Una snapshot del stackpendingno puede restaurarse (409 OPERATION_IN_PROGRESS), y no empieza una segunda mientras hay una en curso. - Restaurar snapshot del stack también responde
202ahora, con un job por miembro (response.jobs, cada uno conresource_id,resource_type,job_idy, cuando corresponde,warning). Los miembros se restauran en orden, primero las bases de datos; sigue cada job en Obtener job de snapshot. Si un miembro falla, los siguientes no se restauran y sus jobs fallan conSTACK_RESTORE_MEMBER_FAILED. La respuesta anterior, que esperaba a todos los miembros, ya no existe. - Los snapshots de la lista ahora traen
origin(manualoautomatic). Los jobs de snapshot traen el mismoorigin, ausente en los jobs de restauración.skippedes el estado de un job que no hizo nada porque el recurso dejó de existir o, en una base de datos, está detenida. restore_job_id(siempre presente,nullcuando no hay restore) en el estado de aplicaciones y bases de datos (Estado de la aplicación, Estado de todas las aplicaciones, Estado de la base de datos y Estado de todas las bases de datos): se completa mientras un restore del recurso está en cola o en ejecución, y lo sigues en Obtener job de snapshot. Mientras tenga valor, el estado de la aplicación no incluyeinstalling.daily_backupsen las funciones del plan yauthor_iden el snapshot se eliminaron (author_idera siemprenull). Usadaily_app_backupsydaily_database_backupspara el plan, yoriginpara saber qué tomó un snapshot.- Un job de snapshot que falló ahora trae los
detailsde sureason(por ejemplo, el espacio necesario y el disponible enSNAPSHOT_EXCEEDS_STORAGE), un job de restauración trae elsnapshot_idque restaura, y un jobsnapshotque estáreadysiempre tiene elsnapshot_idque produjo. - Un recurso que no se encuentra ahora responde
404(APP_NOT_FOUND,DATABASE_NOT_FOUNDoIMAGE_NOT_FOUND) en lugar de403 ACCESS_DENIED.ACCESS_DENIEDse mantiene para el miembro de workspace sin el permiso de la acción. Descargar un snapshot que no se encontró responde404 SNAPSHOT_NOT_FOUND(el403queda solo para el miembro de workspace sin permiso), y los jobs de snapshot de un recurso que no existe vuelven como lista vacía. Los workspaces siguen la misma regla: un workspace que no se encuentra responde404 WORKSPACE_NOT_FOUNDen lugar de403 WORKSPACE_PERMISSION_DENIED, que ahora solo indica un miembro cuyo rol no tiene el permiso. WORKSPACE_INVITES_DISABLEDse eliminó de los códigos de error y ya no se devuelve. Invitar por correo a una cuenta que desactivóworkspace_invites_enabledahora responde como cualquier otra invitación: queda pendiente y no se envía ningún correo, así que la respuesta no revela si el correo tiene cuenta. El ajuste solo controla si la cuenta recibe el correo de invitación.- Nuevos códigos de error:
STACK_RESTORE_MEMBER_FAILED,RESTORE_IN_PROGRESS,SNAPSHOT_EXCEEDS_STORAGE,SNAPSHOT_CORRUPTED,SNAPSHOT_TIMEOUTyDATABASE_NOT_READY. Consulta los códigos de error. - En una actualización de plantilla, los pasos
snapshotyrollbackdel job de deploy traenjobs(resource_id,resource_type,job_id) con el job de snapshot o de restauración de cada recurso, para que sigas el progreso en Obtener job de snapshot.
Clientes actualizados
Los SDK, la CLI, el servidor MCP y la extensión de VS Code siguen el nuevo comportamiento.- SDK (JavaScript, Python y Go).
restoreresponde con eljob_idde la restauración, y cada SDK puede seguir un job hasta el final (snapshotJobs.wait,snapshot_jobs.waitySnapshotJobs.Wait), y hay helpers que hacen los dos pasos (snapshots.createAndWait,stacks.snapshots.createAndWaityrestoreAndWait, con los mismos nombres en snake_case en Python y al estilo Go en Go).apps.downloadtoma un snapshot manual, espera a que esté listo y lo descarga, y exigesnapshots:writeysnapshots:read. Un snapshot que tarda más se sigue hasta el final, y crear una aplicación o una base de datos a partir de un snapshot devuelve elrestore_job_id. Las descargas también pueden ir en flujo directo a un archivo, con memoria constante, sea cual sea el tamaño:snapshots.downloadToFile,snapshots.downloadStream,apps.downloadToFileyapps.downloadStreamen JavaScript,download_to_fileydownload_streamen Python, ySnapshots.DownloadToFileyApps.DownloadToFileen Go. - CLI.
vertra snapshot restoreahora espera a que la restauración termine por defecto (usa--no-waitpara recibir eljob_idal instante). El nuevovertra snapshot jobmuestra un job de snapshot o de restauración yvertra snapshot jobslos lista.vertra app downloadmantiene el nombre: toma un snapshot manual, espera a que esté listo y descarga el ZIP (cuenta en la cuota de snapshots manuales y exigesnapshots:writeysnapshots:read). Las descargas se escriben en el archivo a medida que llegan los bytes. - MCP.
restore_snapshotresponde con unjob_id, ycreate_snapshotresponde{ status: "accepted", job_id }cuando tarda más. La nueva herramientalist_snapshot_jobslista los jobs de un recurso, yget_snapshot_jobsigue un job (exige eljob_id).download_appmantiene el nombre: toma un snapshot manual, espera a que esté listo y descarga.create_appycreate_databaseaceptan unsnapshot_id.download_appydownload_snapshottambién escriben el archivo a medida que llega. - Extensión de VS Code. Restaurar muestra el progreso mientras espera a que el job empiece y se ejecute.
Descarga un proyecto de cualquier tamaño
Un proyecto de cualquier tamaño se puede descargar, sin el límite de 300 MB: haces un snapshot manual y lo descargas. El snapshot aparece en tu lista, usa la cuota de snapshots manuales y se conserva 30 días.- Crear snapshot (
POST /v1/users/{id}/snapshots?scope=applications) responde201con el snapshot, o202con unjob_id. - Tras un
202, sigue el job en Obtener job de snapshot hasta que sustatusseaready; trae elsnapshot_id. - Descargar snapshot (
GET /v1/users/{id}/snapshots/{snapshot_id}/download?scope=applications) devuelve el ZIP.
DOWNLOAD_TOO_LARGEya no se devuelve al descargar una aplicación. Para un solo archivo, el gestor de archivos sigue leyéndolo (GET /v1/apps/{id}/files/content).- Una cuenta sin plan activo no puede hacer snapshots nuevos, pero sigue pudiendo listar y descargar los que tiene, incluido el que la plataforma guardó antes de retirar un proyecto.
Cambios que pueden romper tu integración
GET /v1/apps/{id}/downloadse eliminó. Ahora responde404. Usa los tres pasos de arriba. Una clave que solo tieneapps:filesya no descarga el proyecto: necesitasnapshots:writepara crear el snapshot ysnapshots:readpara descargarlo (403 API_KEY_SCOPE_DENIED, condetails.requiredensnapshots:read). Eldownload_idde la respuesta anterior desaparece con ella. Las versiones de SDK, CLI, MCP y extensión que llaman a la ruta antigua deben actualizarse.- Restablecer base de datos responde
{ "response": { "status": "success" } }(antes, la cadena"success"). - Crear una aplicación o una base de datos a partir de un snapshot responde
202(antes,201), con el mismo cuerpo y elrestore_job_id. warningpasó a cada elemento de la restauración de un stack. En Restaurar snapshot del stack,IMAGE_VERSION_NOT_FOUNDahora llega enresponse.jobs[].warning, en la aplicación a la que corresponde; elwarningde nivel superior ya no existe.RESTORE_COOLDOWNtraedetails.retry_after, también en el rollback. Toda respuesta condetails.retry_afterenvía además la cabeceraRetry-Aftercon el mismo número de segundos.- Restablecer una base de datos ahora exige el ámbito
databases:deleteen la clave de API (antes,databases:write) y, en un workspace, el permisodatabases:delete(antes,databases:manage). Una clave condatabases:writey sindatabases:deleteresponde403 API_KEY_SCOPE_DENIED.
Nuevos límites de snapshot
Los snapshots manuales pasan a medirse en las últimas 24 horas en lugar del día de calendario, y el límite crece con tu plan.- Cuota de la cuenta: 8 snapshots manuales por GB de RAM del plan en cualquier ventana de 24 horas, como mínimo 2, sin tope: 8 en Starter 1, 16 en Starter 2, 32 a 64 en Pro, 96 a 192 en Business y 256 a 4.096 en Enterprise. Una plaza vuelve 24 horas después de usarse, no a medianoche. Antes eran de 5 a 64 al día.
- Por recurso: un snapshot cada 3 minutos (antes, uno cada 5 minutos y hasta 5 al día). Ya no hay límite diario por recurso.
- Por usuario: una petición cada 5 segundos.
- Restauración: 60 segundos entre dos restauraciones de la misma aplicación; en una base de datos, 60 segundos para quien pide y 120 segundos por base de datos (antes, 30 segundos). Crear una aplicación o una base de datos a partir de un snapshot también espera 60 segundos por usuario (
429 RESTORE_COOLDOWN). SNAPSHOT_RATE_LIMITEDahora traedetails.scoperesourceoaccount;accounttambién traeresets_at. El scoperesource_dailyya no existe, y volver a pedir dentro de los 5 segundos responde el429 RATE_LIMIT_EXCEEDEDgenérico, conretry_after.- Los snapshots ya no están limitados a 4 GB: el límite es el almacenamiento del recurso.
Backups diarios por plan
Los backups diarios ahora siguen al plan: aplicaciones desde Business y bases de datos desde Pro. Los planes Starter no tienen backup diario, solo snapshots manuales. Una base de datos que está parada no entra en el backup diario.- Retención: todo snapshot se conserva 30 días. De los backups diarios, el más reciente de cada recurso se conserva 30 días y los anteriores 7.
- Los backups diarios no usan la cuota de snapshots manuales.
- Listar planes trae las nuevas características
daily_app_backupsydaily_database_backups.
Gestor de archivos
El gestor de archivos lee y guarda archivos de hasta 10 MiB. Un archivo mayor responde413 FILE_TOO_LARGE con details.max_bytes; usa la subida de archivos para archivos más grandes, y la descarga de un snapshot para el proyecto entero.Consulta Haz copias de seguridad y restaura con snapshots y Planes y límites.