Skip to content

Service references

All operations require authentication.

1 operationv2/publicCloud/project
Agent setup

List block storage volume typesProduction

GET
/v2/publicCloud/project/{projectId}/reference/storage/block/volumeType

Returns the volume types with their IOPS, throughput and maximum volume size. The list holds one entry per volume type and region: a volume type sold in several regions appears once per region, with the figures of that region and the region in location. The regions already activated on the project and those the project can activate where a volume type is sold are both listed. location.regionActivated on each entry tells which regions must be activated on the project before use. location.availabilityZones lists the availability zones of the region, for example eu-west-par-a, eu-west-par-b and eu-west-par-c, and is empty for a single-AZ region. Entries are grouped by volume type, then sorted by region name. For IOPS and throughput, level is the baseline, maximum the upper limit a volume can burst to, and guaranteed tells whether the baseline is guaranteed. maximumSize is the maximum volume size in GB.

Path parameters

projectId
required
string

Project ID

Query parameters

region
string

Optional region filter, case-insensitive. Keeps the entries of this region only. A region that does not exist is rejected. One the project can neither use nor activate returns an empty list.

Headers

X-Pagination-Cursor
string

Pagination cursor

X-Pagination-Size
integer

Pagination size

Response

200VolumeType[]successful operation
iops
read-only
VolumeTypePerformance

Input/output operations per second of a volume of this type in this region

location
read-only
Location

Region where the volume type is sold to the project, whether that region is already activated on the project (regionActivated), and the availability zones of that region (availabilityZones), empty for a single-AZ region

maximumSize
read-only
integer

Maximum size of a volume of this type in this region in GB

name
read-only
VolumeTypeEnum

Volume type identifier, to use as the volume type when creating a volume

ValuesCLASSICHIGH_SPEEDHIGH_SPEED_GEN2
throughput
read-only
VolumeTypePerformance

Throughput of a volume of this type in this region. Null when no throughput figure is published for this region.

Example uses projectId = string

$ curl https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/reference/storage/block/volumeType \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ { "iops": { "guaranteed": true, "level": { "unit": "IOPS", "value": 0 }, "maximum": { "unit": "IOPS", "value": 0 } }, "location": { "availabilityZones": [ "string" ], "region": "string", "regionActivated": true }, "maximumSize": 0, "name": "CLASSIC", "throughput": { "guaranteed": true, "level": { "unit": "IOPS", "value": 0 }, "maximum": { "unit": "IOPS", "value": 0 } } }]