Performing Virtual
Machine Power Operations
You can start,
stop, reboot, and suspend virtual machines by using the methods of the
Power
class.
A virtual machine can have one
of the following power states:
- PowerTypes.State.POWERED_ON- Indicates that the virtual machine is running. If a guest operating system is not currently installed, you can perform the guest OS installation in the same way as for a physical machine.
- PowerTypes.State.POWERED_OFF- Indicates that the virtual machine is not running. You can still update the software on the physical disk of the virtual machine, which is impossible for physical machines.
- PowerTypes.State.SUSPENDED- Indicates that the virtual machine is paused and can be resumed. This state is the same as when a physical machine is in standby or hibernate state.
To perform a power operation on
a virtual machine, you can use one of the methods of the
Power
class. Before you call one of the methods to change the power state of a
virtual machine, you must first check the current state of the virtual machine
by using the
Power.get
method. Pass
as argument the virtual machine identifier.
Following is a list if the
power operations:
- Power.start- Powers on a powered off or suspended virtual machine. The method takes as argument the virtual machine identifier.
- Power.stop- Powers off a powered on or suspended virtual machine. The method takes as argument the virtual machine identifier.
- Power.suspend- Pauses all virtual machine activity for a powered on virtual machine. The method takes as argument the virtual machine identifier.
- Power.reset- Shuts down and restarts the guest operating system without powering off the virtual machine. Although this method functions as astopmethod that is followed by astartmethod, the two operations are atomic with respect to other clients, meaning that other power operations cannot be performed until theresetmethod completes.