Enum - VirtualMachineRelocateDiskMoveOptions(vim.vm.RelocateSpec.DiskMoveOptions)

Since
vSphere API 4.0


Enum Description

Specifies how a virtual disk is moved or copied to a datastore.

In all cases after the move or copy the virtual machine's current running point will be placed on the target datastore. The current running point is defined as the disk backing which the virtual machine is currently writing to. This end state can be achieved in multiple ways, and the supported options are described in this enumeration.

These options are only relevant when the backing of the specified disk is a file backing.

Since disk backings may become shared as the result of either a CloneVM_Task or a RelocateVM_Task, PromoteDisks_Task has been provided as a way to unshare such disk backings.


See parent
See parent
See parent
See parent
See parent
See diskMoveType
See diskMoveType

Enum Constants

NameDescription
createNewChildDiskBacking Create a new child disk backing on the destination datastore. None of the virtual disk's existing files should be moved from their current locations.

Note that in the case of a CloneVM_Task, this means that the original virtual machine's disks are now all being shared. This is only safe if the clone was taken from a snapshot point, because snapshot points are always read-only. Thus for a clone this option is only valid snapshot. createNewChildDiskBacking is not a supported operation for RelocateVM_Task operations unless all disks are moving.

moveAllDiskBackingsAndAllowSharing All of the virtual disk's backings should be moved to the new datastore.

If a disk backing is not the child-most backing of this virtual machine, and there exists a read-only disk backing with the same content ID on the target datastore, then this disk backing may not be copied. Instead it is acceptable to attach to the read-only disk backing at the target datastore. A read-only disk backing is defined as a virtual disk backing which no virtual machine is currently writing to.


See contentId
See contentId
See contentId
See contentId
See contentId

moveAllDiskBackingsAndConsolidate All of the virtual disk's backings should be moved to the new datastore. During a CloneVM_Task or a MigrateVM_Task, any delta disk backings will be consolidated.

Since vSphere API 5.1
moveAllDiskBackingsAndDisallowSharing All of the virtual disk's backings should be moved to the new datastore. It is not acceptable to attach to a disk backing with the same content ID on the destination datastore. During a CloneVM_Task any delta disk backings will be consolidated.
moveChildMostDiskBacking Move only the child-most disk backing. Any parent disk backings should be left in their current locations.

This option only differs from #moveAllDiskBackingsAndAllowSharing and #moveAllDiskBackingsAndDisallowSharing when the virtual disk has a parent backing.

Note that in the case of a CloneVM_Task, this means that the parent disks will now be shared. This is safe as any parent disks are always read-only. Note that in the case of a RelocateVM_Task operation, only the virtual disks in the current virtual machine configuration are moved.


Show WSDL type definition