.. _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.
