Skip to main content
POST
/
v1
/
projects
/
{projectId}
/
volumes
Create a volume
curl --request POST \
  --url https://rest.compute.cudo.org/v1/projects/{projectId}/volumes \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "commitmentEndTime": "2023-11-07T05:31:56Z",
  "commitmentTerm": "COMMITMENT_TERM_NONE",
  "dataCenterId": "<string>",
  "gibPriceHr": {
    "value": "<string>"
  },
  "id": "<string>",
  "sizeGib": 123,
  "state": "VOLUME_STATE_UNSPECIFIED",
  "totalPriceHr": {
    "value": "<string>"
  }
}'
{
  "commitmentEndTime": "2023-11-07T05:31:56Z",
  "commitmentTerm": "COMMITMENT_TERM_NONE",
  "dataCenterId": "<string>",
  "gibPriceHr": {
    "value": "<string>"
  },
  "id": "<string>",
  "nfsPath": "<string>",
  "nfsServer": "<string>",
  "projectId": "<string>",
  "sizeGib": 123,
  "sizeGibUsed": 123,
  "state": "VOLUME_STATE_UNSPECIFIED",
  "totalPriceHr": {
    "value": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer HTTP authentication. Allowed headers-- Authorization: Bearer <api_key>

Path Parameters

​
projectId
string
required

Body

application/json

Create volume params

​
dataCenterId
string
required
​
id
string
required
​
sizeGib
integer
required
​
commitmentEndTime
string<date-time>
​
commitmentTerm
enum<string>
default:COMMITMENT_TERM_NONE
Available options:
COMMITMENT_TERM_NONE,
COMMITMENT_TERM_1_MONTH,
COMMITMENT_TERM_3_MONTHS,
COMMITMENT_TERM_6_MONTHS,
COMMITMENT_TERM_12_MONTHS,
COMMITMENT_TERM_24_MONTHS,
COMMITMENT_TERM_36_MONTHS,
COMMITMENT_TERM_60_MONTHS
​
gibPriceHr
object

A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's BigDecimal or Python's decimal.Decimal.

​
state
enum<string>
default:VOLUME_STATE_UNSPECIFIED
Available options:
VOLUME_STATE_UNSPECIFIED,
CREATING,
ACTIVE,
UPDATING,
DELETING,
FAILED
​
totalPriceHr
object

A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's BigDecimal or Python's decimal.Decimal.

Response

A successful response.

​
dataCenterId
string
required
​
id
string
required
​
projectId
string
required
​
sizeGib
integer
required
​
commitmentEndTime
string<date-time>
​
commitmentTerm
enum<string>
default:COMMITMENT_TERM_NONE
Available options:
COMMITMENT_TERM_NONE,
COMMITMENT_TERM_1_MONTH,
COMMITMENT_TERM_3_MONTHS,
COMMITMENT_TERM_6_MONTHS,
COMMITMENT_TERM_12_MONTHS,
COMMITMENT_TERM_24_MONTHS,
COMMITMENT_TERM_36_MONTHS,
COMMITMENT_TERM_60_MONTHS
​
gibPriceHr
object

A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's BigDecimal or Python's decimal.Decimal.

​
nfsPath
string
​
nfsServer
string
​
sizeGibUsed
integer
​
state
enum<string>
default:VOLUME_STATE_UNSPECIFIED
Available options:
VOLUME_STATE_UNSPECIFIED,
CREATING,
ACTIVE,
UPDATING,
DELETING,
FAILED
​
totalPriceHr
object

A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's BigDecimal or Python's decimal.Decimal.