DigitalOcean-public.v2-new_Block Storage
Create a New Block Storage Volume
To create a new volume, send a POST request to /v2/volumes. Optionally, a filesystem_type attribute may be provided in order to automatically format the volume's filesystem. Pre-formatted volumes are automatically mounted when attached to Ubuntu, Debian, Fedora, Fedora Atomic, and CentOS Droplets created on or after April 26, 2018. Attaching pre-formatted volumes to Droplets without support for auto-mounting is not recommended.
post/v2/volumes
Request body
Example request
{
"id": "506f78a4-e098-11e5-ad9f-000f53306ae1",
"droplet_ids": [],
"name": "example",
"description": "Block store for examples",
"size_gigabytes": 10,
"created_at": "2020-03-02T17:00:49Z",
"tags": [
"base-image",
"prod"
],
"snapshot_id": "b0798135-fb76-11eb-946a-0a58ac146f33",
"filesystem_type": "ext4",
"region": "nyc3",
"filesystem_label": "example"
}Response
The response will be a JSON object with a key called volume. The value will be an object containing the standard attributes associated with a volume.
Example response
{
"volume": {
"id": "506f78a4-e098-11e5-ad9f-000f53306ae1",
"region": {
"name": "New York 1",
"slug": "nyc1",
"sizes": [
"s-1vcpu-1gb",
"s-1vcpu-2gb",
"s-1vcpu-3gb",
"s-2vcpu-2gb",
"s-3vcpu-1gb",
"s-2vcpu-4gb",
"s-4vcpu-8gb",
"s-6vcpu-16gb",
"s-8vcpu-32gb",
"s-12vcpu-48gb",
"s-16vcpu-64gb",
"s-20vcpu-96gb",
"s-24vcpu-128gb",
"s-32vcpu-192gb"
],
"features": [
"private_networking",
"backups",
"ipv6",
"metadata"
],
"available": true
},
"droplet_ids": [],
"name": "example",
"description": "Block store for examples",
"size_gigabytes": 10,
"filesystem_type": "ext4",
"filesystem_label": "example",
"created_at": "2020-03-02T17:00:49Z"
}
}