Storage Connections
A connection links a cloud storage bucket to Roset. Once connected, Roset can enumerate files in your bucket, issue signed URLs for direct upload and download, and sync file metadata into its catalog -- all without copying or proxying file bytes.
This is central to how Roset works: your data stays in your storage, and Roset manages the metadata, orchestration, and transformation.
Supported Providers
| Provider | Setup Method | Bucket Types |
|---|---|---|
| AWS | CloudFormation role | S3, S3-compatible |
| GCP | Service Account | GCS buckets |
| Azure | Service Principal | Blob containers |
| MinIO | Access Key | MinIO buckets |
Create a Connection
Test a Connection
Before syncing, verify that Roset can reach your bucket and has the required permissions.
Sync Files
Syncing enumerates files from your bucket and creates node records in Roset. This is a metadata-only operation -- Roset reads the file listing from your bucket but does not transfer any file bytes.
Browse Nodes
After syncing, browse files and folders through the nodes API. Nodes are metadata records that mirror your bucket's directory structure.
Manage Connections
Deleting a connection removes the metadata records from Roset. Your files in the cloud storage bucket are never modified or deleted by Roset.
Next Steps
- API Reference -- full connection and node endpoint documentation.
- Webhooks -- get notified when syncs complete.