gns3-server/docs/api/v1/qemu/projectsprojectidqemuvms.rst

/v1/projects/{project_id}/qemu/vms

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

Name	Mandatory	Type	Description
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
legacy_networking		['boolean', 'null']	Use QEMU legagy networking commands (-net syntax)
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

Name	Mandatory	Type	Description
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
legacy_networking	✔	boolean	Use QEMU legagy networking commands (-net syntax)
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

../../examples/post_projectsprojectidqemuvms.txt