disks

Overview

Name	disks
Type	Resource
Id	linode.instances.disks

Fields

Name	Datatype	Description
id	integer	This Disk's ID which must be provided for all operations impacting this Disk.
created	string	When this Disk was created.
filesystem	string	The Disk filesystem can be one of: raw - No filesystem, just a raw binary stream. swap - Linux swap area. ext3 - The ext3 journaling filesystem for Linux. ext4 - The ext4 journaling filesystem for Linux. * initrd - initrd (uncompressed initrd, ext2, max 32 MB).
label	string	The Disk's label is for display purposes only.
size	integer	The size of the Disk in MB.
status	string	A brief description of this Disk's current state. This field may change without direct action from you, as a result of operations performed to the Disk or the Linode containing the Disk.
updated	string	When this Disk was last updated.

Methods

Name	Accessible by	Required Params	Description
getLinodeDisk	SELECT	diskId, linodeId	View Disk information for a Disk associated with this Linode.
getLinodeDisks	SELECT	linodeId	View Disk information for Disks associated with this Linode.
addLinodeDisk	INSERT	linodeId, data__size	Adds a new Disk to a Linode. You can optionally create a Disk from an Image or an Empty Disk if no Image is provided with a request. When creating an Empty Disk, providing a label is required. If no label is provided, an image is required instead. When creating a Disk from an Image, root_pass is required. The default filesystem for new Disks is ext4. If creating a Disk from an Image, the filesystem of the Image is used unless otherwise specified. When deploying a StackScript on a Disk: See StackScripts List (GET /linode/stackscripts) for a list of available StackScripts. Requires a compatible Image to be supplied. See StackScript View (GET /linode/stackscript/{stackscriptId}) for compatible Images. It is recommended to supply SSH keys for the root User using the authorized_keys field. You may also supply a list of usernames via the authorized_users field. These users must have an SSH Key associated with their Profiles first. See SSH Key Add (POST /profile/sshkeys) for more information.
deleteDisk	DELETE	diskId, linodeId	Deletes a Disk you have permission to read_write. Deleting a Disk is a destructive action and cannot be undone.
_getLinodeDisk	EXEC	diskId, linodeId	View Disk information for a Disk associated with this Linode.
_getLinodeDisks	EXEC	linodeId	View Disk information for Disks associated with this Linode.
cloneLinodeDisk	EXEC	diskId, linodeId	Copies a disk, byte-for-byte, into a new Disk belonging to the same Linode. The Linode must have enough storage space available to accept a new Disk of the same size as this one or this operation will fail.
resetDiskPassword	EXEC	diskId, linodeId, data__password	Resets the password of a Disk you have permission to read_write.
resizeDisk	EXEC	diskId, linodeId, data__size	Resizes a Disk you have permission to read_write. The Disk must not be in use. If the Disk is in use, the request will succeed but the resize will ultimately fail. For a request to succeed, the Linode must be shut down prior to resizing the Disk, or the Disk must not be assigned to the Linode's active Configuration Profile. If you are resizing the Disk to a smaller size, it cannot be made smaller than what is required by the total size of the files current on the Disk.
updateDisk	EXEC	diskId, linodeId	Updates a Disk that you have permission to read_write.