Modify Guest attributes
Format
Method | POST |
---|---|
URL | /tasks/create |
Request content | GuestModify Object |
Successful answer | TaskResult Object |
Unexpected error | HTTP 500 |
GuestModify Object
Schema
type | String | Task type identifier. In this case, "guest_modify" |
---|---|---|
guest_id | String | Unique identifier of the Guest |
description | String | Guest description |
sockets | String | Number of virtual CPU sockets |
cores | String | Number of CPU cores per socket |
vram | String | Amount of RAM in GB. |
audio_drv | String | Audio driver name. One of "ac97" or "ich6". |
gpu_drv | String | Emulated graphics device. One of "virtio" or "qxl". |
fix_linux_resolution | String | Enable the resolution fitting fix on "less modern" desktop environments (e.g. MATE) |
rtc_type | String | RTC clock reference. One of "local", "UTC", or empty. |
keyboard_drv | String | Keyboard driver name. One of "ps2", "usb" or empty. |
cpu_emul | String | CPU emulation type. One of "kvm", "amd" or empty. |
pool_id | String | Unique identifier of the Pool that contains the Guest |
preferred_host | String | Preferred Host for this Guest |
disk_list | Array of DiskInfo | Array of associated Images. See Create Guest task. |
direct_disk_list | Array of DirectDiskInfo | Array of directly attached disks. See Create Guest task. |
iso_list | Array of ISOInfo | Array of associated ISO images. See Create Guest task. |
net_list | Array of NetworkInfo | Array of network interfaces. See Create Guest task. |
boot_from | String | "hd", "cdrom" or "network" |
JSON example
{ "type": "guest_modify", "rtc_type": "", "vram": "2", "audio_drv": "ich6", "gpu_drv": "virtio", "fix_linux_resolution": true, "sockets": "1", "description": "", "cores": "2", "preferred_host": "", "direct_disk_list": [], "guest_id": "corus", "disk_list": [{ "devnum": "0", "bus": "virtio", "volume_id": "home_flexvdi", "image_id": "corus", "image_storage_id": "internal" }], "iso_list": [{ "media_storage_id": "ms-empty", "filename": "ms-empty", "devnum": "0", "bus": "ide" }], "net_list": [{ "vlan_list": "", "vlan_mode": "none", "bridge": "virbr0", "driver": "virtio", "hwaddr": "02:f1:00:14:00:05", "device": "eth0" }], "pool_id": "templates" }