/v2/compute/projects/{project_id}/qemu/nodes
------------------------------------------------------------------------------------------------------------------------------------------
.. contents::
POST /v2/compute/projects/**{project_id}**/qemu/nodes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Create a new Qemu VM instance
Parameters
**********
- **project_id**: Project UUID
Response status codes
**********************
- **400**: Invalid request
- **201**: Instance created
- **409**: Conflict
Input
*******
.. raw:: html
Name | Mandatory | Type | Description |
adapter_type | | ['string', 'null'] | QEMU adapter type |
adapters | | ['integer', 'null'] | Number of adapters |
bios_image | | string | QEMU bios image path |
bios_image_md5sum | | ['string', 'null'] | QEMU bios image checksum |
boot_priority | | enum | Possible values: c, d, n, cn, cd |
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, spice, spice+agent, none |
cpu_throttling | | ['integer', 'null'] | Percentage of CPU allowed for QEMU |
cpus | | ['integer', 'null'] | Number of vCPUs |
custom_adapters | | array | |
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) |
linked_clone | | boolean | Whether the VM is a linked clone or not |
mac_address | | ['string', 'null'] | QEMU MAC address |
name | ✔ | string | QEMU VM instance name |
node_id | | | Node UUID |
on_close | | enum | Possible values: power_off, shutdown_signal, save_vm_state |
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 |
usage | | string | How to use the qemu VM |
Output
*******
.. raw:: html
Name | Mandatory | Type | Description |
adapter_type | ✔ | string | QEMU adapter type |
adapters | ✔ | integer | Number of adapters |
bios_image | ✔ | string | QEMU bios image path |
bios_image_md5sum | ✔ | ['string', 'null'] | QEMU bios image checksum |
boot_priority | ✔ | enum | Possible values: c, d, n, cn, cd |
cdrom_image | ✔ | string | QEMU cdrom image path |
cdrom_image_md5sum | ✔ | ['string', 'null'] | QEMU cdrom image checksum |
command_line | ✔ | string | Last command line used by GNS3 to start QEMU |
console | ✔ | ['integer', 'null'] | Console TCP port |
console_type | ✔ | enum | Possible values: telnet, vnc, spice, spice+agent, none |
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 |
node_directory | ✔ | string | Path to the VM working directory |
node_id | ✔ | string | Node UUID |
on_close | ✔ | enum | Possible values: power_off, shutdown_signal, save_vm_state |
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 |
save_vm_state | | ['boolean', 'null'] | Save VM state support |
status | ✔ | enum | Possible values: started, stopped, suspended |
usage | ✔ | string | How to use the QEMU VM |
Sample session
***************
.. literalinclude:: ../../../examples/compute_post_projectsprojectidqemunodes.txt