Managed Object - ListView

Returned by: CreateListView, CreateListViewFromView
Extends: ManagedObjectView
See also: View
Since: VI API 2.5

Managed Object Description

A view convenient for getting updates on a specific set of objects.

This is useful for clients that want to receive updates on an arbitrary set of objects.

This view has the added convenience of being able to change the observed set of objects without adding or destroying filters.

Properties

Name	Type	Description
None
Properties inherited from ManagedObjectView
view
Properties inherited from View
None

Methods

Methods defined in this Managed Object
ModifyListView, ResetListView, ResetListViewFromView
Methods inherited from ManagedObjectView
None
Methods inherited from View
DestroyView

ModifyListView

Modify the list by giving a delta of entities to add and entities to remove.

May partially succeed if some objects could not be resolved. The operation will still succeed for all objects which could be resolved, and the list of those which failed is returned as the result.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ListView used to make the method call.
add* P	ManagedObjectReference[]	Optional list of objects to add to the view.
remove* P	ManagedObjectReference[]	Optional list of objects to remove from the view.

*Need not be set P Required privilege: System.View

Return Value

Type	Description
ManagedObjectReference[]	A list containing any objects in 'add' that could not be resolved.

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ModifyListView" type="vim25:ModifyListViewRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ModifyListViewResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

ResetListView

Replaces the list with an entirely new set of objects. If the entire set is changing, this is less data to send than a delta.

May partially succeed if some objects could not be resolved. The operation will still succeed for all objects which could be resolved, and the list of those which failed is as the result.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ListView used to make the method call.
obj* P	ManagedObjectReference[]	The new list of objects.

*Need not be set P Required privilege: System.View

Return Value

Type	Description
ManagedObjectReference[]	A list containing any objects in 'obj' that could not be resolved.

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ResetListView" type="vim25:ResetListViewRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ResetListViewResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

ResetListViewFromView

Replaces the list with the set of objects in a given view.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ListView used to make the method call.
view	ManagedObjectReference to a View	The view to copy objects from.

Return Value

Type	Description
None

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ResetListViewFromView" type="vim25:ResetListViewFromViewRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ResetListViewFromViewResponse">
            <complexType/>
         </element>