Managed Object - ScheduledTaskManager

Property of: ServiceContent
See also: ManagedEntity, ScheduledTask, ScheduledTaskDescription, ScheduledTaskSpec

Managed Object Description

Object manager for scheduled tasks.

Properties

Name	Type	Description
description P	ScheduledTaskDescription	Static descriptive strings used in scheduled tasks.
scheduledTask* P	ManagedObjectReference[] to a ScheduledTask[]	All available scheduled tasks.

*May not be presentP Required privilege: System.View

Methods

Methods defined in this Managed Object
CreateObjectScheduledTask, CreateScheduledTask, RetrieveEntityScheduledTask, RetrieveObjectScheduledTask

CreateObjectScheduledTask

Creates a scheduled task.

Required Privileges: None
Since: vSphere API 4.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ScheduledTaskManager used to make the method call.
obj P	ManagedObjectReference	The managed object for which the scheduled task triggers an action. You can schedule tasks on any managed object.
spec	ScheduledTaskSpec	The specification for the new scheduled task.

P Required privilege: ScheduledTask.Create

Return Value

Type	Description
ManagedObjectReference to a ScheduledTask	The scheduled task created by the operation.

Faults

Type	Description
DuplicateName	Thrown if a scheduled task with the name already exists.
InvalidArgument	Thrown if the specification is invalid.
InvalidName	Thrown if the scheduled task name is empty or too long.
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="CreateObjectScheduledTask" type="vim25:CreateObjectScheduledTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="CreateObjectScheduledTaskResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>

CreateScheduledTask

Creates a scheduled task.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ScheduledTaskManager used to make the method call.
entity P	ManagedObjectReference to a ManagedEntity	The managed entity (or entities) for which the scheduled task triggers an action. You can schedule tasks on any managed entity. If the scheduled task is associated with a leaf node in the inventory tree, it applies only to a single entity (virtual machine or host). If the task is associated with a folder, a datacenter, a compute resource, or a resource pool, it applies to the virtual machine or host descendants of the entity.
spec	ScheduledTaskSpec	The specification for the new scheduled task.

P Required privilege: ScheduledTask.Create

Return Value

Type	Description
ManagedObjectReference to a ScheduledTask	The scheduled task created by the operation.

Faults

Type	Description
DuplicateName	Thrown if a scheduled task with the name already exists.
InvalidArgument	Thrown if the specification is invalid.
InvalidName	Thrown if the scheduled task name is empty or too long.
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="CreateScheduledTask" type="vim25:CreateScheduledTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="CreateScheduledTaskResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>

RetrieveEntityScheduledTask

Available scheduled tasks defined on the entity.

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ScheduledTaskManager used to make the method call.
entity*	ManagedObjectReference to a ManagedEntity	The entity. If null, all scheduled tasks are returned for visible entities.

*Need not be set

Return Value

Type	Description
ManagedObjectReference[] to a ScheduledTask[]	The scheduled tasks.

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="RetrieveEntityScheduledTask" type="vim25:RetrieveEntityScheduledTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveEntityScheduledTaskResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

RetrieveObjectScheduledTask

Available scheduled tasks defined on the object.

Required Privileges: System.View
Since: vSphere API 4.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ScheduledTaskManager used to make the method call.
obj*	ManagedObjectReference	The object. If not specified, all scheduled tasks are returned for visible entities and visible ManagedObjects.

*Need not be set

Return Value

Type	Description
ManagedObjectReference[] to a ScheduledTask[]	The scheduled tasks.

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="RetrieveObjectScheduledTask" type="vim25:RetrieveObjectScheduledTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RetrieveObjectScheduledTaskResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim25:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>