/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 |
console | | ['integer', 'null'] | console TCP port |
cpu_throttling | | ['integer', 'null'] | Percentage of CPU allowed for QEMU |
hda_disk_image | | ['string', 'null'] | QEMU hda disk image path |
hdb_disk_image | | ['string', 'null'] | QEMU hdb disk image path |
hdc_disk_image | | ['string', 'null'] | QEMU hdc disk image path |
hdd_disk_image | | ['string', 'null'] | QEMU hdd disk image path |
initrd | | ['string', 'null'] | QEMU initrd path |
kernel_command_line | | ['string', 'null'] | QEMU kernel command line |
kernel_image | | ['string', 'null'] | QEMU kernel image path |
kvm | | ['boolean', 'null'] | KVM support |
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 |
process_priority | | enum | Possible values: realtime, very high, high, normal, low, very low, null |
qemu_path | ✔ | string | Path to QEMU |
ram | | ['integer', 'null'] | amount of RAM in MB |
vm_id | | | QEMU VM identifier |
Output
*******
.. raw:: html
Name | Mandatory | Type | Description |
acpi_shutdown | ✔ | boolean | ACPI shutdown support |
adapter_type | ✔ | string | QEMU adapter type |
adapters | ✔ | integer | number of adapters |
console | ✔ | integer | console TCP port |
cpu_throttling | ✔ | integer | Percentage of CPU allowed for QEMU |
hda_disk_image | ✔ | string | QEMU hda disk image path |
hdb_disk_image | ✔ | string | QEMU hdb disk image path |
hdc_disk_image | ✔ | string | QEMU hdc disk image path |
hdd_disk_image | ✔ | string | QEMU hdd disk image path |
initrd | ✔ | string | QEMU initrd path |
kernel_command_line | ✔ | string | QEMU kernel command line |
kernel_image | ✔ | string | QEMU kernel image path |
kvm | ✔ | ['boolean', 'null'] | KVM support |
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 |
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_id | ✔ | string | QEMU VM uuid |
Sample session
***************
.. literalinclude:: ../../examples/post_projectsprojectidqemuvms.txt