API
  1. Volumes
  2. Volumes

Resize a volume

post
https://api.linode.com//volumes//resize

Increase the size of an existing Block Storage volume on your account.

📘

  • You can't decrease the size of an existing volume.

  • Only a volume with a status of active can be resized. Run the List volumes operation to view the status of each of your volumes.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

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

    • Permissions: resize_volume

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

    • Scopes: volumes:read_write

CLI

linode-cli volumes resize 12345 \
  --size 30

Learn more

Path Params
string
enum
required

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

Allowed:
integer
required

The unique identifier for the target volume. Run the List volumes operation and store the id for the target volume as your volumeId.

Body Params

The requested size to increase your Volume to.

integer
required
≤ 10240

The volume's size, in gigabytes.

Responses

Response body
object
date-time

Read-only When this volume was created.

string
enum

Read-only Whether encryption is enabled on this volume.

enabled disabled

string

Read-only The full file system path for the volume, based on its label. The path is /dev/disk/by-id/scsi-0Linode_Volume_label.

string
enum

Read-only The storage type of this volume. This can be either hdd to emulate a hard disk drive for the volume, or nvme to emulate a non-volatile memory express solid state drive.

hdd nvme

integer

Read-only The unique identifier for the volume.

boolean

Read-only Indicates whether the volume is successfully attached to a Linode and ready for read and write operations.

string
length between 1 and 32

Filterable The name of the volume. A label can be up to 32 characters long and contain alphanumeric characters, hyphens, and underscores. This value is also used in the volume's filesystem_path.

integer | null

The unique identifier of the Linode this volume is attached to, if applicable.

string | null

Read-only The name of the Linode this volume is attached to, if applicable.

locks
array of strings

Beta A resource lock applied to the Block Storage volume. You can optionally set up this lock to prevent you from inadvertently deleting the volume. Supported values here include:

  • cannot_delete. The volume itself can't be deleted. Any sub-resources assigned to it can be freely deleted. You need to unlock the volume by deleting its lock to delete the volume.

  • cannot_delete_with_subresources. The volume and various sub-resources assigned to it can't be deleted. For example, if a volume has a configuration profile interface assigned to it, this lock prevents you from deleting either of them. You need to unlock the resource (the volume) by deleting its lock. Then you can delete the volume and any of its sub-resources.

  • Empty. The volume doesn't have a resource lock configured. This is also empty when you clone a volume, because resource lock settings aren't carried to the cloned volume.

📘

This array appears for a volume only if you call this operation using the v4beta path parameter in the URL.

locks
string

The unique identifier for the region where the volume lives.

integer
≤ 10240

The volume's size, in gigabytes.

string
enum

Read-only The current status of the volume. This can be one of:

  • creating. The API is creating the volume and it's not ready for use.

  • active. The volume is online and ready for use.

  • resizing. The volume's capacity is being upgraded.

  • key_rotating. The volume's encryption keys are being rotated to new values. Requests to resize, delete, or clone a volume fail during encryption key rotation.

creating active resizing key_rotating

tags
array of strings

Filterable Any tags applied to this object. Use tags to label and organize your cloud computing resources.

tags
date-time

Read-only When this volume was last updated.

Updated 29 days ago

Did this page help you?
Language
Credentials

Updated 29 days ago

Did this page help you?