Files
deb-python-pyvmomi/docs/vmodl/query/PropertyCollector/UpdateSet.rst
Shawn Hartsock c83651f5be pyvmomi RST docs do not properly show lists
Fixes RST documents to include list mark up when appropriate.

closes: https://github.com/vmware/pyvmomi/issues/76
2014-08-13 14:49:24 -04:00

43 lines
3.0 KiB
ReStructuredText

.. _str: https://docs.python.org/2/library/stdtypes.html
.. _bool: https://docs.python.org/2/library/stdtypes.html
.. _UpdateSet: ../../../vmodl/query/PropertyCollector/UpdateSet.rst
.. _truncated: ../../../vmodl/query/PropertyCollector/UpdateSet.rst#truncated
.. _ObjectUpdate: ../../../vmodl/query/PropertyCollector/ObjectUpdate.rst
.. _WaitForUpdates: ../../../vmodl/query/PropertyCollector.rst#waitForUpdates
.. _CheckForUpdates: ../../../vmodl/query/PropertyCollector.rst#checkForUpdates
.. _WaitForUpdatesEx: ../../../vmodl/query/PropertyCollector.rst#waitForUpdatesEx
.. _maxObjectUpdates: ../../../vmodl/query/PropertyCollector/WaitOptions.rst#maxObjectUpdates
.. _vmodl.DynamicData: ../../../vmodl/DynamicData.rst
.. _PropertyCollector: ../../../vmodl/query/PropertyCollector.rst
.. _PropertyFilterUpdate: ../../../vmodl/query/PropertyCollector/FilterUpdate.rst
.. _vmodl.query.PropertyCollector.FilterUpdate: ../../../vmodl/query/PropertyCollector/FilterUpdate.rst
vmodl.query.PropertyCollector.UpdateSet
=======================================
A set of updates that represent the changes since a prior call to `CheckForUpdates`_ , `WaitForUpdates`_ , or `WaitForUpdatesEx`_ .
:extends: vmodl.DynamicData_
Attributes:
version (`str`_):
New data version to pass in the next call to `CheckForUpdates`_ , `WaitForUpdates`_ , or `WaitForUpdatesEx`_ . These versions, although they are opaque, are strongly ordered in the sense that passing a version to `WaitForUpdates`_ , `CheckForUpdates`_ or `WaitForUpdatesEx`_ requests updates that reflect changes in the objects selected by the Filter that happened after the specified version.
filterSet ([`vmodl.query.PropertyCollector.FilterUpdate`_], optional):
Set of managed object updates detected by specific filters. Updates are reported in sets. Each set is associated with a reference to a filter that detected the updates in the set.
truncated (`bool`_, optional):
If true, this `UpdateSet`_ contains results from a suspended change calculation, which places restrictions on the use of version.The `PropertyCollector`_ may suspend a calculation due to server policy or if the total number of `ObjectUpdate`_ entries summed across every `PropertyFilterUpdate`_ reached the maximum specified in `maxObjectUpdates`_ . The client can pass the "truncated data version" to `WaitForUpdatesEx`_ to resume the update calculation, which will start on the filter where it left off. A truncated data version cannot be used more than once and may not be passed to `CheckForUpdates`_ or `WaitForUpdates`_ . `truncated`_ will never be true in an `UpdateSet`_ returned from `CheckForUpdates`_ or `WaitForUpdates`_ .If false, this `UpdateSet`_ contains a complete change calculation or the last part of a series of suspended change calculations. The version may be passed to `CheckForUpdates`_ , `WaitForUpdates`_ , or `WaitForUpdatesEx`_ more than once. Re-using a version allows a client to recover a change sequence after a transient failure on a previous call.