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.
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
- Review top summary cards:
Used,Reserved,Limit, andFiles. - Check the
storageQuotaProgressbar: turns red (#DC2626) whenover_limit === true, showingstorageOverLimitNotice("Storage limit reached... New data and computations require free space."). - If
accounting_state !== "complete",storageAccountingStatenotes the timestamp (measured_at) of the latest server storage audit. - 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 (
searchTextdebounced), kind filter (All typesor a category fromkindOptions), and server-side sort (Created desc/asc,Size,Name). - Download file: Choose a destination path via
fileDialog. IfdestinationExists(path)is true,overwriteDialogprompts before replacing an existing local file. - Delete & Retry Deletion Operations: Confirm deletions in
storageDeleteDialog(storageDeletionProgressDialogtracks progress). Ifbytes_pending_deletion > 0, note they stay counted inUseduntil object cleanup finishes. Blocked or pending cleanups (state === "blocked"or"retry_pending") appear inDeletion 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 viacloseTransientUi().