/v2/projects/{project_id}/nodes/{node_id}¶
GET /v2/projects/{project_id}/nodes/{node_id}¶
Update a node instance
Response status codes¶
- 200: Node found
- 400: Invalid request
- 404: Node doesn’t exist
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. Warning if the host is 0.0.0.0 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, none, null | |
first_port_name | ['string', 'null'] | Name of the first port | |
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, 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 | |
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 GET 'http://localhost:3080/v2/projects/c6fa61ac-4e7d-4212-b113-adcaa9366fbf/nodes/3e1232fb-023f-41c6-af7c-975c0cb4efb4'
GET /v2/projects/c6fa61ac-4e7d-4212-b113-adcaa9366fbf/nodes/3e1232fb-023f-41c6-af7c-975c0cb4efb4 HTTP/1.1
HTTP/1.1 200
Connection: close
Content-Length: 1128
Content-Type: application/json
Date: Thu, 14 Jun 2018 08:35:15 GMT
Server: Python/3.5 GNS3/2.1.8dev1
X-Route: /v2/projects/{project_id}/nodes/{node_id}
{
"command_line": null,
"compute_id": "example.com",
"console": 2048,
"console_host": "<MagicMock name='mock.console_host' id='140064666486432'>",
"console_type": null,
"first_port_name": null,
"height": 59,
"label": {
"rotation": 0,
"style": "font-size: 10;font-familly: Verdana",
"text": "test",
"x": null,
"y": -40
},
"name": "test",
"node_directory": null,
"node_id": "3e1232fb-023f-41c6-af7c-975c0cb4efb4",
"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": "c6fa61ac-4e7d-4212-b113-adcaa9366fbf",
"properties": {
"startup_script": "echo test"
},
"status": "stopped",
"symbol": ":/symbols/computer.svg",
"width": 65,
"x": 0,
"y": 0,
"z": 0
}
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. Warning if the host is 0.0.0.0 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, none, null | |
first_port_name | ['string', 'null'] | Name of the first port | |
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, 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 | |
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. Warning if the host is 0.0.0.0 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, none, null | |
first_port_name | ['string', 'null'] | Name of the first port | |
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, 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 | |
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 PUT 'http://localhost:3080/v2/projects/13218acd-e860-4b30-a037-d22248a6e9a4/nodes/84cf3670-98ea-4899-a1e7-6b77bab3ceba' -d '{"compute_id": "example.com", "name": "test", "node_type": "vpcs", "properties": {"startup_script": "echo test"}}'
PUT /v2/projects/13218acd-e860-4b30-a037-d22248a6e9a4/nodes/84cf3670-98ea-4899-a1e7-6b77bab3ceba HTTP/1.1
{
"compute_id": "example.com",
"name": "test",
"node_type": "vpcs",
"properties": {
"startup_script": "echo test"
}
}
HTTP/1.1 200
Connection: close
Content-Length: 1085
Content-Type: application/json
Date: Thu, 14 Jun 2018 08:35:15 GMT
Server: Python/3.5 GNS3/2.1.8dev1
X-Route: /v2/projects/{project_id}/nodes/{node_id}
{
"command_line": null,
"compute_id": "example.com",
"console": 2048,
"console_host": "<MagicMock name='mock.console_host' id='140064577545496'>",
"console_type": null,
"first_port_name": null,
"height": 59,
"label": {
"rotation": 0,
"style": "font-size: 10;font-familly: Verdana",
"text": "test",
"x": null,
"y": -40
},
"name": "test",
"node_directory": null,
"node_id": "84cf3670-98ea-4899-a1e7-6b77bab3ceba",
"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": "13218acd-e860-4b30-a037-d22248a6e9a4",
"properties": {},
"status": "stopped",
"symbol": ":/symbols/computer.svg",
"width": 65,
"x": 0,
"y": 0,
"z": 0
}
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¶
curl -i -X DELETE 'http://localhost:3080/v2/projects/737be072-cd9f-4e13-a008-c0bee1499e3e/nodes/4f450ace-7a8d-4571-9bd0-85cebe831015'
DELETE /v2/projects/737be072-cd9f-4e13-a008-c0bee1499e3e/nodes/4f450ace-7a8d-4571-9bd0-85cebe831015 HTTP/1.1
HTTP/1.1 204
Connection: close
Content-Length: 0
Content-Type: application/octet-stream
Date: Thu, 14 Jun 2018 08:35:16 GMT
Server: Python/3.5 GNS3/2.1.8dev1
X-Route: /v2/projects/{project_id}/nodes/{node_id}