206
The disk-size parameter can be specified in bytes or using the IEC standard suffixes KiB (2
10
bytes),
MiB (2
20
bytes), GiB (2
30
bytes), and TiB (2
40
bytes).
The VM or VMs on which this operation should be performed are selected using the standard selection
mechanism (see VM selectors). Optional arguments can be any number of the VM parameters listed at the
beginning of this section.
vm-disk-list
vm-disk-list [vbd-params] [vdi-params] [<vm-selector>=<vm_selector_value>...]
Lists disks attached to the specified VMs. The vbd-params and vdi-params parameters control the fields
of the respective objects to output and should be given as a comma-separated list, or the special key all
for the complete list.
The VM or VMs on which this operation should be performed are selected using the standard selection
mechanism (see VM selectors). Optional arguments can be any number of the VM parameters listed at the
beginning of this section.
vm-disk-remove
vm-disk-remove device=<integer_label_of_disk> [<vm-selector>=<vm_selector_value>...]
Remove a disk from the specified VMs and destroy it.
The VM or VMs on which this operation should be performed are selected using the standard selection
mechanism (see VM selectors). Optional arguments can be any number of the VM parameters listed at the
beginning of this section.
vm-export
vm-export filename=<export_filename>
[metadata=<true | false>]
[<vm-selector>=<vm_selector_value>...]
Export the specified VMs (including disk images) to a file on the local machine. Specify the filename to export
the VM into using the filename parameter. By convention, the filename should have a .xva extension.
If the metadata parameter is true, then the disks are not exported, and only the VM metadata is written
to the output file. This is intended to be used when the underlying storage is transferred through other
mechanisms, and permits the VM information to be recreated (see the section called “vm-import”).
The VM or VMs on which this operation should be performed are selected using the standard selection
mechanism (see VM selectors). Optional arguments can be any number of the VM parameters listed at the
beginning of this section.
vm-import
vm-import filename=<export_filename>
[metadata=<true | false>]
[preserve=<true | false>]
[sr-uuid=<destination_sr_uuid>]
Import a VM from a previously-exported file. If preserve is set to true, the MAC address of the original
VM will be preserved. The sr-uuid determines the destination SR to import the VM into, and is the default
SR if not specified.
