/v2/compute/projects/{project_id}/cloud/nodes¶
Contents
POST /v2/compute/projects/{project_id}/cloud/nodes¶
Create a new cloud instance
Parameters¶
- project_id: Project UUID
Response status codes¶
- 201: Instance created
- 400: Invalid request
- 409: Conflict
Input¶
Types¶
HostInterfaces¶
Interfaces on this host
Name | Mandatory | Type | Description |
---|---|---|---|
name | ✔ | string | Interface name |
special | ✔ | boolean | If true the interface is non standard (firewire for example) |
type | ✔ | enum | Possible values: ethernet, tap |
Output¶
Name | Mandatory | Type | Description |
---|---|---|---|
interfaces | array | ||
name | ✔ | string | Cloud name |
node_directory | string | Path to the VM working directory | |
node_id | ✔ | string | Node UUID |
ports_mapping | ✔ | array | |
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/cloud/nodes' -d '{"name": "Cloud 1"}'
POST /v2/compute/projects/a1e920ca-338a-4e9f-b363-aa607b09dd80/cloud/nodes HTTP/1.1
{
"name": "Cloud 1"
}
HTTP/1.1 201
Connection: close
Content-Length: 1584
Content-Type: application/json
Date: Mon, 08 Jan 2018 08:15:42 GMT
Server: Python/3.6 GNS3/2.1.2dev1
X-Route: /v2/compute/projects/{project_id}/cloud/nodes
{
"interfaces": [
{
"name": "bridge0",
"special": true,
"type": "ethernet"
},
{
"name": "en0",
"special": false,
"type": "ethernet"
},
{
"name": "en1",
"special": false,
"type": "ethernet"
},
{
"name": "en2",
"special": false,
"type": "ethernet"
},
{
"name": "fw0",
"special": true,
"type": "ethernet"
},
{
"name": "lo0",
"special": true,
"type": "ethernet"
},
{
"name": "p2p0",
"special": true,
"type": "ethernet"
}
],
"name": "Cloud 1",
"node_directory": "/private/var/folders/qy/g6blgc5n7y93pzg61zyt7cmr0000gn/T/pytest-of-behlers/pytest-0/test_json4/project-files/builtin/f5c51574-0032-419f-af7e-87edd8cab649",
"node_id": "f5c51574-0032-419f-af7e-87edd8cab649",
"ports_mapping": [
{
"interface": "en0",
"name": "en0",
"port_number": 0,
"type": "ethernet"
},
{
"interface": "en1",
"name": "en1",
"port_number": 1,
"type": "ethernet"
},
{
"interface": "en2",
"name": "en2",
"port_number": 2,
"type": "ethernet"
}
],
"project_id": "a1e920ca-338a-4e9f-b363-aa607b09dd80",
"status": "started"
}