CloneVmInstance

Clones a VM instance to a specified host. For example,
CloneVmInstance vmInstanceUuid=108af59a0f4e4d6cb838a5591db1016a strategy=InstantStart \
names=new-vm1,new-vm2

Parameters

Name Description Optional Valid Value Starting Version
vmInstanceUuid The VM instance UUID. 0.6
full Whether to clone the data volume that is attached to the VM instance. Yes 2.5.0
names The VM instance name list. 0.6
strategy The clone strategy. Yes
  • InstantStart
  • JustCreate
 0.6
userTags The user tags. For more information, see CreateUserTag. The resource type is VmInstanceVO. Yes 0.6
systemTags The system tags. For more information, see CreateSystemTag. The resource type is VmInstanceVO. Yes 0.6
timeout Yes
Note:
  • When you clone a VM instance in ZStack Cloud, you can specify an affinity group by adding the affinityGroup option to SystemTags.
    • Format of the affinityGroup option: affinityGroupUuid::UUID
    • Example: affinityGroupUuid::5fd71606d5af451d981413f35367a8d6
  • When you clone a VM instance in ZStack Cloud, you can specify the volume provisioning strategy by adding the volumeProvisioningStrategy option to SystemTags. The SystemTag is passed by using the rootVolumeSystemTags parameter.
    • Format of the volumeProvisioningStrategy option: volumeProvisioningStrategy::ThinProvisioning, volumeProvisioningStrategy::ThickProvisioning
    • Example: volumeProvisioningStrategy::ThinProvisioning, volumeProvisioningStrategy::ThickProvisioning