Create Disk
POST
/disksCreate a new disk.
Size should be in gibibytes (GiB) or tebibytes (TiB) in the format [Size][GiB|TiB]. E.g. 10GiB.
A successful response from this resource will contain the async operation.
Request
Body Params application/json
name
string
required
Disk name
size
string
required
Disk size in gibibytes (GiB) or tebibytes (TiB) in the format [Size][GiB|TiB]
location
string
required
Location
block_size
integer <int64>
optional
Block size in bytes 512 or 4096
type
string
optional
Disk type
Allowed values:
persistent-ssdshared-volume
Default:
persistent-ssd
Example
{
"block_size": 4096,
"location": "us-northcentral1-a",
"name": "my-disk",
"size": "10GiB",
"type": "persistent-ssd"
}
Request samples
Responses
OK(200)
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
operation
object
required
completed_at
string
required
metadata
object
required
operation_id
string
required
result
object
required
started_at
string
required
state
string
required
Example
{
"operation": {
"completed_at": "2021-12-03T19:59:34Z",
"metadata": {},
"operation_id": "F6EF489C-086E-458D-B812-7962964A28C9",
"result": {},
"started_at": "2021-12-03T19:58:34Z",
"state": "IN_PROGRESS"
}
}
Modified at 2 months ago