The VDI objects can be listed with the standard object listing command (xe vdi-list), and the parameters manipulated with the standard parameter commands. See the section called “Low-level Parameter Commands” for details.

VDI Parameters

VDIs have the following parameters:

Parameter Name

Description

Type

 

 

 

uuid

the unique identifier/object reference for

read only

 

the VDI

 

 

 

 

name-label

the name of the VDI

read/write

 

 

 

name-description

the description string of the VDI

read/write

 

 

 

allowed-operations

a list of the operations allowed in this state

read only set parameter

 

 

 

current-operations

a list of the operations that are currently in

read only set parameter

 

progress on this VDI

 

 

 

 

sr-uuid

SR in which the VDI resides

read only

 

 

 

vbd-uuids

a list of VBDs that refer to this VDI

read only set parameter

 

 

 

crashdump-uuids

list of crash dumps that refer to this VDI

read only set parameter

 

 

 

virtual-size

size of disk as presented to the VM, in

read only

 

bytes. Note that, depending on the storage

 

 

backend type, the size may not be respected

 

 

exactly

 

 

 

 

physical-utilisation

amount of physical space that the VDI is

read only

 

currently taking up on the SR, in bytes

 

 

 

 

type

type of VDI, for example, System or User

read only

 

 

 

sharable

true if this VDI may be shared

read only

 

 

 

read-only

true if this VDI can only be mounted read-

read only

 

only

 

 

 

 

storage-lock

true if this VDI is locked at the storage level

read only

 

 

 

parent

references the parent VDI, if this VDI is part

read only

 

of a chain

 

 

 

 

missing

true if SR scan operation reported this VDI as

read only

 

not present

 

 

 

 

other-config

additional configuration information for this

read/write map parameter

 

VDI

 

 

 

 

sr-name-label

name of the containing storage repository

read only

 

 

 

location

location information

read only

 

 

 

managed

true if the VDI is managed

read only

 

 

 

161

Page 179
Image 179
Citrix Systems 6 manual VDI Parameters, Vdi