gns3-server/docs/api/v2/controller/node/projectsprojectidnodesnodeid.rst

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

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

Update a node instance

Response status codes

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

Input

Name	Mandatory	Type	Description
command_line		['null', 'string']	Command line use to start the node
compute_id		string	Compute identifier
console		['integer', 'null']	Console TCP port
console_host		string	Console host
console_type		enum	Possible values: serial, vnc, telnet, null
height		integer	Height of the node (Read only)
label		object
name		string	Node name
node_directory		['null', 'string']	Working directory of the node. Read only
node_id		string	Node UUID
node_type		enum	Possible values: cloud, nat, ethernet_hub, ethernet_switch, frame_relay_switch, atm_switch, docker, dynamips, vpcs, virtualbox, vmware, iou, qemu
project_id		string	Project UUID
properties		object	Properties specific to an emulator
status		enum	Possible values: stopped, started, suspended
symbol		string	Symbol of the node
width		integer	Width of the node (Read only)
x		integer	X position of the node
y		integer	Y position of the node
z		integer	Z position of the node

Output

Name	Mandatory	Type	Description
command_line		['null', 'string']	Command line use to start the node
compute_id		string	Compute identifier
console		['integer', 'null']	Console TCP port
console_host		string	Console host
console_type		enum	Possible values: serial, vnc, telnet, null
height		integer	Height of the node (Read only)
label		object
name		string	Node name
node_directory		['null', 'string']	Working directory of the node. Read only
node_id		string	Node UUID
node_type		enum	Possible values: cloud, nat, ethernet_hub, ethernet_switch, frame_relay_switch, atm_switch, docker, dynamips, vpcs, virtualbox, vmware, iou, qemu
project_id		string	Project UUID
properties		object	Properties specific to an emulator
status		enum	Possible values: stopped, started, suspended
symbol		string	Symbol of the node
width		integer	Width of the node (Read only)
x		integer	X position of the node
y		integer	Y position of the node
z		integer	Z position of the node

Sample session

../../../examples/controller_put_projectsprojectidnodesnodeid.txt

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

Delete a node 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/controller_delete_projectsprojectidnodesnodeid.txt