Enum Description

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.

Enum Constants

Name	Description
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.

Name

Description

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

         <simpleType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VirtualMachineRelocateDiskMoveOptions">
            <restriction base="xsd:string">
               <enumeration value="moveAllDiskBackingsAndAllowSharing"/>
               <enumeration value="moveAllDiskBackingsAndDisallowSharing"/>
               <enumeration value="moveChildMostDiskBacking"/>
               <enumeration value="createNewChildDiskBacking"/>
               <enumeration value="moveAllDiskBackingsAndConsolidate"/>
            </restriction>
         </simpleType>

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

Enum Description