Create block-storage volume
The public edge resolves authoritative pricing from the server-owned product catalog and validates billing before forwarding this request to the existing portal volume flow. Client-supplied price or billing catalog objects are not accepted. Asynchronous: the response carries the volume operation; poll GET /block-storage/volumes/{volume_id}/operations until its status is succeeded or failed.
Authentication
IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.
Query parameters
The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.
Request
Display name of the volume (1-255 characters).
Size in GB (1-10000).
Optional public selector returned by the server-owned Block Storage catalog. The edge resolves all price and catalog metadata; callers cannot submit pricing.
Performance class of the volume.
capacity: lowest cost per GB.balanced: general purpose.performance: highest throughput and IOPS. Defaultbalanced.
Number of synchronous replicas kept for the volume (1-5). Default 2.
Caller-chosen key that makes a retried request return the original operation instead of starting a new one.
