Shared Volume Service

Create a shared volume

POST
/compute/clusters/storage/volumes

Instant Clusters supports long-lived, resizable in-DC shared storage with user data persistence. You can dynamically create and attach volumes to your cluster at cluster creation time, and resize as your data grows. All shared storage is backed by multi-NIC bare metal paths, ensuring high-throughput and low-latency performance for shared storage.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

Request body for creating a shared volume.

volume_name*string

User provided name of the volume.

size_tib*integer

Volume size in whole tebibytes (TiB).

region*string

Region name. Usable regions can be found from clusters.list_regions()

is_lifecycle_independent?boolean

When true, the shared volume is not deleted when the cluster is decommissioned.

project_id?string

Project ID that will own the volume. When omitted, the caller's default project is used.

instance_cluster_id?string

Cluster ID to pin the volume to the same substrate as that GPU cluster.

Response Body

application/json

curl -X POST "https://example.com/compute/clusters/storage/volumes" \  -H "Content-Type: application/json" \  -d '{    "volume_name": "string",    "size_tib": 0,    "region": "string"  }'
{  "volume_id": "string",  "volume_name": "string",  "size_tib": 0,  "status": "scheduled"}