com.xensource.xenapi
Class VM.Record

java.lang.Object
  extended by com.xensource.xenapi.VM.Record
All Implemented Interfaces:
Types.Record
Enclosing class:
VM

public static class VM.Record
extends java.lang.Object
implements Types.Record

Represents all the fields in a VM


Field Summary
 Types.OnCrashBehaviour actionsAfterCrash
          action to take if the guest crashes
 Types.OnNormalExit actionsAfterReboot
          action to take after the guest has rebooted itself
 Types.OnNormalExit actionsAfterShutdown
          action to take after the guest has shutdown itself
 Host affinity
          a host which the VM has some affinity for (or NULL).
 java.util.Set<Types.VmOperations> allowedOperations
          list of the operations allowed in this state.
 java.util.Map<java.lang.String,java.lang.String> biosStrings
          BIOS strings
 java.util.Map<java.lang.String,Blob> blobs
          Binary blobs associated with this VM
 java.util.Map<Types.VmOperations,java.lang.String> blockedOperations
          List of operations which have been explicitly blocked and an error code
 java.util.Set<VM> children
          List pointing to all the children of this VM
 java.util.Set<Console> consoles
          virtual console devices
 java.util.Set<Crashdump> crashDumps
          crash dumps associated with this VM
 java.util.Map<java.lang.String,Types.VmOperations> currentOperations
          links each of the running tasks using this object (by reference) to a current_operation enum which describes the nature of the task.
 java.lang.String domarch
          Domain architecture (if available, null string otherwise)
 java.lang.Long domid
          domain ID (if available, -1 otherwise)
 VMGuestMetrics guestMetrics
          metrics associated with the running guest
 java.lang.Boolean haAlwaysRun
          if true then the system will attempt to keep the VM running as much as possible.
 java.lang.String haRestartPriority
          Only defined if ha_always_run is set possible values: "best-effort" meaning "try to restart this VM if possible but don't consider the Pool to be overcommitted if this is not possible"; and a numerical restart priority (e.g.
 java.util.Map<java.lang.String,java.lang.String> HVMBootParams
          HVM boot params
 java.lang.String HVMBootPolicy
          HVM boot policy
 java.lang.Double HVMShadowMultiplier
          multiplier applied to the amount of shadow that will be made available to the guest
 java.lang.Boolean isASnapshot
          true if this is a snapshot.
 java.lang.Boolean isATemplate
          true if this is a template.
 java.lang.Boolean isControlDomain
          true if this is a control domain (domain 0 or a driver domain)
 java.lang.Boolean isSnapshotFromVmpp
          true if this snapshot was created by the protection policy
 java.util.Map<java.lang.String,java.lang.String> lastBootCPUFlags
          describes the CPU flags on which the VM was last booted
 java.lang.String lastBootedRecord
          marshalled value containing VM record at time of last boot, updated dynamically to reflect the runtime state of the domain
 java.lang.Long memoryDynamicMax
          Dynamic maximum (bytes)
 java.lang.Long memoryDynamicMin
          Dynamic minimum (bytes)
 java.lang.Long memoryOverhead
          Virtualization memory overhead (bytes).
 java.lang.Long memoryStaticMax
          Statically-set (i.e.
 java.lang.Long memoryStaticMin
          Statically-set (i.e.
 java.lang.Long memoryTarget
          Dynamically-set memory target (bytes).
 VMMetrics metrics
          metrics associated with this VM
 java.lang.String nameDescription
          a notes field containg human-readable description
 java.lang.String nameLabel
          a human-readable name
 java.util.Map<java.lang.String,java.lang.String> otherConfig
          additional configuration
 VM parent
          Ref pointing to the parent of this VM
 java.lang.String PCIBus
          PCI bus path for pass-through devices
 java.util.Map<java.lang.String,java.lang.String> platform
          platform-specific configuration
 Types.VmPowerState powerState
          Current power state of the machine
 VMPP protectionPolicy
          Ref pointing to a protection policy for this VM
 java.lang.String PVArgs
          kernel command-line arguments
 java.lang.String PVBootloader
          name of or path to bootloader
 java.lang.String PVBootloaderArgs
          miscellaneous arguments for the bootloader
 java.lang.String PVKernel
          path to the kernel
 java.lang.String PVLegacyArgs
          to make Zurich guests boot
 java.lang.String PVRamdisk
          path to the initrd
 java.lang.String recommendations
          An XML specification of recommended values and ranges for properties of this VM
 Host residentOn
          the host the VM is currently resident on
 java.util.Map<java.lang.String,java.lang.String> snapshotInfo
          Human-readable information concerning this snapshot
 java.lang.String snapshotMetadata
          Encoded information about the VM's metadata this is a snapshot of
 VM snapshotOf
          Ref pointing to the VM this snapshot is of.
 java.util.Set<VM> snapshots
          List pointing to all the VM snapshots.
 java.util.Date snapshotTime
          Date/time when this snapshot was created.
 VDI suspendVDI
          The VDI that a suspend image is stored on.
 java.util.Set<java.lang.String> tags
          user-specified tags for categorization purposes
 java.lang.String transportableSnapshotId
          Transportable ID of the snapshot VM
 java.lang.Long userVersion
          a user version number for this machine
 java.lang.String uuid
          Unique identifier/object reference
 java.util.Set<VBD> VBDs
          virtual block devices
 java.lang.Long VCPUsAtStartup
          Boot number of VCPUs
 java.lang.Long VCPUsMax
          Max number of VCPUs
 java.util.Map<java.lang.String,java.lang.String> VCPUsParams
          configuration parameters for the selected VCPU policy
 java.util.Set<VIF> VIFs
          virtual network interfaces
 java.util.Set<VTPM> VTPMs
          virtual TPMs
 java.util.Map<java.lang.String,java.lang.String> xenstoreData
          data to be inserted into the xenstore tree (/local/domain//vm-data) after the VM is created.
 
Constructor Summary
VM.Record()
           
 
Method Summary
 java.util.Map<java.lang.String,java.lang.Object> toMap()
          Convert a VM.Record to a Map
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

uuid

public java.lang.String uuid
Unique identifier/object reference


allowedOperations

public java.util.Set<Types.VmOperations> allowedOperations
list of the operations allowed in this state. This list is advisory only and the server state may have changed by the time this field is read by a client.


currentOperations

public java.util.Map<java.lang.String,Types.VmOperations> currentOperations
links each of the running tasks using this object (by reference) to a current_operation enum which describes the nature of the task.


powerState

public Types.VmPowerState powerState
Current power state of the machine


nameLabel

public java.lang.String nameLabel
a human-readable name


nameDescription

public java.lang.String nameDescription
a notes field containg human-readable description


userVersion

public java.lang.Long userVersion
a user version number for this machine


isATemplate

public java.lang.Boolean isATemplate
true if this is a template. Template VMs can never be started, they are used only for cloning other VMs


suspendVDI

public VDI suspendVDI
The VDI that a suspend image is stored on. (Only has meaning if VM is currently suspended)


residentOn

public Host residentOn
the host the VM is currently resident on


affinity

public Host affinity
a host which the VM has some affinity for (or NULL). This is used as a hint to the start call when it decides where to run the VM. Implementations are free to ignore this field.


memoryOverhead

public java.lang.Long memoryOverhead
Virtualization memory overhead (bytes).


memoryTarget

public java.lang.Long memoryTarget
Dynamically-set memory target (bytes). The value of this field indicates the current target for memory available to this VM.


memoryStaticMax

public java.lang.Long memoryStaticMax
Statically-set (i.e. absolute) maximum (bytes). The value of this field at VM start time acts as a hard limit of the amount of memory a guest can use. New values only take effect on reboot.


memoryDynamicMax

public java.lang.Long memoryDynamicMax
Dynamic maximum (bytes)


memoryDynamicMin

public java.lang.Long memoryDynamicMin
Dynamic minimum (bytes)


memoryStaticMin

public java.lang.Long memoryStaticMin
Statically-set (i.e. absolute) mininum (bytes). The value of this field indicates the least amount of memory this VM can boot with without crashing.


VCPUsParams

public java.util.Map<java.lang.String,java.lang.String> VCPUsParams
configuration parameters for the selected VCPU policy


VCPUsMax

public java.lang.Long VCPUsMax
Max number of VCPUs


VCPUsAtStartup

public java.lang.Long VCPUsAtStartup
Boot number of VCPUs


actionsAfterShutdown

public Types.OnNormalExit actionsAfterShutdown
action to take after the guest has shutdown itself


actionsAfterReboot

public Types.OnNormalExit actionsAfterReboot
action to take after the guest has rebooted itself


actionsAfterCrash

public Types.OnCrashBehaviour actionsAfterCrash
action to take if the guest crashes


consoles

public java.util.Set<Console> consoles
virtual console devices


VIFs

public java.util.Set<VIF> VIFs
virtual network interfaces


VBDs

public java.util.Set<VBD> VBDs
virtual block devices


crashDumps

public java.util.Set<Crashdump> crashDumps
crash dumps associated with this VM


VTPMs

public java.util.Set<VTPM> VTPMs
virtual TPMs


PVBootloader

public java.lang.String PVBootloader
name of or path to bootloader


PVKernel

public java.lang.String PVKernel
path to the kernel


PVRamdisk

public java.lang.String PVRamdisk
path to the initrd


PVArgs

public java.lang.String PVArgs
kernel command-line arguments


PVBootloaderArgs

public java.lang.String PVBootloaderArgs
miscellaneous arguments for the bootloader


PVLegacyArgs

public java.lang.String PVLegacyArgs
to make Zurich guests boot


HVMBootPolicy

public java.lang.String HVMBootPolicy
HVM boot policy


HVMBootParams

public java.util.Map<java.lang.String,java.lang.String> HVMBootParams
HVM boot params


HVMShadowMultiplier

public java.lang.Double HVMShadowMultiplier
multiplier applied to the amount of shadow that will be made available to the guest


platform

public java.util.Map<java.lang.String,java.lang.String> platform
platform-specific configuration


PCIBus

public java.lang.String PCIBus
PCI bus path for pass-through devices


otherConfig

public java.util.Map<java.lang.String,java.lang.String> otherConfig
additional configuration


domid

public java.lang.Long domid
domain ID (if available, -1 otherwise)


domarch

public java.lang.String domarch
Domain architecture (if available, null string otherwise)


lastBootCPUFlags

public java.util.Map<java.lang.String,java.lang.String> lastBootCPUFlags
describes the CPU flags on which the VM was last booted


isControlDomain

public java.lang.Boolean isControlDomain
true if this is a control domain (domain 0 or a driver domain)


metrics

public VMMetrics metrics
metrics associated with this VM


guestMetrics

public VMGuestMetrics guestMetrics
metrics associated with the running guest


lastBootedRecord

public java.lang.String lastBootedRecord
marshalled value containing VM record at time of last boot, updated dynamically to reflect the runtime state of the domain


recommendations

public java.lang.String recommendations
An XML specification of recommended values and ranges for properties of this VM


xenstoreData

public java.util.Map<java.lang.String,java.lang.String> xenstoreData
data to be inserted into the xenstore tree (/local/domain//vm-data) after the VM is created.


haAlwaysRun

public java.lang.Boolean haAlwaysRun
if true then the system will attempt to keep the VM running as much as possible.


haRestartPriority

public java.lang.String haRestartPriority
Only defined if ha_always_run is set possible values: "best-effort" meaning "try to restart this VM if possible but don't consider the Pool to be overcommitted if this is not possible"; and a numerical restart priority (e.g. 1, 2, 3,...)


isASnapshot

public java.lang.Boolean isASnapshot
true if this is a snapshot. Snapshotted VMs can never be started, they are used only for cloning other VMs


snapshotOf

public VM snapshotOf
Ref pointing to the VM this snapshot is of.


snapshots

public java.util.Set<VM> snapshots
List pointing to all the VM snapshots.


snapshotTime

public java.util.Date snapshotTime
Date/time when this snapshot was created.


transportableSnapshotId

public java.lang.String transportableSnapshotId
Transportable ID of the snapshot VM


blobs

public java.util.Map<java.lang.String,Blob> blobs
Binary blobs associated with this VM


tags

public java.util.Set<java.lang.String> tags
user-specified tags for categorization purposes


blockedOperations

public java.util.Map<Types.VmOperations,java.lang.String> blockedOperations
List of operations which have been explicitly blocked and an error code


snapshotInfo

public java.util.Map<java.lang.String,java.lang.String> snapshotInfo
Human-readable information concerning this snapshot


snapshotMetadata

public java.lang.String snapshotMetadata
Encoded information about the VM's metadata this is a snapshot of


parent

public VM parent
Ref pointing to the parent of this VM


children

public java.util.Set<VM> children
List pointing to all the children of this VM


biosStrings

public java.util.Map<java.lang.String,java.lang.String> biosStrings
BIOS strings


protectionPolicy

public VMPP protectionPolicy
Ref pointing to a protection policy for this VM


isSnapshotFromVmpp

public java.lang.Boolean isSnapshotFromVmpp
true if this snapshot was created by the protection policy

Constructor Detail

VM.Record

public VM.Record()
Method Detail

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object

toMap

public java.util.Map<java.lang.String,java.lang.Object> toMap()
Convert a VM.Record to a Map

Specified by:
toMap in interface Types.Record