# Managed Object - ScheduledTaskManager(vim.scheduler.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 present P Required privilege: System.View

Methods

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

# CreateObjectScheduledTask(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.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="CreateObjectScheduledTask" type="sms:CreateObjectScheduledTaskRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="CreateObjectScheduledTaskResponse"> <complexType> <sequence> <element name="returnval" type="sms:ManagedObjectReference"/> </sequence> </complexType> </element>

# CreateScheduledTask(create)

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.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="CreateScheduledTask" type="sms:CreateScheduledTaskRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="CreateScheduledTaskResponse"> <complexType> <sequence> <element name="returnval" type="sms:ManagedObjectReference"/> </sequence> </complexType> </element>

# RetrieveEntityScheduledTask(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.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="RetrieveEntityScheduledTask" type="sms:RetrieveEntityScheduledTaskRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="RetrieveEntityScheduledTaskResponse"> <complexType> <sequence> <element name="returnval" type="sms:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

# RetrieveObjectScheduledTask(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.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="RetrieveObjectScheduledTask" type="sms:RetrieveObjectScheduledTaskRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:sms="urn:sms" name="RetrieveObjectScheduledTaskResponse"> <complexType> <sequence> <element name="returnval" type="sms:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>