/v2/compute/projects/{project_id}/vpcs/nodes¶
Contents
POST /v2/compute/projects/{project_id}/vpcs/nodes¶
Create a new VPCS instance
Parameters¶
- project_id: Project UUID
Response status codes¶
- 201: Instance created
- 400: Invalid request
- 409: Conflict
Input¶
Name | Mandatory | Type | Description |
---|---|---|---|
console | ['integer', 'null'] | Console TCP port | |
console_type | enum | Possible values: telnet, none | |
name | ✔ | string | VPCS VM name |
node_id | Node UUID | ||
startup_script | ['string', 'null'] | Content of the VPCS startup script |
Output¶
Name | Mandatory | Type | Description |
---|---|---|---|
command_line | ✔ | string | Last command line used by GNS3 to start VPCS |
console | ✔ | ['integer', 'null'] | Console TCP port |
console_type | ✔ | enum | Possible values: telnet, none |
name | ✔ | string | VPCS VM name |
node_directory | string | Path to the VM working directory | |
node_id | ✔ | string | Node UUID |
project_id | ✔ | string | Project UUID |
status | ✔ | enum | Possible values: started, stopped, suspended |
Sample session¶
curl -i -X POST 'http://localhost:3080/v2/compute/projects/a1e920ca-338a-4e9f-b363-aa607b09dd80/vpcs/nodes' -d '{"name": "PC TEST 1"}'
POST /v2/compute/projects/a1e920ca-338a-4e9f-b363-aa607b09dd80/vpcs/nodes HTTP/1.1
{
"name": "PC TEST 1"
}
HTTP/1.1 201
Connection: close
Content-Length: 384
Content-Type: application/json
Date: Wed, 08 Jan 2020 02:27:47 GMT
Server: Python/3.6 GNS3/2.2.4dev1
X-Route: /v2/compute/projects/{project_id}/vpcs/nodes
{
"command_line": "",
"console": 5004,
"console_type": "telnet",
"name": "PC TEST 1",
"node_directory": "/tmp/tmp3gc2avyo/projects/a1e920ca-338a-4e9f-b363-aa607b09dd80/project-files/vpcs/9ba731c6-acdd-479c-9d95-c464912df54e",
"node_id": "9ba731c6-acdd-479c-9d95-c464912df54e",
"project_id": "a1e920ca-338a-4e9f-b363-aa607b09dd80",
"status": "stopped"
}