/v2/compute/projects/{project_id}/iou/nodes
------------------------------------------------------------------------------------------------------------------------------------------
.. contents::
POST /v2/compute/projects/**{project_id}**/iou/nodes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Create a new IOU instance
Parameters
**********
- **project_id**: UUID for the project
Response status codes
**********************
- **400**: Invalid request
- **201**: Instance created
- **409**: Conflict
Input
*******
.. raw:: html
Name | Mandatory | Type | Description |
console | | ['integer', 'null'] | console TCP port |
ethernet_adapters | | integer | How many ethernet adapters are connected to the IOU |
iourc_content | | ['string', 'null'] | Content of the iourc file. Ignored if Null |
l1_keepalives | | ['boolean', 'null'] | Always up ethernet interface |
md5sum | | ['string', 'null'] | Checksum of iou binary |
name | ✔ | string | IOU VM name |
node_id | | | IOU VM identifier |
nvram | | ['integer', 'null'] | Allocated NVRAM KB |
path | ✔ | string | Path of iou binary |
private_config | | ['string', 'null'] | Path to the private-config of IOU |
private_config_content | | ['string', 'null'] | Private-config of IOU |
ram | | ['integer', 'null'] | Allocated RAM MB |
serial_adapters | | integer | How many serial adapters are connected to the IOU |
startup_config | | ['string', 'null'] | Path to the startup-config of IOU |
startup_config_content | | ['string', 'null'] | Startup-config of IOU |
use_default_iou_values | | ['boolean', 'null'] | Use default IOU values |
Output
*******
.. raw:: html
Name | Mandatory | Type | Description |
command_line | ✔ | string | Last command line used by GNS3 to start QEMU |
console | ✔ | integer | console TCP port |
ethernet_adapters | ✔ | integer | How many ethernet adapters are connected to the IOU |
iourc_path | | ['string', 'null'] | Path of the iourc file used by remote servers |
l1_keepalives | ✔ | boolean | Always up ethernet interface |
md5sum | ✔ | ['string', 'null'] | Checksum of iou binary |
name | ✔ | string | IOU VM name |
node_id | ✔ | string | IOU VM UUID |
nvram | ✔ | integer | Allocated NVRAM KB |
path | ✔ | string | Path of iou binary |
private_config | ✔ | ['string', 'null'] | Path of the private-config content relative to project directory |
project_id | ✔ | string | Project UUID |
ram | ✔ | integer | Allocated RAM MB |
serial_adapters | ✔ | integer | How many serial adapters are connected to the IOU |
startup_config | ✔ | ['string', 'null'] | Path of the startup-config content relative to project directory |
use_default_iou_values | ✔ | ['boolean', 'null'] | Use default IOU values |
vm_directory | | string | |
Sample session
***************
.. literalinclude:: ../../../examples/compute_post_projectsprojectidiounodes.txt