/v1/projects/{project_id}/iou/vms
----------------------------------------------------------------------------------------------------------------------
.. contents::
POST /v1/projects/**{project_id}**/iou/vms
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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 |
initial_config | | ['string', 'null'] | Path to the initial configuration of IOU |
initial_config_content | | ['string', 'null'] | Initial configuration of IOU |
iourc_content | | ['string', 'null'] | Content of the iourc file, if a file exist on servers this variable is ignored. It's mostly for compatibility with < 1.3 releases |
l1_keepalives | | ['boolean', 'null'] | Always up ethernet interface |
name | ✔ | string | IOU VM name |
nvram | | ['integer', 'null'] | Allocated NVRAM KB |
path | ✔ | string | Path of iou binary |
ram | | ['integer', 'null'] | Allocated RAM MB |
serial_adapters | | integer | How many serial adapters are connected to the IOU |
use_default_iou_values | | ['boolean', 'null'] | Use default IOU values |
vm_id | | | IOU VM identifier |
Output
*******
.. raw:: html
Name | Mandatory | Type | Description |
console | ✔ | integer | console TCP port |
ethernet_adapters | ✔ | integer | How many ethernet adapters are connected to the IOU |
initial_config | ✔ | ['string', 'null'] | Path of the initial config content relative to project directory |
iourc_path | | ['string', 'null'] | Path of the iourc file used by remote servers |
l1_keepalives | ✔ | boolean | Always up ethernet interface |
name | ✔ | string | IOU VM name |
nvram | ✔ | integer | Allocated NVRAM KB |
path | ✔ | string | Path of iou binary |
project_id | ✔ | string | Project UUID |
ram | ✔ | integer | Allocated RAM MB |
serial_adapters | ✔ | integer | How many serial adapters are connected to the IOU |
use_default_iou_values | ✔ | ['boolean', 'null'] | Use default IOU values |
vm_id | ✔ | string | IOU VM UUID |
Sample session
***************
.. literalinclude:: ../../examples/post_projectsprojectidiouvms.txt