Files
deb-python-pyvmomi/docs/vim/vm/Summary.rst
Shawn Hartsock 15f7be9a52 pyVmomi reStructured Text Documentation
This external documentation for pyVmomi was generated using Googly Docs
(aka Google Standard Documentation) which renders very cleanly in
GitHub. Internal documentation for a class should be done in Sphinx
format because tools like pyCharm and Eclipse can use that documentation
as a hint for code completion.

Note: External docs as Googly Docs, internal docs as Sphinx.

Closes bug#15
2014-06-17 14:07:42 -04:00

3.8 KiB

vim.vm.Summary

The summary data object type encapsulates a typical set of virtual machine information that is useful for list views and summary pages.VirtualCenter can retrieve this information very efficiently, even for large sets of virtual machines.

extends

vmodl.DynamicData

Attributes:

vm (vim.VirtualMachine, optional):

Reference to the virtual machine managed object.

runtime (vim.vm.RuntimeInfo):

Runtime and state information of a running virtual machine. Most of this information is also available when a virtual machine is powered off. In that case, it contains information from the last run, if available.

guest (vim.vm.Summary.GuestSummary, optional):

Guest operating system and VMware Tools information. See guest for more information.

config (vim.vm.Summary.ConfigSummary):

Basic configuration information about the virtual machine. This information is not available when the virtual machine is unavailable, for instance, when it is being created or deleted.

storage (vim.vm.Summary.StorageSummary, optional):

Storage information of the virtual machine. It can be explicitly refreshed with the RefreshStorageInfo operation. 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.

quickStats (vim.vm.Summary.QuickStats):

A set of statistics that are typically updated with near real-time regularity. This data object type does not support notification, for scalability reasons. Therefore, changes in QuickStats do not generate property collector updates. To monitor statistics values, use the statistics and alarms modules instead.

overallStatus (vim.ManagedEntity.Status):

Overall alarm status on this node. 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.

customValue (vim.CustomFieldsManager.Value, optional):

Custom field values.