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

Duplicate a node instance


  • project_id: Project UUID

  • node_id: Node UUID

Response status codes

  • 201: Instance duplicated

  • 400: Invalid request

  • 404: Instance doesn’t exist


Name Mandatory Type Description
x integer X position of the node
y integer Y position of the node
z integer Z position of the node


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_auto_start boolean Automatically start the console when the node has started
console_host string Console host. Warning if the host is or :: (listen on all interfaces) you need to use the same address you use to connect to the controller.
console_type enum Possible values: vnc, telnet, http, https, spice, spice+agent, none, null
custom_adapters array
first_port_name ['string', 'null'] Name of the first port
height integer Height of the node (Read only)
label object
locked boolean Whether the element locked or not
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, traceng, virtualbox, vmware, iou, qemu
port_name_format string Formating for port name {0} will be replace by port number
port_segment_size integer Size of the port segment
ports array List of node ports READ only
project_id string Project UUID
properties object Properties specific to an emulator
status enum Possible values: stopped, started, suspended
symbol ['string', 'null'] Symbol of the node
template_id ['null', 'string'] Template UUID from which the node has been created. Read only
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

curl -i -X POST 'http://localhost:3080/v2/projects/3c2c807b-0298-4fb6-9e21-163092ae2e3e/nodes/9feeb107-2f8c-4233-b195-4f2703be347d/duplicate' -d '{"x": 10, "y": 5, "z": 0}'

POST /v2/projects/3c2c807b-0298-4fb6-9e21-163092ae2e3e/nodes/9feeb107-2f8c-4233-b195-4f2703be347d/duplicate HTTP/1.1
    "x": 10,
    "y": 5,
    "z": 0

HTTP/1.1 201
Connection: close
Content-Length: 1161
Content-Type: application/json
Date: Wed, 08 Jan 2020 02:28:00 GMT
Server: Python/3.6 GNS3/2.2.4dev1
X-Route: /v2/projects/{project_id}/nodes/{node_id}/duplicate

    "command_line": null,
    "compute_id": "example.com",
    "console": null,
    "console_auto_start": false,
    "console_host": "<MagicMock name='mock.console_host' id='140147692996200'>",
    "console_type": null,
    "custom_adapters": [],
    "first_port_name": null,
    "height": 59,
    "label": {
        "rotation": 0,
        "style": null,
        "text": "test1",
        "x": null,
        "y": -40
    "locked": false,
    "name": "test1",
    "node_directory": null,
    "node_id": "eb676094-e625-4e9e-bb84-72af5bd0fb12",
    "node_type": "vpcs",
    "port_name_format": "Ethernet{0}",
    "port_segment_size": 0,
    "ports": [
            "adapter_number": 0,
            "data_link_types": {
                "Ethernet": "DLT_EN10MB"
            "link_type": "ethernet",
            "name": "Ethernet0",
            "port_number": 0,
            "short_name": "e0"
    "project_id": "3c2c807b-0298-4fb6-9e21-163092ae2e3e",
    "properties": {},
    "status": "stopped",
    "symbol": ":/symbols/computer.svg",
    "template_id": null,
    "width": 65,
    "x": 10,
    "y": 5,
    "z": 0