Volumes

A volume is storage owned by your organization. Volume creation, inspection, and quota management are available independently of compute. Sandboxes cannot mount volumes yet; sandbox creation with a nonempty mounts array returns 501. Use file downloads or external storage for sandbox data you need to keep.

Create a volume

This creates a volume with a 10 GiB quota. Set VOLUME_ID to the returned id:

adapt volumes create --quota-bytes 10737418240

quotaBytes is a positive integer in bytes. Use null, or send {}, for no quota. A completed volume has status ready. If creation is unresolved, the allocation needs investigation, creating again with a new retry key may allocate another volume.

Inspect usage and change quotas

List volumes:

adapt volumes list --limit 50

Read one volume's status, quota, and usedBytes:

adapt volumes get "$VOLUME_ID"

An unknown usage value is null, rather than zero. Increase or change the quota with a PUT, repeating the same update is safe:

adapt volumes quota "$VOLUME_ID" --bytes 21474836480

Set quotaBytes to null to remove the quota. Volume deletion is currently unsupported. The delete API returns 501 for an unattached, ready volume and leaves its data intact.