Name, Description, Boot Options, RAM size

The virtual machine name, description, and RAM size modifications are simple. They are performed by invoking a corresponding method of a Vm object. To modify the boot options (boot device priority), obtain an instance of the prlsdkapi.BootDevice class representing each device. This step is performed using the VmConfig.get_boot_dev_count method to determine the total number of boot devices, then iterating through the list and obtaining a BootDevice object using the VmConfig.get_boot_dev method. To place a device at the specified position in the boot device priority list, use the BootDevice.set_sequence_index method passing a value of 0 to the first device, 1 to the second device, and so forth. If you have more than one instance of a particular device type in the boot list (i.e. more than one CD/DVD drive), you will have to set a sequence index for each instance individually. An instance is identified by an index that can be obtained using the VmBootDev.get_index method. A device in the boot priority list can be enabled or disabled using the BootDevice.set_in_use method. Disabling the device does not remove it from the boot device list. To remove a device from the list, use the BootDevice.remove method.

Example

"""

Modify the vrtual machine name, RAM size, and boot options.

"""

def vm_edit(vm):

# Begin the virtual machine editing operation.

try:

vm.begin_edit().wait()

except prlsdkapi.PrlSDKError, e:

print "Error: %s" % e

return

# Obtain the VmConfig object containing the virtual machine

# configuration information.

vm_config = vm.get_config()

vm.set_name(vm.get_name() + "_modified")

vm.set_ram_size(256)

vm.set_description("SDK Test Machine")

# Modify boot device priority using the following order:.

# CD > HDD > Network > FDD.

# Remove all other devices from the boot priority list (if any).

count = vm_config.get_boot_dev_count()

for i in range(count):

# Obtain an instance of the prlsdkapi.BootDevice class

# containing the boot device information.

boot_dev = vm_config.get_boot_dev(i)

# Enable the device.

boot_dev.set_in_use(True)

# Set the device sequence index.

dev_type = boot_dev.get_type()

if dev_type == consts.PDE_OPTICAL_DISK:

boot_dev.set_sequence_index(0)

elif dev_type == consts.PDE_HARD_DISK:

boot_dev.set_sequence_index(1)

elif dev_type == consts.PDE_GENERIC_NETWORK_ADAPTER:

boot_dev.set_sequence_index(2)

elif dev_type == consts.PDE_FLOPPY_DISK:

boot_dev.set_sequence_index(3)

else:

boot_dev.remove()

# Commit the changes.

try:

vm.commit().wait()

except prlsdkapi.PrlSDKError, e:

print "Error: %s" % e

return