List disks

get https://api.linode.com/{apiVersion}/linode/instances/{linodeId}/disks

View Disk information for Disks associated with this Linode.

linode-cli linodes disks-list 123


Learn more...

linodes:read_only


Learn more...

Responses

Response body

object

data

array of objects

data

object

created

date-time

Read-only When this disk was created.

disk_encryption

string

Defaults to enabled

Read-only Displays if encryption is enabled on this disk. This setting is based on the disk_encryption setting of the Linode.

filesystem

string

The disk's format or file system. A value of raw indicates no file system, just a raw binary stream. A value of swap indicates a Linux swap area. The values ext3 or ext4 represent these Linux journaling file systems. The value ext2 is the deprecated ext2 Linux file system. Finally, initrd indicates the disk is formatted as an uncompressed initial RAM disk.

📘
The ext2 file system doesn't properly support timestamps and will be removed from Linux support in the near future. Also, initrd is a legacy format that no longer applies to most use cases. As a best practice, use the other supported formats or file systems instead.

raw swap ext2 ext3 ext4 initrd

integer

Read-only This disk's ID. You need this value to run other operations that interact with the disk.

label

string

length between 1 and 48

Filterable The name of the disk. This is for display purposes only.

size

integer

Filterable The size of the disk in MB.

status

string

Read-only The current state of the disk.

ready not ready deleting

updated

date-time

Read-only When this disk was last updated.

page

integer

Read-only The current page.

pages

integer

Read-only The total number of pages.

results

integer

Read-only The total number of results.

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.linode.com/v4/linode/instances/linodeId/disks \
3
     --header 'accept: application/json'


xxxxxxxxxx
17
 
1
{
2
  "data": [
3
    {
4
      "created": "2018-01-01T00:01:01",
5
      "disk_encryption": "disabled",
6
      "filesystem": "ext4",
7
      "id": 25674,
8
      "label": "Debian 9 Disk",
9
      "size": 48640,
10
      "status": "ready",
11
      "updated": "2018-01-01T00:01:01"
12
    }
13
  ],
14
  "page": 1,
15
  "pages": 1,
16
  "results": 1
17
}

200Returns a paginated list of disks associated with this Linode.

📘

defaultSee Errors for the range of possible error response codes.