org.jclouds.cloudstack.features
Interface VirtualMachineClient

public interface VirtualMachineClient

Provides synchronous access to CloudStack VirtualMachine features.

Author:

Adrian Cole

See Also:

VirtualMachineAsyncClient,

Method Summary

String	changeServiceForVirtualMachine(String id) Changes the service offering for a virtual machine.
AsyncCreateResponse	deployVirtualMachineInZone(String zoneId, String serviceOfferingId, String templateId, DeployVirtualMachineOptions... options) Creates and automatically starts a virtual machine based on a service offering, disk offering, and template.
String	destroyVirtualMachine(String id) Destroys a virtual machine.
String	getEncryptedPasswordForVirtualMachine(String id) Return an encrypted password for the virtual machine.
VirtualMachine	getVirtualMachine(String id) get a specific VirtualMachine by id
Set<VirtualMachine>	listVirtualMachines(ListVirtualMachinesOptions... options) Lists VirtualMachines
String	rebootVirtualMachine(String id) Reboots a virtual machine.
String	resetPasswordForVirtualMachine(String id) Resets the password for virtual machine.
String	startVirtualMachine(String id) Starts a virtual machine.
String	stopVirtualMachine(String id) Stops a virtual machine.
String	updateVirtualMachine(String id) Updates parameters of a virtual machine.

Method Detail

listVirtualMachines

Set<VirtualMachine> listVirtualMachines(ListVirtualMachinesOptions... options)

Lists VirtualMachines

Parameters:

options - if present, how to constrain the list.

Returns:

VirtualMachines matching query, or empty set, if no VirtualMachines are found

getVirtualMachine

VirtualMachine getVirtualMachine(String id)

get a specific VirtualMachine by id

Parameters:

id - VirtualMachine to get

Returns:

VirtualMachine or null if not found

deployVirtualMachineInZone

AsyncCreateResponse deployVirtualMachineInZone(String zoneId,
                                               String serviceOfferingId,
                                               String templateId,
                                               DeployVirtualMachineOptions... options)

Creates and automatically starts a virtual machine based on a service offering, disk offering, and template.

Parameters:

zoneId - availability zone for the virtual machine

serviceOfferingId - the ID of the service offering for the virtual machine

templateId - the ID of the template for the virtual machine

Returns:

virtual machine

rebootVirtualMachine

String rebootVirtualMachine(String id)

Reboots a virtual machine.

Parameters:

id - The ID of the virtual machine

Returns:

job id related to destroying the VM

startVirtualMachine

String startVirtualMachine(String id)

Starts a virtual machine.

Parameters:

id - The ID of the virtual machine

Returns:

job id related to destroying the VM

stopVirtualMachine

String stopVirtualMachine(String id)

Stops a virtual machine.

Parameters:

id - The ID of the virtual machine

Returns:

job id related to destroying the VM

resetPasswordForVirtualMachine

String resetPasswordForVirtualMachine(String id)

Resets the password for virtual machine. The virtual machine must be in a "Stopped" state and the template must already support this feature for this command to take effect.

Parameters:

id - The ID of the virtual machine

Returns:

job id related to destroying the VM

getEncryptedPasswordForVirtualMachine

String getEncryptedPasswordForVirtualMachine(String id)

Return an encrypted password for the virtual machine. The command is asynchronous.

Parameters:

id - the ID of the virtual machine

Returns:

encrypted password

changeServiceForVirtualMachine

String changeServiceForVirtualMachine(String id)

Changes the service offering for a virtual machine. The virtual machine must be in a "Stopped" state for this command to take effect.

Parameters:

id - The ID of the virtual machine

Returns:

job id related to destroying the VM

updateVirtualMachine

String updateVirtualMachine(String id)

Updates parameters of a virtual machine.

Parameters:

id - The ID of the virtual machine

Returns:

job id related to destroying the VM

destroyVirtualMachine

String destroyVirtualMachine(String id)

Destroys a virtual machine. Once destroyed, only the administrator can recover it.

Parameters:

id - vm to destroy

Returns:

job id related to destroying the VM, or null if resource was not found