Endpoints

GNS3 expose two type of endpoints:

• Controller
• Compute

Controller API Endpoints

The controller manage all the running topologies. The controller has knowledge of everything on in GNS3. If you want to create and manage a topology it’s here. The controller will call the compute API when needed.

In a standard GNS3 installation you have one controller and one or many computes.

• Compute
  • /v2/computes
  • /v2/computes/{compute_id}
  • /v2/computes/{compute_id}/{emulator}/{action:.+}
  • /v2/computes/{compute_id}/{emulator}/images
• Drawing
  • /v2/projects/{project_id}/drawings
  • /v2/projects/{project_id}/drawings/{drawing_id}
• Gns3 vm
  • /v2/gns3vm
  • /v2/gns3vm/engines
  • /v2/gns3vm/engines/{engine}/vms
• Link
  • /v2/projects/{project_id}/links
  • /v2/projects/{project_id}/links/{link_id}
  • /v2/projects/{project_id}/links/{link_id}/pcap
  • /v2/projects/{project_id}/links/{link_id}/start_capture
  • /v2/projects/{project_id}/links/{link_id}/stop_capture
• Node
  • /v2/projects/{project_id}/nodes
  • /v2/projects/{project_id}/nodes/{node_id}
  • /v2/projects/{project_id}/nodes/{node_id}/dynamips/auto_idlepc
  • /v2/projects/{project_id}/nodes/{node_id}/dynamips/idlepc_proposals
  • /v2/projects/{project_id}/nodes/{node_id}/files/{path:.+}
  • /v2/projects/{project_id}/nodes/{node_id}/reload
  • /v2/projects/{project_id}/nodes/{node_id}/start
  • /v2/projects/{project_id}/nodes/{node_id}/stop
  • /v2/projects/{project_id}/nodes/{node_id}/suspend
  • /v2/projects/{project_id}/nodes/reload
  • /v2/projects/{project_id}/nodes/start
  • /v2/projects/{project_id}/nodes/stop
  • /v2/projects/{project_id}/nodes/suspend
• Project
  • /v2/projects
  • /v2/projects/load
  • /v2/projects/{project_id}
  • /v2/projects/{project_id}/close
  • /v2/projects/{project_id}/duplicate
  • /v2/projects/{project_id}/export
  • /v2/projects/{project_id}/files/{path:.+}
  • /v2/projects/{project_id}/import
  • /v2/projects/{project_id}/notifications
  • /v2/projects/{project_id}/notifications/ws
  • /v2/projects/{project_id}/open
• Server
  • /v2/debug
  • /v2/settings
  • /v2/shutdown
  • /v2/version
• Snapshot
  • /v2/projects/{project_id}/snapshots
  • /v2/projects/{project_id}/snapshots/{snapshot_id}
  • /v2/projects/{project_id}/snapshots/{snapshot_id}/restore
• Symbol
  • /v2/symbols
  • /v2/symbols/{symbol_id:.+}/raw

Compute API Endpoints

The compute is the GNS3 process running on a server and controlling the VM process.

Warning

Consider this endpoints as a private API used by the controller.

• Atm switch
  • /v2/compute/projects/{project_id}/atm_relay_switch/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/atm_switch/nodes
  • /v2/compute/projects/{project_id}/atm_switch/nodes/{node_id}
  • /v2/compute/projects/{project_id}/atm_switch/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/atm_switch/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/atm_switch/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/atm_switch/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/atm_switch/nodes/{node_id}/suspend
• Capabilities
  • /v2/compute/capabilities
• Cloud
  • /v2/compute/projects/{project_id}/cloud/nodes
  • /v2/compute/projects/{project_id}/cloud/nodes/{node_id}
  • /v2/compute/projects/{project_id}/cloud/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/cloud/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/cloud/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/cloud/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/cloud/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/cloud/nodes/{node_id}/suspend
• Docker
  • /v2/compute/docker/images
  • /v2/compute/projects/{project_id}/docker/nodes
  • /v2/compute/projects/{project_id}/docker/nodes/{node_id}
  • /v2/compute/projects/{project_id}/docker/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/docker/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/docker/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/docker/nodes/{node_id}/pause
  • /v2/compute/projects/{project_id}/docker/nodes/{node_id}/reload
  • /v2/compute/projects/{project_id}/docker/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/docker/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/docker/nodes/{node_id}/unpause
• Dynamips vm
  • /v2/compute/dynamips/images
  • /v2/compute/dynamips/images/{filename:.+}
  • /v2/compute/projects/{project_id}/dynamips/nodes
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/auto_idlepc
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/idlepc_proposals
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/reload
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/resume
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/dynamips/nodes/{node_id}/suspend
• Ethernet hub
  • /v2/compute/projects/{project_id}/ethernet_hub/nodes
  • /v2/compute/projects/{project_id}/ethernet_hub/nodes/{node_id}
  • /v2/compute/projects/{project_id}/ethernet_hub/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/ethernet_hub/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/ethernet_hub/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/ethernet_hub/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/ethernet_hub/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/ethernet_hub/nodes/{node_id}/suspend
• Ethernet switch
  • /v2/compute/projects/{project_id}/ethernet_switch/nodes
  • /v2/compute/projects/{project_id}/ethernet_switch/nodes/{node_id}
  • /v2/compute/projects/{project_id}/ethernet_switch/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/ethernet_switch/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/ethernet_switch/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/ethernet_switch/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/ethernet_switch/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/ethernet_switch/nodes/{node_id}/suspend
• Frame relay switch
  • /v2/compute/projects/{project_id}/frame_relay_switch/nodes
  • /v2/compute/projects/{project_id}/frame_relay_switch/nodes/{node_id}
  • /v2/compute/projects/{project_id}/frame_relay_switch/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/frame_relay_switch/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/frame_relay_switch/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/frame_relay_switch/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/frame_relay_switch/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/frame_relay_switch/nodes/{node_id}/suspend
• Iou
  • /v2/compute/iou/images
  • /v2/compute/iou/images/{filename:.+}
  • /v2/compute/projects/{project_id}/iou/nodes
  • /v2/compute/projects/{project_id}/iou/nodes/{node_id}
  • /v2/compute/projects/{project_id}/iou/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/iou/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/iou/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/iou/nodes/{node_id}/reload
  • /v2/compute/projects/{project_id}/iou/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/iou/nodes/{node_id}/stop
• Nat
  • /v2/compute/projects/{project_id}/nat/nodes
  • /v2/compute/projects/{project_id}/nat/nodes/{node_id}
  • /v2/compute/projects/{project_id}/nat/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/nat/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/nat/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/nat/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/nat/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/nat/nodes/{node_id}/suspend
• Network
  • /v2/compute/network/interfaces
  • /v2/compute/projects/{project_id}/ports/udp
• Notification
  • /v2/compute/notifications/ws
• Project
  • /v2/compute/projects
  • /v2/compute/projects/{project_id}
  • /v2/compute/projects/{project_id}/close
  • /v2/compute/projects/{project_id}/export
  • /v2/compute/projects/{project_id}/files
  • /v2/compute/projects/{project_id}/files/{path:.+}
  • /v2/compute/projects/{project_id}/import
  • /v2/compute/projects/{project_id}/notifications
  • /v2/compute/projects/{project_id}/stream/{path:.+}
• Qemu
  • /v2/compute/projects/{project_id}/qemu/nodes
  • /v2/compute/projects/{project_id}/qemu/nodes/{node_id}
  • /v2/compute/projects/{project_id}/qemu/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/qemu/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/qemu/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/qemu/nodes/{node_id}/reload
  • /v2/compute/projects/{project_id}/qemu/nodes/{node_id}/resume
  • /v2/compute/projects/{project_id}/qemu/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/qemu/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/qemu/nodes/{node_id}/suspend
  • /v2/compute/qemu/binaries
  • /v2/compute/qemu/capabilities
  • /v2/compute/qemu/images
  • /v2/compute/qemu/images/{filename:.+}
  • /v2/compute/qemu/img
  • /v2/compute/qemu/img-binaries
• Server
  • /v2/compute/debug
  • /v2/compute/version
• Virtualbox
  • /v2/compute/projects/{project_id}/virtualbox/nodes
  • /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}
  • /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}/reload
  • /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}/resume
  • /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/virtualbox/nodes/{node_id}/suspend
  • /v2/compute/virtualbox/vms
• Vmware
  • /v2/compute/projects/{project_id}/vmware/nodes
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}/interfaces/vmnet
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}/reload
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}/resume
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/vmware/nodes/{node_id}/suspend
  • /v2/compute/vmware/vms
• Vpcs
  • /v2/compute/projects/{project_id}/vpcs/nodes
  • /v2/compute/projects/{project_id}/vpcs/nodes/{node_id}
  • /v2/compute/projects/{project_id}/vpcs/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/nio
  • /v2/compute/projects/{project_id}/vpcs/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/start_capture
  • /v2/compute/projects/{project_id}/vpcs/nodes/{node_id}/adapters/{adapter_number:d+}/ports/{port_number:d+}/stop_capture
  • /v2/compute/projects/{project_id}/vpcs/nodes/{node_id}/reload
  • /v2/compute/projects/{project_id}/vpcs/nodes/{node_id}/start
  • /v2/compute/projects/{project_id}/vpcs/nodes/{node_id}/stop
  • /v2/compute/projects/{project_id}/vpcs/nodes/{node_id}/suspend