| Local Properties | Local Methods | |
Managed Object Types | Data Object Types | All Properties | All Methods |
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. The completed Task objects by default include only Task objects that completed within the past 10 minutes. When connected to vCenter Server, there is an additional default limitation that each of the completed Task objects in this list is one of the last 200 completed Task objects.
This property should not be used for tracking Task
completion. Generally, a ListView is a better way to
monitor a specific set of Task objects.
In releases after vSphere API 5.0, vSphere Servers might not
generate property collector update notifications for this property.
To obtain the latest value of the property, you can use
PropertyCollector methods RetrievePropertiesEx or WaitForUpdatesEx.
If you use the PropertyCollector.WaitForUpdatesEx method, specify
an empty string for the version parameter. Any other version value will not
produce any property values as no updates are generated.
|
Methods
Methods defined in this Managed Object |
---|
CreateCollectorForTasks, CreateTask |
A TaskHistoryCollector does not persist beyond the current client session.
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. |
Events
Type | |
---|---|
None |
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,
false otherwise
|
parentTaskKey* | xsd:string |
Key of the task that is the parent of this task
Since vSphere API 4.0 |
activationId* | xsd:string |
Activation Id is a client-provided token to link an
API call with a task. When provided, the activationId is added to the
TaskInfo
Since vSphere API 6.0 |
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. |
Events
Type | |
---|---|
None |
Top of page | Local Properties | Local Methods | |
Managed Object Types | Data Object Types | All Properties | All Methods |