list network-volume

Lists a network disk for rent as network volumes, or updates an existing listing with a new price/size/end date/discount.

CLI Usage: vastai list network-volume <disk_id> [options]

POST /api/v0/network_volume/

list network-volume

cURL

curl --request POST \
  --url https://console.vast.ai/api/v0/network_volume/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "disk_id": 123,
  "price_disk": 123,
  "size": 123,
  "credit_discount_max": 123,
  "end_date": 123
}
'

200

{
  "success": true,
  "disk_id": "created network volume ask with id 6 and size 24"
}

Authorizations

Authorization · string · header · required

API key must be provided in the Authorization header

Body

application/json

disk_id · integer · required

ID of network disk for which offer is being created

price_disk · number<float>

Price per GB of network volume storage

size · integer

Size in GB of the amount of space available to be rented

credit_discount_max · number<float>

Maximum discount rate allowed for prepaid credits

end_date · number<float>

Unix timestamp for when the listing expires

Response

200

application/json

Successful response

success · boolean

msg · string

status message