Data Object Description

CheckForUpdates

WaitForUpdates

WaitForUpdatesEx

Properties

Name	Type	Description
filterSet*	PropertyFilterUpdate[]	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*	xsd:boolean	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. *Since* vSphere API 4.1
version	xsd:string	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.
Properties inherited from DynamicData
dynamicProperty, dynamicType

Name

Type

Description

filterSet*

PropertyFilterUpdate[]

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*

xsd:boolean

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.

Since vSphere API 4.1

version

xsd:string

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.

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="UpdateSet">
            <complexContent>
               <extension base="vim25:DynamicData">
                  <sequence>
                     <element name="version" type="xsd:string"/>
                     <element name="filterSet" type="vim25:PropertyFilterUpdate" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="truncated" type="xsd:boolean" minOccurs="0"/>
                  </sequence>
               </extension>
            </complexContent>
         </complexType>

Data Object - UpdateSet

Data Object Description