Disk options for a region
Returns the disk sizes, terms, prices and zones you can buy in one region, with the servers in each zone a new disk could attach to.
Access: API key: vm:read · Session: any member.
- Disks attach only to servers in the same zone. Prices are per GB per month; a purchase is size × price × months, rounded up once.
- Two disk types:
premium(default) andssd(faster, from 20 GB). Each has its own price, smallest size and zones. min_gbis the smallest size sold: smaller disks are not offered.in_stockis false while the region is sold out; a purchase then returns409 out_of_stock.- Regions without disks of the type return
404.
AuthorizationBearer <token>Send Authorization: Bearer <token>. A token is an API key (lb_live_…, scoped, for programs) or a session (lb_sess_…, from signup or login, for people). See Authentication above.
region*stringRegion ID from GET /v1/regions.
type?stringDisk type (default premium).
"premium""ssd"X-Org-ID?stringSessions only: act on this organization (you must be a member). Default: your first organization.
Purchase options
application/json- response
region*stringtype*string"premium""ssd"in_stock*booleanFalse when the region has no disks left to sell (both types share the region's capacity). Orders are refused with out_of_stock until capacity returns.
min_gb*integermax_gb*integerstep_gb*integerterms*array<integer>per_server_limit*integerMost data disks one server can hold.
price_per_gb_month*Price per GB per month by billing currency (USD with five decimals, whole Rupiah).
zones*array<>curl -X GET 'https://layerbeat.com/v1/volume-options?region=sgp'{ "region": "sgp", "type": "premium", "in_stock": true, "min_gb": 10, "max_gb": 1000, "step_gb": 10, "terms": [ 1, 3, 12 ], "per_server_limit": 5, "price_per_gb_month": { "USD": "0.07770", "IDR": "1384" }, "zones": [ { "id": "sgp-1", "available": true, "servers": [ { "id": "vm_gnkrp6zuxvsqki7sqxeluvsw2y", "name": "web-1" } ] }, { "id": "sgp-2", "available": true, "servers": [] } ]}