1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
|
.. _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.
|
