gns3-server/docs/api/v2/controller/link/projectsprojectidlinkslinkid.rst

/v2/projects/{project_id}/links/{link_id}

GET /v2/projects/{project_id}/links/{link_id}

Get a link instance

Parameters

• project_id: Project UUID
• link_id: Link UUID

Response status codes

• 200: Link found
• 400: Invalid request
• 404: Link doesn't exist

Output

Name	Mandatory	Type	Description
capture_file_name		['string', 'null']	Read only property. The name of the capture file if capture is running
capture_file_path		['string', 'null']	Read only property. The full path of the capture file if capture is running
capturing		boolean	Read only property. True if a capture running on the link
filters		object	Packet filter. This allow to simulate latency and errors
link_id		string	Link UUID
link_type		enum	Possible values: ethernet, serial
nodes		array	List of the VMS
project_id		string	Project UUID
suspend		boolean	Suspend the link

Sample session

../../../examples/controller_get_projectsprojectidlinkslinkid.txt

PUT /v2/projects/{project_id}/links/{link_id}

Update a link instance

Parameters

• project_id: Project UUID
• link_id: Link UUID

Response status codes

• 400: Invalid request
• 201: Link updated

Input

Name	Mandatory	Type	Description
capture_file_name		['string', 'null']	Read only property. The name of the capture file if capture is running
capture_file_path		['string', 'null']	Read only property. The full path of the capture file if capture is running
capturing		boolean	Read only property. True if a capture running on the link
filters		object	Packet filter. This allow to simulate latency and errors
link_id		string	Link UUID
link_type		enum	Possible values: ethernet, serial
nodes		array	List of the VMS
project_id		string	Project UUID
suspend		boolean	Suspend the link

Output

Name	Mandatory	Type	Description
capture_file_name		['string', 'null']	Read only property. The name of the capture file if capture is running
capture_file_path		['string', 'null']	Read only property. The full path of the capture file if capture is running
capturing		boolean	Read only property. True if a capture running on the link
filters		object	Packet filter. This allow to simulate latency and errors
link_id		string	Link UUID
link_type		enum	Possible values: ethernet, serial
nodes		array	List of the VMS
project_id		string	Project UUID
suspend		boolean	Suspend the link

Sample session

../../../examples/controller_put_projectsprojectidlinkslinkid.txt

DELETE /v2/projects/{project_id}/links/{link_id}

Delete a link instance

Parameters

• project_id: Project UUID
• link_id: Link UUID

Response status codes

• 400: Invalid request
• 204: Link deleted

Sample session

../../../examples/controller_delete_projectsprojectidlinkslinkid.txt