/v1/projects/{project_id}/qemu/vms ---------------------------------------------------------------------------------------------------------------------- .. contents:: POST /v1/projects/**{project_id}**/qemu/vms ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Create a new Qemu VM instance Parameters ********** - **project_id**: UUID for the project Response status codes ********************** - **400**: Invalid request - **201**: Instance created - **409**: Conflict Input ******* .. raw:: html
Name | Mandatory | Type | Description |
---|---|---|---|
acpi_shutdown | ['boolean', 'null'] | ACPI shutdown support | |
adapter_type | ['string', 'null'] | QEMU adapter type | |
adapters | ['integer', 'null'] | number of adapters | |
boot_priority | enum | Possible values: c, d | |
cdrom_image | string | QEMU cdrom image path | |
cdrom_image_md5sum | ['string', 'null'] | QEMU cdrom image checksum | |
console | ['integer', 'null'] | console TCP port | |
console_type | enum | Possible values: telnet, vnc | |
cpu_throttling | ['integer', 'null'] | Percentage of CPU allowed for QEMU | |
cpus | ['integer', 'null'] | number of vCPUs | |
hda_disk_image | string | QEMU hda disk image path | |
hda_disk_image_md5sum | ['string', 'null'] | QEMU hda disk image checksum | |
hda_disk_interface | string | QEMU hda interface | |
hdb_disk_image | string | QEMU hdb disk image path | |
hdb_disk_image_md5sum | ['string', 'null'] | QEMU hdb disk image checksum | |
hdb_disk_interface | string | QEMU hdb interface | |
hdc_disk_image | string | QEMU hdc disk image path | |
hdc_disk_image_md5sum | ['string', 'null'] | QEMU hdc disk image checksum | |
hdc_disk_interface | string | QEMU hdc interface | |
hdd_disk_image | string | QEMU hdd disk image path | |
hdd_disk_image_md5sum | ['string', 'null'] | QEMU hdd disk image checksum | |
hdd_disk_interface | string | QEMU hdd interface | |
initrd | string | QEMU initrd path | |
initrd_md5sum | ['string', 'null'] | QEMU initrd path | |
kernel_command_line | ['string', 'null'] | QEMU kernel command line | |
kernel_image | string | QEMU kernel image path | |
kernel_image_md5sum | ['string', 'null'] | QEMU kernel image checksum | |
legacy_networking | ['boolean', 'null'] | Use QEMU legagy networking commands (-net syntax) | |
mac_address | ['string', 'null'] | QEMU MAC address | |
name | ✔ | string | QEMU VM instance name |
options | ['string', 'null'] | Additional QEMU options | |
platform | enum | Possible values: aarch64, alpha, arm, cris, i386, lm32, m68k, microblaze, microblazeel, mips, mips64, mips64el, mipsel, moxie, or32, ppc, ppc64, ppcemb, s390x, sh4, sh4eb, sparc, sparc64, tricore, unicore32, x86_64, xtensa, xtensaeb, null | |
process_priority | enum | Possible values: realtime, very high, high, normal, low, very low, null | |
qemu_path | ['string', 'null'] | Path to QEMU | |
ram | ['integer', 'null'] | amount of RAM in MB | |
vm_id | QEMU VM identifier |
Name | Mandatory | Type | Description |
---|---|---|---|
acpi_shutdown | ✔ | boolean | ACPI shutdown support |
adapter_type | ✔ | string | QEMU adapter type |
adapters | ✔ | integer | number of adapters |
boot_priority | ✔ | enum | Possible values: c, d |
cdrom_image | ✔ | string | QEMU cdrom image path |
cdrom_image_md5sum | ✔ | ['string', 'null'] | QEMU cdrom image checksum |
console | ✔ | integer | console TCP port |
console_type | ✔ | enum | Possible values: telnet, vnc |
cpu_throttling | ✔ | integer | Percentage of CPU allowed for QEMU |
cpus | ✔ | ['integer', 'null'] | number of vCPUs |
hda_disk_image | ✔ | string | QEMU hda disk image path |
hda_disk_image_md5sum | ✔ | ['string', 'null'] | QEMU hda disk image checksum |
hda_disk_interface | ✔ | string | QEMU hda interface |
hdb_disk_image | ✔ | string | QEMU hdb disk image path |
hdb_disk_image_md5sum | ✔ | ['string', 'null'] | QEMU hdb disk image checksum |
hdb_disk_interface | ✔ | string | QEMU hdb interface |
hdc_disk_image | ✔ | string | QEMU hdc disk image path |
hdc_disk_image_md5sum | ✔ | ['string', 'null'] | QEMU hdc disk image checksum |
hdc_disk_interface | ✔ | string | QEMU hdc interface |
hdd_disk_image | ✔ | string | QEMU hdd disk image path |
hdd_disk_image_md5sum | ✔ | ['string', 'null'] | QEMU hdd disk image checksum |
hdd_disk_interface | ✔ | string | QEMU hdd interface |
initrd | ✔ | string | QEMU initrd path |
initrd_md5sum | ✔ | ['string', 'null'] | QEMU initrd path |
kernel_command_line | ✔ | string | QEMU kernel command line |
kernel_image | ✔ | string | QEMU kernel image path |
kernel_image_md5sum | ✔ | ['string', 'null'] | QEMU kernel image checksum |
legacy_networking | ✔ | boolean | Use QEMU legagy networking commands (-net syntax) |
mac_address | ✔ | string | QEMU MAC address |
name | ✔ | string | QEMU VM instance name |
options | ✔ | string | Additional QEMU options |
platform | ✔ | enum | Possible values: aarch64, alpha, arm, cris, i386, lm32, m68k, microblaze, microblazeel, mips, mips64, mips64el, mipsel, moxie, or32, ppc, ppc64, ppcemb, s390x, sh4, sh4eb, sparc, sparc64, tricore, unicore32, x86_64, xtensa, xtensaeb |
process_priority | ✔ | enum | Possible values: realtime, very high, high, normal, low, very low |
project_id | ✔ | string | Project uuid |
qemu_path | ✔ | string | path to QEMU |
ram | ✔ | integer | amount of RAM in MB |
vm_directory | ✔ | string | |
vm_id | ✔ | string | QEMU VM uuid |