Property Collector Wait For Updates Ex

Property Collector Wait For Updates Ex

Calculate the set of updates for each existing filter in the session.

WaitForUpdatesEx may return only partial update calculations. See truncated for a more detailed explanation. WaitForUpdatesEx may also return null after a timeout, either as requested by maxWaitSeconds or due to PropertyCollector policy.

If an application uses waitForUpdatesEx it is strongly recommended that it not make concurrent calls to WaitForUpdates, CheckForUpdates, or WaitForUpdatesEx in the same session. Concurrent calls may cause suspended change calculations to be discarded.

Required privileges: System.View

Request
URI
POST
https://{vcenter-host}/sdk/vim25/{release}/PropertyCollector/{moId}/WaitForUpdatesEx
COPY
Path Parameters
string
moId
Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case PropertyCollector/{moId}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.


Request Body
WaitForUpdatesExRequestType of type(s) application/json
Required
{
    "version": "string",
    "options": {
        "_typeName": "string",
        "maxWaitSeconds": 0,
        "maxObjectUpdates": 0
    }
}
string
version
Optional

The data version currently known to the client. The value must be either

  • the special initial data version (an empty string),
  • a data version returned from PropertyCollector.CheckForUpdates or PropertyCollector.WaitForUpdates
  • a non-truncated data version returned from PropertyCollector.WaitForUpdatesEx
  • a truncated data version returned from the last call to PropertyCollector.WaitForUpdatesEx with no intervening calls to PropertyCollector.WaitForUpdates or PropertyCollector.CheckForUpdates.
options
Optional

Options for WaitForUpdatesEx.

Authentication
This operation uses the following authentication methods.
Responses
200

Changes since the passed in version or null if there are no changes.

Returns UpdateSet of type(s) application/json
This response body class contains all of the following: DataObject
{
    "_typeName": "string",
    "version": "string",
    "filterSet": [
        {
            "_typeName": "string",
            "filter": {
                "_typeName": "string",
                "type": "string",
                "value": "string"
            },
            "objectSet": [
                {
                    "_typeName": "string",
                    "kind": "string",
                    "obj": {
                        "_typeName": "string",
                        "type": "string",
                        "value": "string"
                    },
                    "changeSet": [
                        {
                            "_typeName": "string",
                            "name": "string",
                            "op": "string",
                            "val": {
                                "_typeName": "string"
                            }
                        }
                    ],
                    "missingSet": [
                        {
                            "_typeName": "string",
                            "path": "string",
                            "fault": {
                                "_typeName": "string",
                                "faultCause": "MethodFault Object",
                                "faultMessage": [
                                    {
                                        "_typeName": "string",
                                        "key": "string",
                                        "arg": [
                                            {
                                                "_typeName": "string",
                                                "key": "string",
                                                "value": {
                                                    "_typeName": "string"
                                                }
                                            }
                                        ],
                                        "message": "string"
                                    }
                                ]
                            }
                        }
                    ]
                }
            ],
            "missingSet": [
                {
                    "_typeName": "string",
                    "obj": {
                        "_typeName": "string",
                        "type": "string",
                        "value": "string"
                    },
                    "fault": {
                        "_typeName": "string",
                        "faultCause": "MethodFault Object",
                        "faultMessage": [
                            {
                                "_typeName": "string",
                                "key": "string",
                                "arg": [
                                    {
                                        "_typeName": "string",
                                        "key": "string",
                                        "value": {
                                            "_typeName": "string"
                                        }
                                    }
                                ],
                                "message": "string"
                            }
                        ]
                    }
                }
            ]
        }
    ],
    "truncated": false
}
string
version
Required

New data version to pass in the next call to PropertyCollector.CheckForUpdates, PropertyCollector.WaitForUpdates, or PropertyCollector.WaitForUpdatesEx.

These versions, although they are opaque, are strongly ordered in the sense that passing a version to PropertyCollector.WaitForUpdates, PropertyCollector.CheckForUpdates or PropertyCollector.WaitForUpdatesEx requests updates that reflect changes in the objects selected by the Filter that happened after the specified version.

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

boolean
truncated
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 WaitOptions.maxObjectUpdates. The client can pass the "truncated data version" to PropertyCollector.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 PropertyCollector.CheckForUpdates or PropertyCollector.WaitForUpdates. UpdateSet.truncated will never be true in an UpdateSet returned from PropertyCollector.CheckForUpdates or PropertyCollector.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 PropertyCollector.CheckForUpdates, PropertyCollector.WaitForUpdates, or PropertyCollector.WaitForUpdatesEx more than once. Re-using a version allows a client to recover a change sequence after a transient failure on a previous call.


500

InvalidCollectorVersion: if the data version does not meet the requirements above.

RequestCanceled: if CancelWaitForUpdates has been called or the session was closed or the PropertyCollector was destroyed at some point after the call was received

Returns InvalidCollectorVersion of type(s) application/json
This response body class contains all of the following: MethodFault
{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}