API
  1. Linode instances
  2. Linode disks

Update a disk

put
https://api.linode.com//linode/instances//disks/

Update a specific disk on a Linode.

Permissions and scopes

To call this operation, you need the following:

  • Identity and access permissions. Your user needs a role with these permissions assigned. Learn more.

    • Permissions: update_linode_disk

  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: linodes:read_write

CLI

linode-cli linodes disk-update 123 25674 \
  --label "Debian 13 Disk"

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
integer
required

ID of the Linode to look up.

integer
required

ID of the Disk to look up.

Body Params
string
length between 1 and 48

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

Responses

Response body
object
date-time

Read-only When this disk was created.

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.

string
enum

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.

string
length between 1 and 48

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

integer

Filterable The size of the disk in MB.

string
enum

Read-only The current state of the disk.

ready not ready deleting

date-time

Read-only When this disk was last updated.

Updated 6 days ago

Did this page help you?
Language
Credentials

Updated 6 days ago

Did this page help you?