Volumes

Create a shared volume (EFS access point created by the cell)

202 with the volume (state creating) and its volume_create operation; the volume becomes available when the cell has created its storage (poll the operation or the volume). Quotas from the plan: limit.shared_volumes_max (live volumes per organization) and limit.shared_volume_gib_max (sum of quota_gib across the organization’s live volumes) -> 403 quota_exceeded (details.limit shared_volumes_max for count or shared_volume_gib_total for capacity; current and limit_value in GiB for capacity); a plan without them -> 402 entitlement_required (details.reason limits_missing). org_shared: true (owners/admins only) makes it attachable from every project of the organization. 409 name_in_use. Supports Idempotency-Key.

post/v1/projects/{project_id}/volumes

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/projects/{project_id}/volumes
  • Auth: HTTP bearer

Path parameters

project_idstring uuid required

UUIDv7, lowercase canonical form.

Request body

namestring required

Unique among the project’s live volumes.

quota_gibinteger required
org_sharedboolean

Response

Default Response

Changes

No recorded changes to this operation across all 1 revision of this API.