Skip to main content
GET
/
projects
/
{projectId}
/
disks
/
{id}
Get Disk
curl --request GET \
  --url https://api.mkinf.io/v0.1/projects/{projectId}/disks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "attached_to": [
    {
      "attachment_type": "string",
      "mode": "string",
      "vm_id": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "block_size": 4096,
  "created_at": "2021-12-03T19:58:34Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "location": "us-northcentral1-a",
  "name": "my-disk",
  "serial_number": "96FD14FDBCF7E21E8EC",
  "size": "10GiB",
  "type": "persistent-ssd",
  "updated_at": "2021-12-03T19:58:34Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mkinf.io/llms.txt

Use this file to discover all available pages before exploring further.

Get detailed information about a specific disk, including:
  • Disk configuration
  • Attachment information
  • Size and type
  • Location

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
projectId
string<uuid>
required

Project id

​
id
string<uuid>
required

Disk id

Response

200 - application/json
​
id
string
required
​
name
string
required
​
attached_to
object[]
required
​
block_size
integer
required
​
location
string
required
​
serial_number
string
required
​
size
string
required

Disk size in gibibytes (GiB) or tebibytes (TiB) in the format [Size][GiB|TiB]

​
type
string
required
​
created_at
string
required
​
updated_at
string
required