...
| Method | POST |
|---|---|
| URL | /tasks/create |
| Request content | GuestModify Object |
| Successful answer | TaskResult Object |
| Unexpected error | HTTP 500 |
GuestModify Object
Schema
| repeat | String | Reserved |
|---|---|---|
| retries | String | Number of times this task will be retried, in case of error |
| 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 "rtl8139ac97" 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
| Code Block | ||
|---|---|---|
| ||
{
"repeattype": "0guest_modify",
"retriesrtc_type": "0",
"typevram": "guest_modify2",
"rtcaudio_typedrv": "ich6",
"vramgpu_drv": "2virtio",
"audiofix_linux_drvresolution": "ich6"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"
} |
...