HP BL680c XenEnterprise Management API - Page 58

2.9. CLASS: VM CHAPTER 2. API REFERENCE Return Type: void Possible Error Codes: VM BAD POWER STATE, SR FULL, OPERATION NOT ALLOWED RPC name: start Overview: Start the specified VM. This function can only be called with the VM is in the Halted State. Signature: void start (session_id s, VM ref vm, bool start_paused, bool force) Arguments: type VM ref bool bool name vm start paused force description The VM to start Instantiate VM in paused state if set to true. Attempt to force the VM to start. If this flag is false then the VM may fail pre-boot safety checks (e.g. if the CPU the VM last booted on looks substantially different to the current one) Return Type: void Possible Error Codes: VM BAD POWER STATE, VM HVM REQUIRED, VM IS TEMPLATE, OTHER OPERATION IN PROGRESS, OPERATION NOT ALLOWED, BOOTLOADER FAILED, UNKNOWN BOOTLOADER, NO HOSTS AVAILABLE, LICENCE RESTRICTION RPC name: start on Overview: Start the specified VM on a particular host. This function can only be called with the VM is in the Halted State. Signature: void start_on (session_id s, VM ref vm, host ref host, bool start_paused, bool force) Arguments: type VM ref host ref bool bool name vm host start paused force description The VM to start The Host on which to start the VM Instantiate VM in paused state if set to true. Attempt to force the VM to start. If this flag is false then the VM may fail pre-boot safety checks (e.g. if the CPU the VM last booted on looks substantially different to the current one) Return Type: void Possible Error Codes: VM BAD POWER STATE, VM IS TEMPLATE, OTHER OPERATION IN PROGRESS, OPERATION NOT ALLOWED, BOOTLOADER FAILED, UNKNOWN BOOTLOADER 58