/v2/hypervisor/projects/{project_id}/iou/vms
------------------------------------------------------------------------------------------------------------------------------------------
.. contents::
POST /v2/hypervisor/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 |
| 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 |
| 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 |
| vm_id | | | IOU VM identifier |
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 |
| 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 | |
| vm_id | ✔ | string | IOU VM UUID |
Sample session
***************
.. literalinclude:: ../../../examples/hypervisor_post_projectsprojectidiouvms.txt