Skip to content

Storage Tab

Overview

The Storage tab (StoragePage.qml, route Storage) manages cloud artifact storage ("Cloud files in <spaceName> for the active profile") stored in server-owned object storage (MinIO/S3) for the currently signed-in account and active personal/organization tenant.

Storage view showing Used/Reserved/Limit summary metrics, quota progress bar, category breakdown pills, deletion operations, and searchable cloud file table.

Availability & Prerequisites

  • Signed-In Session (storageVm.signedIn): When signed out, displays "Sign in to view your cloud storage — Storage follows the account selected in the active profile."
  • Tenant Context: Reflects the space (spaceName) for your active personal or organization tenant set in Organizations.

Step-by-Step User Workflows

1. Monitor Quota, Pending Deletions & Categories

  1. Review top summary cards: Used, Reserved, Limit, and Files.
  2. Check the storageQuotaProgress bar: turns red (#DC2626) when over_limit === true, showing storageOverLimitNotice ("Storage limit reached... New data and computations require free space.").
  3. If accounting_state !== "complete", storageAccountingState notes the timestamp (measured_at) of the latest server storage audit.
  4. Review category chips (categoryRows), grouping bytes across:
    • dataset (Dataset)
    • inference_input (Inference input)
    • model_package (Model package)
    • validation_report (Validation report)
    • system_overhead (System storage)

2. Search, Filter, Download & Delete Cloud Files

  • Filter files by text search (searchText debounced), kind filter (All types or a category from kindOptions), and server-side sort (Created desc/asc, Size, Name).
  • Download file: Choose a destination path via fileDialog. If destinationExists(path) is true, overwriteDialog prompts before replacing an existing local file.
  • Delete & Retry Deletion Operations: Confirm deletions in storageDeleteDialog (storageDeletionProgressDialog tracks progress). If bytes_pending_deletion > 0, note they stay counted in Used until object cleanup finishes. Blocked or pending cleanups (state === "blocked" or "retry_pending") appear in Deletion operations (storageDeletionOperationsTable) with a retry cleanup action.
flowchart TD
    SignIn["Signed-In Profile & Active Tenant"] --> Summary["Quota Summary: Used + Reserved vs Limit"]
    Summary -->|Over Limit| Warning["New Uploads / Compute Blocked Until Freeing Space"]
    Summary --> Inventory["Filter & Sort Cloud Files Table"]
    Inventory --> Download["Download File -> Check Overwrite -> Presigned Download"]
    Inventory --> Delete["Request Delete -> Track in Deletion Operations"]
    Delete -->|blocked / retry_pending| Retry["Retry Cleanup Action"]

UI Controls & Tables Reference

Summary & Error Banner Controls

Element Object Name Visibility Condition Description
Active Space & Refresh storageSpaceName, storageRefreshButton Always in header Displays active tenant space and triggers storageVm.refresh()
Error Banner storageErrorBanner When errorMessage !== "" Displays error text with a Retry button
Quota Bar storageQuotaProgress When limit_bytes !== null Progress ratio (used_bytes + reserved_bytes) / limit_bytes
Category Pills storageCategoryBreakdown Always when summary loaded Displays <Category label>: <size_label> pills

Deletion Operations Table (storageDeletionOperationsTable)

Shown whenever deletionOperationRows.length > 0 (pageSize: 5):

Column Key Header Label Width Description
operation_id Operation 220px (monospace) Server deletion operation ID
state_label Status Flex fill Deletion workflow status
pending_bytes_label Pending 110px Remaining bytes awaiting reclaim (blank when <= 0)
actions Actions Action icons Retry cleanup (enabled when state is blocked or retry_pending)

Technical Reference

  • Presigned Access Boundary: The backend owns all MinIO/S3 access decisions and generates scoped temporary presigned URLs; the desktop never holds object-store master credentials.
  • State Reset Helper: Transient dialogs (storageDeleteDialog, storageDeletionProgressDialog, overwriteDialog, fileDialog) and filters reset cleanly via closeTransientUi().