Managed Object - Task(vim.Task)

Property of
ClusterAttemptedVmInfo, ManagedEntity, ScheduledTaskInfo, StoragePlacementResult, TaskInfo, TaskInProgress, TaskManager, VsanUpgradeSystemUpgradeHistoryItem
Returned by
AbortCustomization_Task, AddDisks_Task, AddDVPortgroup_Task, AddHost_Task, AddStandaloneHost_Task, ApplyEntitiesConfig_Task, ApplyEvcModeVM_Task, ApplyHostConfig_Task, ApplyStorageDrsRecommendation_Task, ApplyStorageDrsRecommendationToPod_Task, AttachDisk_Task, AttachScsiLunEx_Task, BatchAddHostsToCluster_Task, BatchAddStandaloneHosts_Task, CertMgrRefreshCACertificatesAndCRLs_Task, CertMgrRefreshCertificates_Task, CertMgrRevokeCertificates_Task, ChangeKey_Task, CheckAddHostEvc_Task, CheckAnswerFileStatus_Task, CheckClone_Task, CheckCompatibility_Task, CheckCompliance_Task, CheckConfigureEvcMode_Task, CheckHostPatch_Task, CheckInstantClone_Task, CheckMigrate_Task, CheckPowerOn_Task, CheckProfileCompliance_Task, CheckRelocate_Task, CheckVmConfig_Task, CloneVApp_Task, CloneVM_Task, CloneVStorageObject_Task, CompositeHostProfile_Task, ConfigureDatastoreIORM_Task, ConfigureEvcMode_Task, ConfigureHCI_Task, ConfigureHostCache_Task, ConfigureStorageDrsForPod_Task, configureVcha_Task, ConfigureVFlashResourceEx_Task, ConnectNvmeControllerEx_Task, ConsolidateVMDisks_Task, CopyDatastoreFile_Task, CopyVirtualDisk_Task, CreateChildVM_Task, CreateDisk_Task, CreateDiskFromSnapshot_Task, CreateDVPortgroup_Task, CreateDVS_Task, CreateNvdimmNamespace_Task, CreateNvdimmPMemNamespace_Task, createPassiveNode_Task, CreateScreenshot_Task, CreateSecondaryVM_Task, CreateSecondaryVMEx_Task, CreateSnapshot_Task, CreateSnapshotEx_Task, CreateVirtualDisk_Task, CreateVM_Task, createWitnessNode_Task, CryptoUnlock_Task, CustomizeGuest_Task, CustomizeVM_Task, DatastoreExitMaintenanceMode_Task, DefragmentVirtualDisk_Task, DeleteDatastoreFile_Task, DeleteNvdimmBlockNamespaces_Task, DeleteNvdimmNamespace_Task, DeleteSnapshot_Task, DeleteVirtualDisk_Task, DeleteVStorageObject_Task, DeleteVStorageObjectEx_Task, deployVcha_Task, Destroy_Task, destroyVcha_Task, DetachDisk_Task, DetachScsiLunEx_Task, DisableEvcMode_Task, DisableSecondaryVM_Task, DisconnectHost_Task, DisconnectNvmeControllerEx_Task, DVPortgroupRollback_Task, DVSManagerExportEntity_Task, DVSManagerImportEntity_Task, DvsReconfigureVmVnicNetworkResourcePool_Task, DVSRollback_Task, EagerZeroVirtualDisk_Task, EnableSecondaryVM_Task, EnterMaintenanceMode_Task, EstimateStorageForConsolidateSnapshots_Task, EvacuateVsanNode_Task, ExitMaintenanceMode_Task, ExportAnswerFile_Task, ExtendDisk_Task, ExtendHCI_Task, ExtendVirtualDisk_Task, GenerateHostConfigTaskSpec_Task, GenerateHostProfileTaskList_Task, GenerateLogBundles_Task, HostCloneVStorageObject_Task, HostCreateDisk_Task, HostDeleteVStorageObject_Task, HostDeleteVStorageObjectEx_Task, HostExtendDisk_Task, HostInflateDisk_Task, HostReconcileDatastoreInventory_Task, HostRelocateVStorageObject_Task, HostUpdateVStorageObjectMetadata_Task, HostUpdateVStorageObjectMetadataEx_Task, HostVStorageObjectCreateDiskFromSnapshot_Task, HostVStorageObjectCreateSnapshot_Task, HostVStorageObjectDeleteSnapshot_Task, HostVStorageObjectRevert_Task, HttpNfcLeasePullFromUrls_Task, ImportCertificateForCAM_Task, InflateDisk_Task, InflateVirtualDisk_Task, InitializeDisks_Task, initiateFailover_Task, InstallHostPatch_Task, InstallHostPatchV2_Task, InstallIoFilter_Task, InstantClone_Task, JoinDomain_Task, JoinDomainWithCAM_Task, LeaveCurrentDomain_Task, MakePrimaryVM_Task, MarkAsLocal_Task, MarkAsNonLocal_Task, MarkAsNonSsd_Task, MarkAsSsd_Task, MarkPerenniallyReservedEx_Task, MergeDvs_Task, MigrateVM_Task, MountVmfsVolumeEx_Task, MoveDatastoreFile_Task, MoveDVPort_Task, MoveHostInto_Task, MoveInto_Task, MoveIntoFolder_Task, MoveVirtualDisk_Task, PerformDvsProductSpecOperation_Task, PerformVsanUpgrade_Task, PowerDownHostToStandBy_Task, PowerOffVApp_Task, PowerOffVM_Task, PowerOnMultiVM_Task, PowerOnVApp_Task, PowerOnVM_Task, PowerUpHostFromStandBy_Task, prepareVcha_Task, PromoteDisks_Task, QueryHostPatch_Task, QueryVMotionCompatibilityEx_Task, RebootHost_Task, RecommissionVsanNode_Task, ReconcileDatastoreInventory_Task, ReconfigureCluster_Task, ReconfigureComputeResource_Task, ReconfigureDatacenter_Task, ReconfigureDVPort_Task, ReconfigureDVPortgroup_Task, ReconfigureDvs_Task, ReconfigureHostForDAS_Task, ReconfigVM_Task, ReconnectHost_Task, RectifyDvsHost_Task, RectifyDvsOnHost_Task, RefreshStorageDrsRecommendationsForPod_Task, RegisterChildVM_Task, RegisterVM_Task, reloadVirtualMachineFromPath_Task, RelocateVM_Task, RelocateVStorageObject_Task, RemoveAllSnapshots_Task, RemoveDatastoreEx_Task, RemoveDisk_Task, RemoveDiskMapping_Task, RemoveSnapshot_Task, Rename_Task, ResetVM_Task, ResignatureUnresolvedVmfsVolume_Task, ResolveInstallationErrorsOnCluster_Task, ResolveInstallationErrorsOnHost_Task, ResolveMultipleUnresolvedVmfsVolumesEx_Task, RetrieveKmipServersStatus_Task, RevertToCurrentSnapshot_Task, RevertToSnapshot_Task, RevertVStorageObject_Task, RevertVStorageObjectEx_Task, ScanHostPatch_Task, ScanHostPatchV2_Task, SearchDatastore_Task, SearchDatastoreSubFolders_Task, setClusterMode_Task, ShrinkVirtualDisk_Task, ShutdownHost_Task, StageHostPatch_Task, StampAllRulesWithUuid_Task, StartGuestNetwork_Task, StartRecording_Task, StartReplaying_Task, StopRecording_Task, StopReplaying_Task, SuspendVApp_Task, SuspendVM_Task, TerminateFaultTolerantVM_Task, TurnDiskLocatorLedOff_Task, TurnDiskLocatorLedOn_Task, TurnOffFaultToleranceForVM_Task, UninstallHostPatch_Task, UninstallIoFilter_Task, UnmapVmfsVolumeEx_Task, UnmountDiskMapping_Task, UnmountVmfsVolumeEx_Task, UnregisterAndDestroy_Task, unregisterVApp_Task, UpdateAnswerFile_Task, UpdateDVSHealthCheckConfig_Task, UpdateDVSLacpGroupConfig_Task, UpdateProductLockerLocation_Task, UpdateVirtualMachineFiles_Task, UpdateVsan_Task, UpdateVStorageInfrastructureObjectPolicy_Task, UpdateVStorageObjectCrypto_Task, UpdateVStorageObjectPolicy_Task, UpdateVVolVirtualMachineFiles_Task, UpgradeIoFilter_Task, UpgradeTools_Task, UpgradeVM_Task, ValidateHostProfileComposition_Task, VCenterUpdateVStorageObjectMetadataEx_Task, VStorageObjectCreateSnapshot_Task, VStorageObjectCreateSnapshotEx_Task, VStorageObjectDeleteSnapshotEx_Task, VStorageObjectExtendDiskEx_Task, ZeroFillVirtualDisk_Task
Extends
ExtensibleManagedObject
See also
LocalizableMessage, MethodFault, TaskInfo, TaskInfoState
Since
2.0


Managed Object Description

A task is used to monitor and potentially cancel long running operations.

Properties

Name Type Description
infoTaskInfo

Detailed information about this task.
Properties inherited from ExtensibleManagedObject
availableField, value

Methods

Methods defined in this Managed Object
CancelTask, SetTaskDescription, SetTaskState, UpdateProgress
Methods inherited from ExtensibleManagedObject
setCustomValue

CancelTask(cancel)

Cancels a running or queued task. A task may only be canceled if it is cancelable. Multiple cancel requests will be treated as a single cancelation request. Canceling a completed or already canceled task will throw an InvalidState exception.

If a task is canceled, its runtime state will be set to error and its error state will be set to RequestCanceled.

A cancel operation is asynchronous. The operation may return before the task is canceled.

Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the Task used to make the method call.

Return Value

Type Description
None

Faults

Type Description
InvalidStateThrown if the task is already canceled or completed.
RuntimeFaultThrown 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



SetTaskDescription(UpdateDescription)

Updates task description to describe the current phase of the task.

Required Privileges
Task.Update
Since
vSphere API 4.0

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the Task used to make the method call.
description PLocalizableMessage

New description for task

Since vSphere API 4.0
P Required privilege: description

Return Value

Type Description
None

Faults

Type Description
RuntimeFaultThrown 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



SetTaskState(setState)

Sets task state and optionally sets results or fault, as appropriate for state

Required Privileges
Task.Update
Since
VI API 2.5

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the Task used to make the method call.
state PTaskInfoState

New state for task

Since VI API 2.5
result* Pxsd:anyType

Result to set, valid only if task state is TaskInfo.State.success

Since VI API 2.5
fault* PMethodFault

Fault to set, valid only if task state is error. The fault must be a of a fault type that directly or indirectly extends VimFault.

Since VI API 2.5
*Need not be set PRequired privilege - see tooltip for details

Return Value

Type Description
None

Faults

Type Description
InvalidStateThrown if attempting to change states after task is completed or in error, or attempting to set the result or fault incorrectly
RuntimeFaultThrown 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



UpdateProgress

Sets percentage done for this task and recalculates overall percentage done. If a percentDone value of less than zero or greater than 100 is specified, a value of zero or 100 respectively is used.

Required Privileges
Task.Update
Since
VI API 2.5

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the Task used to make the method call.
percentDone Pxsd:int

Percentage to set for this task

Since VI API 2.5
P Required privilege: percentDone

Return Value

Type Description
None

Faults

Type Description
InvalidStateThrown if task is not running
OutOfBoundsVirtualCenter 2.x servers throw this fault if percentDone is less than 0 or greater than 100. Newer versions behave as described above, and never throw this fault.
RuntimeFaultThrown 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