Questo contenuto non è disponibile nella lingua selezionata.
Chapter 16. Floating Disks
16.1. Floating Disk Elements
Copia collegamentoCollegamento copiato negli appunti!
		The 
disks collection provides information about all disks in a Red Hat Virtualization environment. A user attaches and detaches disks from any virtual machine and floats them between virtual machines. An API user accesses this information through the rel="disks" link obtained from the entry point URI.
	
		The following table shows specific elements contained in a 
disks resource representation.
	| Element | Type | Description | Properties | 
|---|---|---|---|
| link rel="statistics" | relationship | A link to the statisticssub-collection for a virtual machine's disk statistics. |   | 
| image_id | GUID | A reference to the virtual machine image stored on the defined storage domain. |   | 
| storage_domains | Complex | The storage domains associated with this disk. Each storage_domainelement contains anidattribute with the associated storage domain's GUID. Update this element withPOSTto perform live migration of a disk from one data storage domain to another. |   | 
| size | integer | Size of the disk in bytes. |   | 
| provisioned_size | integer | The provisioned size of the disk in bytes. |     | 
| actual_size | integer | Actual size of the disk in bytes. |   | 
| status | One of illegal,invalid,lockedorok | The status of the disk device. These states are listed in disk_statesundercapabilities. |   | 
| interface | enumerated | The type of interface driver used to connect to the disk device. A list of enumerated values is available in capabilities. | |
| format | enumerated | The underlying storage format. A list of enumerated values is available in capabilities. Copy On Write (COW) allows snapshots, with a small performance overhead. Raw does not allow snapshots, but offers improved performance. |   | 
| sparse | Boolean: true or false | trueif the physical storage for the disk should not be preallocated. |   | 
| bootable | Boolean: true or false | trueif this disk is to be marked as bootable. | |
| shareable | Boolean: true or false | trueto share the disk with multiple virtual machines. | |
| wipe_after_delete | Boolean: true or false | trueif the underlying physical storage for the disk should be zeroed when the disk is deleted. This increases security but is a more intensive operation and may prolong delete times. | |
| propagate_errors | Boolean: true or false | trueif disk errors should not cause virtual machine to be paused and, instead, disk errors should be propagated to the guest OS. | |
| quota id= | GUID | Sets a quota for the disk. | |
| lunStorage | complex | A reference to a direct LUN mapping for storage usage. Requires a storageelement that contains iSCSI or FCP device details. |   | 
| active | Boolean | Defines if the disk is connected to the virtual machine. |   | 
Important
			Search queries for disks based upon name require the 
alias search parameter instead of name.