HP BL680c XenEnterprise Management API - Page 57

2.9. CLASS: VM CHAPTER 2. API REFERENCE Clones the specified VM, making a new VM. Clone automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write). This function can only be called when the VM is in the Halted State. Signature: (VM ref) clone (session_id s, VM ref vm, string new_name) Arguments: type VM ref string name description vm The VM to be cloned new name The name of the cloned VM Return Type: VM ref The reference of the newly created VM. Possible Error Codes: VM BAD POWER STATE, SR FULL, OPERATION NOT ALLOWED RPC name: copy Overview: Copied the specified VM, making a new VM. Unlike clone, copy does not exploits the capabilities of the underlying storage repository in which the VM's disk images are stored. Instead, copy guarantees that the disk images of the newly created VM will be 'full disks' - i.e. not part of a CoW chain. This function can only be called when the VM is in the Halted State. Signature: (VM ref) copy (session_id s, VM ref vm, string new_name, SR ref sr) Arguments: type VM ref string SR ref name vm new name sr description The VM to be copied The name of the copied VM An SR to copy all the VM's disks into (if an invalid reference then it uses the existing SRs) Return Type: VM ref The reference of the newly created VM. Possible Error Codes: VM BAD POWER STATE, SR FULL, OPERATION NOT ALLOWED RPC name: provision Overview: Inspects the disk configuration contained within the VM's other config, creates VDIs and VBDs and then executes any applicable post-install script. Signature: void provision (session_id s, VM ref vm) Arguments: type name description VM ref vm The VM to be provisioned 57