Data Object Description

Properties

Name	Type	Description
bootTime*	xsd:dateTime	The timestamp when the virtual machine was most recently powered on. This property is updated when the virtual machine is powered on from the poweredOff state, and is cleared when the virtual machine is powered off. This property is not updated when a virtual machine is resumed from a suspended state.
cleanPowerOff*	xsd:boolean	For a powered off virtual machine, indicates whether the virtual machine's last shutdown was an orderly power off or not. Unset if the virtual machine is running or suspended. *Since* vSphere API 4.0
connectionState	VirtualMachineConnectionState	Indicates whether or not the virtual machine is available for management.
consolidationNeeded	xsd:boolean	Whether any disk of the virtual machine requires consolidation. This can happen for example when a snapshot is deleted but its associated disk is not committed back to the base disk. Use ConsolidateVMDisks_Task to consolidate if needed. *Since* vSphere API 5.0
dasVmProtection*	VirtualMachineRuntimeInfoDasProtectionState	The vSphere HA protection state for a virtual machine. Property is unset if vSphere HA is not enabled. *Since* vSphere API 5.0
device*	VirtualMachineDeviceRuntimeInfo[]	Per-device runtime info. This array will be empty if the host software does not provide runtime info for any of the device types currently in use by the virtual machine. In releases after vSphere API 5.0, vSphere Servers might not generate property collector update notifications for this property. To obtain the latest value of the property, you can use PropertyCollector methods RetrievePropertiesEx or WaitForUpdatesEx. If you use the PropertyCollector.WaitForUpdatesEx method, specify an empty string for the version parameter. Since this property is on a DataObject, an update returned by WaitForUpdatesEx may contain values for this property when some other property on the DataObject changes. If this update is a result of a call to WaitForUpdatesEx with a non-empty version parameter, the value for this property may not be current. *Since* vSphere API 4.1
faultToleranceState	VirtualMachineFaultToleranceState	The fault tolerance state of the virtual machine. *Since* vSphere API 4.0
featureMask*	HostFeatureMask[]	The masks applied to an individual virtual machine as a result of its configuration. *Since* vSphere API 5.1
featureRequirement*	VirtualMachineFeatureRequirement[]	These requirements must have equivalent host capabilities featureCapability in order to power on, resume, or migrate to the host. *Since* vSphere API 5.1
host*	ManagedObjectReference to a HostSystem	The host that is responsible for running a virtual machine. This property is null if the virtual machine is not running and is not assigned to run on a particular host.
maxCpuUsage*	xsd:int	Current upper-bound on CPU usage. The upper-bound is based on the host the virtual machine is current running on, as well as limits configured on the virtual machine itself or any parent resource pool. Valid while the virtual machine is running. In releases after vSphere API 5.0, vSphere Servers might not generate property collector update notifications for this property. To obtain the latest value of the property, you can use PropertyCollector methods RetrievePropertiesEx or WaitForUpdatesEx. If you use the PropertyCollector.WaitForUpdatesEx method, specify an empty string for the version parameter. Since this property is on a DataObject, an update returned by WaitForUpdatesEx may contain values for this property when some other property on the DataObject changes. If this update is a result of a call to WaitForUpdatesEx with a non-empty version parameter, the value for this property may not be current.
maxMemoryUsage*	xsd:int	Current upper-bound on memory usage. The upper-bound is based on memory configuration of the virtual machine, as well as limits configured on the virtual machine itself or any parent resource pool. Valid while the virtual machine is running. In releases after vSphere API 5.0, vSphere Servers might not generate property collector update notifications for this property. To obtain the latest value of the property, you can use PropertyCollector methods RetrievePropertiesEx or WaitForUpdatesEx. If you use the PropertyCollector.WaitForUpdatesEx method, specify an empty string for the version parameter. Since this property is on a DataObject, an update returned by WaitForUpdatesEx may contain values for this property when some other property on the DataObject changes. If this update is a result of a call to WaitForUpdatesEx with a non-empty version parameter, the value for this property may not be current.
memoryOverhead*	xsd:long	Deprecated. As of vSphere API 4.1, use the PerformanceManager memory overhead counter to get this value. The amount of memory resource (in bytes) that will be used by the virtual machine above its guest memory requirements. This value is set if and only if the virtual machine is registered on a host that supports memory resource allocation features. For powered off VMs, this is the minimum overhead required to power on the VM on the registered host. For powered on VMs, this is the current overhead reservation, a value which is almost always larger than the minimum overhead, and which grows with time. See QueryMemoryOverheadEx
minRequiredEVCModeKey*	xsd:string	For a powered-on or suspended virtual machine in a cluster with Enhanced VMotion Compatibility (EVC) enabled, this identifies the least-featured EVC mode (among those for the appropriate CPU vendor) that could admit the virtual machine. See EVCMode. This property will be unset if the virtual machine is powered off or is not in an EVC cluster. This property may be used as a general indicator of the CPU feature baseline currently in use by the virtual machine. However, the virtual machine may be suppressing some of the features present in the CPU feature baseline of the indicated mode, either explicitly (in the virtual machine's configured cpuFeatureMask) or implicitly (in the default masks for the GuestOsDescriptor appropriate for the virtual machine's configured guest OS). *Since* vSphere API 4.1
needSecondaryReason*	xsd:string	If set, indicates the reason the virtual machine needs a secondary. *Since* vSphere API 4.0
numMksConnections	xsd:int	Number of active MKS connections to this virtual machine.
offlineFeatureRequirement*	VirtualMachineFeatureRequirement[]	These requirements must have equivalent host capabilities featureCapability in order to power on. *Since* vSphere API 5.1
onlineStandby	xsd:boolean	This property indicates whether the guest has gone into one of the s1, s2 or s3 standby modes, false indicates the guest is awake. *Since* vSphere API 5.1
powerState	VirtualMachinePowerState	The current power state of the virtual machine.
question*	VirtualMachineQuestionInfo	The current question, if any, that is blocking the virtual machine's execution.
recordReplayState	VirtualMachineRecordReplayState	Record / replay state of this virtual machine. *Since* vSphere API 4.0
suspendInterval*	xsd:long	The total time the virtual machine has been suspended since it was initially powered on. This time excludes the current period, if the virtual machine is currently suspended. This property is updated when the virtual machine resumes, and is reset to zero when the virtual machine is powered off.
suspendTime*	xsd:dateTime	The timestamp when the virtual machine was most recently suspended. This property is updated every time the virtual machine is suspended.
toolsInstallerMounted	xsd:boolean	Flag to indicate whether or not the VMware Tools installer is mounted as a CD-ROM.
Properties inherited from DynamicData
dynamicProperty, dynamicType

Name

Type

Description

bootTime*

xsd:dateTime

The timestamp when the virtual machine was most recently powered on.

This property is updated when the virtual machine is powered on from the poweredOff state, and is cleared when the virtual machine is powered off. This property is not updated when a virtual machine is resumed from a suspended state.

cleanPowerOff*

xsd:boolean

For a powered off virtual machine, indicates whether the virtual machine's last shutdown was an orderly power off or not. Unset if the virtual machine is running or suspended.

Since vSphere API 4.0

connectionState

VirtualMachineConnectionState

Indicates whether or not the virtual machine is available for management.

consolidationNeeded

xsd:boolean

Whether any disk of the virtual machine requires consolidation. This can happen for example when a snapshot is deleted but its associated disk is not committed back to the base disk. Use ConsolidateVMDisks_Task to consolidate if needed.

Since vSphere API 5.0

dasVmProtection*

VirtualMachineRuntimeInfoDasProtectionState

The vSphere HA protection state for a virtual machine. Property is unset if vSphere HA is not enabled.

Since vSphere API 5.0

device*

VirtualMachineDeviceRuntimeInfo[]

Per-device runtime info. This array will be empty if the host software does not provide runtime info for any of the device types currently in use by the virtual machine. In releases after vSphere API 5.0, vSphere Servers might not generate property collector update notifications for this property. To obtain the latest value of the property, you can use PropertyCollector methods RetrievePropertiesEx or WaitForUpdatesEx. If you use the PropertyCollector.WaitForUpdatesEx method, specify an empty string for the version parameter. Since this property is on a DataObject, an update returned by WaitForUpdatesEx may contain values for this property when some other property on the DataObject changes. If this update is a result of a call to WaitForUpdatesEx with a non-empty version parameter, the value for this property may not be current.

Since vSphere API 4.1

faultToleranceState

VirtualMachineFaultToleranceState

The fault tolerance state of the virtual machine.

Since vSphere API 4.0

featureMask*

HostFeatureMask[]

The masks applied to an individual virtual machine as a result of its configuration.

Since vSphere API 5.1

featureRequirement*

VirtualMachineFeatureRequirement[]

These requirements must have equivalent host capabilities featureCapability in order to power on, resume, or migrate to the host.

Since vSphere API 5.1

host*

ManagedObjectReference
to a HostSystem

The host that is responsible for running a virtual machine. This property is null if the virtual machine is not running and is not assigned to run on a particular host.

maxCpuUsage*

xsd:int

Current upper-bound on CPU usage. The upper-bound is based on the host the virtual machine is current running on, as well as limits configured on the virtual machine itself or any parent resource pool. Valid while the virtual machine is running. In releases after vSphere API 5.0, vSphere Servers might not generate property collector update notifications for this property. To obtain the latest value of the property, you can use PropertyCollector methods RetrievePropertiesEx or WaitForUpdatesEx. If you use the PropertyCollector.WaitForUpdatesEx method, specify an empty string for the version parameter. Since this property is on a DataObject, an update returned by WaitForUpdatesEx may contain values for this property when some other property on the DataObject changes. If this update is a result of a call to WaitForUpdatesEx with a non-empty version parameter, the value for this property may not be current.

maxMemoryUsage*

xsd:int

Current upper-bound on memory usage. The upper-bound is based on memory configuration of the virtual machine, as well as limits configured on the virtual machine itself or any parent resource pool. Valid while the virtual machine is running. In releases after vSphere API 5.0, vSphere Servers might not generate property collector update notifications for this property. To obtain the latest value of the property, you can use PropertyCollector methods RetrievePropertiesEx or WaitForUpdatesEx. If you use the PropertyCollector.WaitForUpdatesEx method, specify an empty string for the version parameter. Since this property is on a DataObject, an update returned by WaitForUpdatesEx may contain values for this property when some other property on the DataObject changes. If this update is a result of a call to WaitForUpdatesEx with a non-empty version parameter, the value for this property may not be current.

memoryOverhead*

xsd:long

Deprecated. As of vSphere API 4.1, use the PerformanceManager memory overhead counter to get this value.

The amount of memory resource (in bytes) that will be used by the virtual machine above its guest memory requirements. This value is set if and only if the virtual machine is registered on a host that supports memory resource allocation features.

For powered off VMs, this is the minimum overhead required to power on the VM on the registered host.

For powered on VMs, this is the current overhead reservation, a value which is almost always larger than the minimum overhead, and which grows with time.

See QueryMemoryOverheadEx

minRequiredEVCModeKey*

xsd:string

For a powered-on or suspended virtual machine in a cluster with Enhanced VMotion Compatibility (EVC) enabled, this identifies the least-featured EVC mode (among those for the appropriate CPU vendor) that could admit the virtual machine. See EVCMode. This property will be unset if the virtual machine is powered off or is not in an EVC cluster.

This property may be used as a general indicator of the CPU feature baseline currently in use by the virtual machine. However, the virtual machine may be suppressing some of the features present in the CPU feature baseline of the indicated mode, either explicitly (in the virtual machine's configured cpuFeatureMask) or implicitly (in the default masks for the GuestOsDescriptor appropriate for the virtual machine's configured guest OS).

Since vSphere API 4.1

needSecondaryReason*

xsd:string

If set, indicates the reason the virtual machine needs a secondary.

Since vSphere API 4.0

numMksConnections

xsd:int

Number of active MKS connections to this virtual machine.

offlineFeatureRequirement*

VirtualMachineFeatureRequirement[]

These requirements must have equivalent host capabilities featureCapability in order to power on.

Since vSphere API 5.1

onlineStandby

xsd:boolean

This property indicates whether the guest has gone into one of the s1, s2 or s3 standby modes, false indicates the guest is awake.

Since vSphere API 5.1

powerState

VirtualMachinePowerState

The current power state of the virtual machine.

question*

VirtualMachineQuestionInfo

The current question, if any, that is blocking the virtual machine's execution.

recordReplayState

VirtualMachineRecordReplayState

Record / replay state of this virtual machine.

Since vSphere API 4.0

suspendInterval*

xsd:long

The total time the virtual machine has been suspended since it was initially powered on. This time excludes the current period, if the virtual machine is currently suspended. This property is updated when the virtual machine resumes, and is reset to zero when the virtual machine is powered off.

suspendTime*

xsd:dateTime

The timestamp when the virtual machine was most recently suspended.

This property is updated every time the virtual machine is suspended.

toolsInstallerMounted

xsd:boolean

Flag to indicate whether or not the VMware Tools installer is mounted as a CD-ROM.

Properties inherited from DynamicData

dynamicProperty, dynamicType

Need not be set

Show WSDL type definition

         <complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VirtualMachineRuntimeInfo">
            <complexContent>
               <extension base="vim25:DynamicData">
                  <sequence>
                     <element name="device" type="vim25:VirtualMachineDeviceRuntimeInfo" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="host" type="vim25:ManagedObjectReference" minOccurs="0"/>
                     <element name="connectionState" type="vim25:VirtualMachineConnectionState"/>
                     <element name="powerState" type="vim25:VirtualMachinePowerState"/>
                     <element name="faultToleranceState" type="vim25:VirtualMachineFaultToleranceState" minOccurs="0"/>
                     <element name="dasVmProtection" type="vim25:VirtualMachineRuntimeInfoDasProtectionState" minOccurs="0"/>
                     <element name="toolsInstallerMounted" type="xsd:boolean"/>
                     <element name="suspendTime" type="xsd:dateTime" minOccurs="0"/>
                     <element name="bootTime" type="xsd:dateTime" minOccurs="0"/>
                     <element name="suspendInterval" type="xsd:long" minOccurs="0"/>
                     <element name="question" type="vim25:VirtualMachineQuestionInfo" minOccurs="0"/>
                     <element name="memoryOverhead" type="xsd:long" minOccurs="0"/>
                     <element name="maxCpuUsage" type="xsd:int" minOccurs="0"/>
                     <element name="maxMemoryUsage" type="xsd:int" minOccurs="0"/>
                     <element name="numMksConnections" type="xsd:int"/>
                     <element name="recordReplayState" type="vim25:VirtualMachineRecordReplayState" minOccurs="0"/>
                     <element name="cleanPowerOff" type="xsd:boolean" minOccurs="0"/>
                     <element name="needSecondaryReason" type="xsd:string" minOccurs="0"/>
                     <element name="onlineStandby" type="xsd:boolean" minOccurs="0"/>
                     <element name="minRequiredEVCModeKey" type="xsd:string" minOccurs="0"/>
                     <element name="consolidationNeeded" type="xsd:boolean" minOccurs="0"/>
                     <element name="offlineFeatureRequirement" type="vim25:VirtualMachineFeatureRequirement" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="featureRequirement" type="vim25:VirtualMachineFeatureRequirement" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="featureMask" type="vim25:HostFeatureMask" minOccurs="0" maxOccurs="unbounded"/>
                  </sequence>
               </extension>
            </complexContent>
         </complexType>

Data Object - VirtualMachineRuntimeInfo

Data Object Description