Class VcVirtualMachineRelocateSpec

Extends VcDynamicData
Specification for moving or copying a virtual machine to a different datastore or host.


Name Type Description
datastore VcDatastore The datastore where the virtual machine should be located. If not specified, the current datastore is used.
deviceChange VcVirtualDeviceConfigSpec[] An optional list of virtual device specs that allow specifying the migrate options for the relocate operation. The supported device type is <a href="VcVirtualDisk.html">VcVirtualDisk</a> <p> For VirtualDisk device, <a href="VcVirtualDiskConfigSpec.html">VcVirtualDiskConfigSpec</a> has to be used to specify migrateCache option for disk with vFlash cache. <p>
disk VcVirtualMachineRelocateSpecDiskLocator[] An optional list that allows specifying the datastore location for each virtual disk.
diskMoveType String Manner in which to move the virtual disk to the <a href="VcVirtualMachineRelocateSpec.html#datastore">VcVirtualMachineRelocateSpec</a>. The set of possible values is described in <a href="VcVirtualMachineRelocateDiskMoveOptions.html">VcVirtualMachineRelocateDiskMoveOptions</a>. <p> This property applies to all the disks which the virtual machine has, but can be overridden on a per-disk basis using <a href="VcVirtualMachineRelocateSpecDiskLocator.html#diskMoveType">VcVirtualMachineRelocateSpecDiskLocator</a>. This property can only be set if <a href="VcHostCapability.html#deltaDiskBackingsSupported">VcHostCapability</a> is true. <p> If left unset then <a href="VcVirtualMachineRelocateDiskMoveOptions.html#moveAllDiskBackingsAndDisallowSharing">VcVirtualMachineRelocateDiskMoveOptions</a> is assumed.
host VcHostSystem The target host for the virtual machine. If not specified, <ul> <li> if resource pool is not specified, current host is used. <li> if resource pool is specified, and the target pool represents a stand-alone host, the host is used. <li> if resource pool is specified, and the target pool represents a DRS-enabled cluster, a host selected by DRS is used. <li> if resource pool is specified and the target pool represents a cluster without DRS enabled, an InvalidArgument exception be thrown. </ul>
pool VcResourcePool The resource pool to which this virtual machine should be attached. For a relocate or clone operation to a virtual machine, if the argument is not supplied, the current resource pool of virtual machine is used. For a clone operation to a template, this argument is ignored. For a clone operation from a template to a virtual machine, this argument is required.
profile VcVirtualMachineProfileSpec[] Storage profile requirement for Virtual Machine's home directory. Profiles are solution specific. Storage Profile Based Management(SPBM) is a vSphere server extension. The API users who want to provision VMs using Storage Profiles, need to interact with SPBM. This is an optional parameter and if user doesn't specify profile, the default behavior will apply.
transform VcVirtualMachineRelocateTransformation Transformation to perform on the disks. The backend is free to ignore this hint if it is not valid for the current operation. This can be used by clients, for example, to create sparse disks for templates.<br>See <a href="VcVirtualMachineRelocateTransformation.html">VcVirtualMachineRelocateTransformation</a><br> <br/><i>as of vSphere API 5.0. Use <a href="VcVirtualMachineRelocateSpecDiskLocator.html#diskBackingInfo">VcVirtualMachineRelocateSpecDiskLocator</a> instead for disk format conversions. This setting will be ignored for disks with the above property set.</i>


Name Returns
VcVirtualMachineRelocateSpec() constructor
equals(Object ) boolean
getAdditionalBeanInfo() java.beans.BeanInfo[]
getBeanDescriptor() java.beans.BeanDescriptor
getDatastore_ManagedObject() Object
getDefaultEventIndex() Number
getDefaultPropertyIndex() Number
getDeserializer(String , java.lang.Class , javax.xml.namespace.QName ) org.apache.axis.encoding.Deserializer
getEventSetDescriptors() java.beans.EventSetDescriptor[]
getHost_ManagedObject() Object
getIcon(Number ) java.awt.Image
getMethodDescriptors() java.beans.MethodDescriptor[]
getPool_ManagedObject() Object
getPropertyDescriptors() java.beans.PropertyDescriptor[]
getSerializer(String , java.lang.Class , javax.xml.namespace.QName ) org.apache.axis.encoding.Serializer
getTypeDesc() org.apache.axis.description.TypeDesc
hashCode() Number
setDatastore_ManagedObject(Object ) void
setHost_ManagedObject(Object ) void
setPool_ManagedObject(Object ) void

Returned by


Referenced in

Method Returns
VcVirtualMachine.relocateVM_Task(VcVirtualMachineRelocateSpec spec, VcVirtualMachineMovePriority priority) VcTask
VcVirtualMachineProvisioningChecker.checkRelocate_Task(VcVirtualMachine vm, VcVirtualMachineRelocateSpec spec, String[] testType) VcTask