SharedVolumeService

Create a shared volume

Changed on

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.

post/v1/compute/clusters/storage/volumes

Request

  • Base URL
    https://api.together.ai
  • URL
    https://api.together.ai/v1/compute/clusters/storage/volumes
  • Auth
    HTTP bearer

Request body

volume_namestring required

User provided name of the volume.

size_tibinteger required

Volume size in whole tebibytes (TiB).

regionstring required

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

is_lifecycle_independentboolean

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

project_idstring

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

instance_cluster_idstring

Cluster ID to place the volume on the same infrastructure as that GPU cluster.

Response

OK

volume_idstring required

ID of the volume.

volume_namestring required

User provided name of the volume.

size_tibinteger required

Size of the volume in TiB.

status'scheduled' | 'available' | 'bound' | 'provisioning' | 'deleting' | 'failed' | 'access_revoked' | 'unknown' required

Current status of the shared volume.

Changes