CreaRack-SL

Endpoint GET /api/racks/backup/full/download/{job_id} — Descargar ZIP (v1.56.0)

Vista limpiaEditar
Entidadactivecreado Thu Jul 16#racks#export#backup#endpoint#async-jobs#streaming#multi-tenancy#rls

Signature

@router.get("/backup/full/download/{job_id}")
def backup_full_download(request, job_id: str):
    """GET /api/racks/backup/full/download/{job_id} - Descarga el ZIP de un backup async listo."""

Método: GET
Path: /api/racks/backup/full/download/{job_id}
Permisos: racks.admin
Respuesta: 200 OK (ZIP file, streaming) | 404 (no listo / no existe)

Descripción

Descarga el ZIP del backup completado, aislado por organización (RLS + ORM). El ZIP se auto-limpia tras servirse (POSIX unlink).

Response (200)

Content-Type: application/zip
Content-Disposition: attachment; filename="crearack_backup_ORGNAME_20260716_110418.zip"

[ZIP binary stream, ~50-500 MB típico]
  • Streaming: FileResponse no carga el ZIP en RAM. Evita el guard PayloadBudgetMiddleware (hard_limit 5 MB).

Response (404)

{
  "error": "Backup not ready"  // o "Backup file expired"
}
  • "Backup not ready": Job no encontrado o no está done aún.
  • "Backup file expired": Job está done pero el ZIP ya no existe en disco (se borró después de otra descarga).

Lógica interna

  1. Valida require_perm(request, "racks", "admin").
  2. Obtiene org = get_current_org(request).
  3. Query aislada por org + RLS: 
    job = AsyncJob.objects.filter(
    job_id=job_id,
    organization=org,
    kind=AsyncJob.Kind.BACKUP_FULL
).first()
  4. Verifica:
    • Job existe y es de esta org.
    • Job está en status "done".
    • Archivo ZIP existe en ASYNC_BACKUP_DIR.
  5. Sirve el ZIP con FileResponse (streaming).
  6. Auto-limpia con os.unlink(zip_path) inmediato (en POSIX, la inode se mantiene viva mientras el filehandle de FileResponse esté abierto).

Seguridad

Multi-tenancy

  • ORM filter: Job debe ser de organization=org (tabla FK).
  • RLS: Via get_current_org(request) que respeta las políticas de RLS en Postgres.
  • Resultado: Un admin de Org A no puede descargar backups de Org B.

Almacenamiento

  • ZIP guardado en MEDIA_ROOT/backups/async/{job_id}.zip.
  • Solo la tarea run_full_backup() puede escribir (no hay endpoint GET de listado).
  • Auto-limpieza al servirse.

Contenido

  • Datos: ~13 modelos, creds SNMP en claro (T1 decision, reversible al restaurar).
  • Uploads: Solo archivos referenciados por esta org (no cross-tenant bleed).

Consideraciones

  • Timeout descarga: 30 minutos típico (depende del size del ZIP y la red).
  • Reintentos: Si la descarga falla a mitad, el cliente debe re-hacer polling y re-intentar (el ZIP no se borra en el primer fallo).
  • Expiración: Sin lógica explícita de TTL (puede permanecer días). Future: agregar cron de limpieza.

Véase también

  • [[entity—racks—endpoint—backup-full-start]]
  • [[entity—racks—service—run-full-backup]]
  • [[entity—core—model—asyncjob]]
  • [[feature—racks—backup-restore-async-v156]]
  • [[concept—saas—multi-tenancy]]

Referenciado desde

Inicio
Yo