gns3-server/docs/api/v2/compute/qemu/projectsprojectidqemunodesnodeid.rst

/v2/compute/projects/{project_id}/qemu/nodes/{node_id}

GET /v2/compute/projects/{project_id}/qemu/nodes/{node_id}

Get a Qemu VM instance

Parameters

• node_id: Node UUID
• project_id: Project UUID

Response status codes

• 200: Success
• 400: Invalid request
• 404: Instance doesn't exist

Output

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, 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	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
node_directory	✔	string
node_id	✔	string	Node UUID
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
status	✔	enum	Possible values: started, stopped, suspended
usage	✔	string	How to use the QEMU VM

Sample session

../../../examples/compute_get_projectsprojectidqemunodesnodeid.txt

PUT /v2/compute/projects/{project_id}/qemu/nodes/{node_id}

Update a Qemu VM instance

Parameters

• node_id: Node UUID
• project_id: Project UUID

Response status codes

• 200: Instance updated
• 400: Invalid request
• 404: Instance doesn't exist
• 409: Conflict

Input

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, 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
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)
linked_clone		boolean	Whether the VM is a linked clone or not
mac_address		['string', 'null']	QEMU MAC address
name		['string', 'null']	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
usage		string	How to use the QEMU VM

Output

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, 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	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
node_directory	✔	string
node_id	✔	string	Node UUID
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
status	✔	enum	Possible values: started, stopped, suspended
usage	✔	string	How to use the QEMU VM

Sample session

../../../examples/compute_put_projectsprojectidqemunodesnodeid.txt

DELETE /v2/compute/projects/{project_id}/qemu/nodes/{node_id}

Delete a Qemu VM instance

Parameters

• node_id: Node UUID
• project_id: Project UUID

Response status codes

• 400: Invalid request
• 404: Instance doesn't exist
• 204: Instance deleted

Sample session

../../../examples/compute_delete_projectsprojectidqemunodesnodeid.txt