Create a network volume

Provisions a new network volume in the specified data center.

POST /v2/network-volumes

Error

A valid request URL is required to generate request examples

201

{
  "id": "agv6w2qcg7",
  "name": "my-dataset",
  "size": 50,
  "dataCenter": "EU-RO-1",
  "tags": [
    {
      "id": "tag_abc123",
      "key": "project",
      "value": "gpt-training",
      "resources": [
        {
          "id": "pod_abc123",
          "type": "POD"
        }
      ]
    }
  ]
}

{
  "title": "Not Found",
  "status": 404,
  "detail": "pod not found"
}

{
  "title": "Not Found",
  "status": 404,
  "detail": "pod not found"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string · required

Human-readable name

Minimum string length: 1

Example:

"my-dataset"

size · integer · required

Storage to allocate in GB

Required range: 10 <= x <= 4096

Example:

50

dataCenter · string · required

Data center in which to create the volume

Minimum string length: 1

Example:

"EU-RO-1"

type · enum<string>

Storage tier for the volume. Optional. When omitted, the volume is provisioned using the requested data center's default (primary) storage tier. HIGH_PERFORMANCE provisions a high-performance (HPS) volume; STANDARD provisions a standard volume. A volume's tier is immutable after creation.

Available options: STANDARD, HIGH_PERFORMANCE

Response

201

application/json

Created

id · string · required

Unique network volume identifier

Example:

"agv6w2qcg7"

name · string · required

Human-readable name (not required to be unique)

Example:

"my-dataset"

size · integer · required

Allocated storage in GB

Required range: 10 <= x <= 4096

Example:

50

dataCenter · string · required

Data center location; immutable after creation

Example:

"EU-RO-1"

type · enum<string> · required

Storage tier of this volume. Set at creation and immutable.

Available options: STANDARD, HIGH_PERFORMANCE

tags · object[] · required

Tags attached to this network volume.

Show child attributes