Questo contenuto non è disponibile nella lingua selezionata.
Chapter 16. Floating Disks
16.1. Floating Disk Elements Copia collegamentoCollegamento copiato negli appunti!
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 statistics sub-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_domain element contains an id attribute with the associated storage domain's GUID. Update this element with POST to 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 , locked or ok | The status of the disk device. These states are listed in disk_states under capabilities . | ![]() |
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 | true if the physical storage for the disk should not be preallocated. | ![]() |
bootable | Boolean: true or false | true if this disk is to be marked as bootable. | |
shareable | Boolean: true or false | true to share the disk with multiple virtual machines. | |
wipe_after_delete | Boolean: true or false | true if 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 | true if 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 storage element 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
.