Managed Object - TaskManager

Property of: ServiceContent
See also: Task, TaskDescription, TaskFilterSpec, TaskHistoryCollector, TaskInfo

Managed Object Description

The TaskManager managed object provides an interface for creating and managing Task managed objects. Many operations are non-blocking, returning a Task managed object that can be monitored by a client application. Task managed objects may also be accessed through the TaskManager.

Properties

Name	Type	Description
description P	TaskDescription	Locale-specific, static strings that describe Task information to users.
maxCollector P	xsd:int	Maximum number of TaskHistoryCollector data objects that can exist concurrently, per client.
recentTask* P	ManagedObjectReference[] to a Task[]	A list of Task managed objects that completed recently, that are currently running, or that are queued to run. The list contains only Task objects that the client has permission to access, which is determined by having permission to access the Task object's managed entity.

Name

Type

Description

description P

TaskDescription

Locale-specific, static strings that describe Task information to users.

maxCollector P

xsd:int

Maximum number of TaskHistoryCollector data objects that can exist concurrently, per client.

recentTask* P

ManagedObjectReference[]
to a Task[]

A list of Task managed objects that completed recently, that are currently running, or that are queued to run.

The list contains only Task objects that the client has permission to access, which is determined by having permission to access the Task object's managed entity.

*May not be presentP Required privilege: System.View

Methods

Methods defined in this Managed Object
CreateCollectorForTasks, CreateTask

CreateCollectorForTasks

Creates a TaskHistoryCollector, a specialized HistoryCollector that gathers TaskInfo data objects.

A TaskHistoryCollector does not persist beyond the current client session.

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the TaskManager used to make the method call.
filter	TaskFilterSpec	The specification for the task query filter.

Return Value

Type	Description
ManagedObjectReference to a TaskHistoryCollector	The task collector based on the filter.

Faults

Type	Description
InvalidArgument	Thrown if the filter is null or unknown.
InvalidState	Thrown if there are more than the maximum number of task collectors.
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="CreateCollectorForTasks" type="vim25:CreateCollectorForTasksRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="CreateCollectorForTasksResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>

CreateTask

Creates a new Task, specifying the object with which the Task is associated, the type of task, and whether the task is cancelable. Use this operation in conjunction with the ExtensionManager.

Required Privileges: Task.Create
Since: VI API 2.5

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the TaskManager used to make the method call.
obj	ManagedObjectReference	ManagedObject with which Task will be associated
taskTypeId	xsd:string	Extension registered task type identifier for type of task being created
initiatedBy*	xsd:string	The name of the user on whose behalf the Extension is creating the task
cancelable	xsd:boolean	True if the task should be cancelable, else false
parentTaskKey*	xsd:string	Key of the task that is the parent of this task *Since* vSphere API 4.0

*Need not be set

Return Value

Type	Description
TaskInfo	TaskInfo data object describing the new task

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="CreateTask" type="vim25:CreateTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="CreateTaskResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:TaskInfo"/>
               </sequence>
            </complexType>
         </element>