mirror of
https://github.com/GNS3/gns3-server.git
synced 2024-11-16 16:54:51 +02:00
Update documentation.
This commit is contained in:
parent
291fac7084
commit
c12d3ff739
@ -1,8 +1,8 @@
|
|||||||
curl -i -X PUT 'http://localhost:8000/projects/{project_id}' -d '{"path": "/tmp/pytest-42/test_update_path_project_non_l0"}'
|
curl -i -X PUT 'http://localhost:8000/projects/{project_id}' -d '{"path": "/tmp/pytest-48/test_update_path_project_non_l0"}'
|
||||||
|
|
||||||
PUT /projects/{project_id} HTTP/1.1
|
PUT /projects/{project_id} HTTP/1.1
|
||||||
{
|
{
|
||||||
"path": "/tmp/pytest-42/test_update_path_project_non_l0"
|
"path": "/tmp/pytest-48/test_update_path_project_non_l0"
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
30
docs/api/v1projectidvirtualboxvmidcaptureadapteriddstart.rst
Normal file
30
docs/api/v1projectidvirtualboxvmidcaptureadapteriddstart.rst
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
/v1/{project_id}/virtualbox/{vm_id}/capture/{adapter_id:\d+}/start
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/virtualbox/**{vm_id}**/capture/**{adapter_id:\d+}**/start
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Start a packet capture on a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
- **adapter_id**: Adapter to start a packet capture
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **200**: Capture started
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
|
||||||
|
Input
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>capture_filename</td> <td>✔</td> <td>string</td> <td>Capture file name</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
21
docs/api/v1projectidvirtualboxvmidcaptureadapteriddstop.rst
Normal file
21
docs/api/v1projectidvirtualboxvmidcaptureadapteriddstop.rst
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
/v1/{project_id}/virtualbox/{vm_id}/capture/{adapter_id:\d+}/stop
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/virtualbox/**{vm_id}**/capture/**{adapter_id:\d+}**/stop
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Stop a packet capture on a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
- **adapter_id**: Adapter to stop a packet capture
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Capture stopped
|
||||||
|
|
55
docs/api/v1projectidvirtualboxvms.rst
Normal file
55
docs/api/v1projectidvirtualboxvms.rst
Normal file
@ -0,0 +1,55 @@
|
|||||||
|
/v1/{project_id}/virtualbox/vms
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/virtualbox/vms
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Create a new VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **201**: Instance created
|
||||||
|
- **409**: Conflict
|
||||||
|
|
||||||
|
Input
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>adapter_start_index</td> <td> </td> <td>integer</td> <td>adapter index from which to start using adapters</td> </tr>
|
||||||
|
<tr><td>adapter_type</td> <td> </td> <td>string</td> <td>VirtualBox adapter type</td> </tr>
|
||||||
|
<tr><td>adapters</td> <td> </td> <td>integer</td> <td>number of adapters</td> </tr>
|
||||||
|
<tr><td>console</td> <td> </td> <td>integer</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>enable_remote_console</td> <td> </td> <td>boolean</td> <td>enable the remote console</td> </tr>
|
||||||
|
<tr><td>headless</td> <td> </td> <td>boolean</td> <td>headless mode</td> </tr>
|
||||||
|
<tr><td>linked_clone</td> <td>✔</td> <td>boolean</td> <td>either the VM is a linked clone or not</td> </tr>
|
||||||
|
<tr><td>name</td> <td>✔</td> <td>string</td> <td>VirtualBox VM instance name</td> </tr>
|
||||||
|
<tr><td>vm_id</td> <td> </td> <td>string</td> <td>VirtualBox VM instance identifier</td> </tr>
|
||||||
|
<tr><td>vmname</td> <td>✔</td> <td>string</td> <td>VirtualBox VM name (in VirtualBox itself)</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
Output
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>adapter_start_index</td> <td> </td> <td>integer</td> <td>adapter index from which to start using adapters</td> </tr>
|
||||||
|
<tr><td>adapter_type</td> <td> </td> <td>string</td> <td>VirtualBox adapter type</td> </tr>
|
||||||
|
<tr><td>adapters</td> <td> </td> <td>integer</td> <td>number of adapters</td> </tr>
|
||||||
|
<tr><td>console</td> <td> </td> <td>integer</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>enable_remote_console</td> <td> </td> <td>boolean</td> <td>enable the remote console</td> </tr>
|
||||||
|
<tr><td>headless</td> <td> </td> <td>boolean</td> <td>headless mode</td> </tr>
|
||||||
|
<tr><td>name</td> <td>✔</td> <td>string</td> <td>VirtualBox VM instance name</td> </tr>
|
||||||
|
<tr><td>project_id</td> <td>✔</td> <td>string</td> <td>Project UUID</td> </tr>
|
||||||
|
<tr><td>vm_id</td> <td>✔</td> <td>string</td> <td>VirtualBox VM instance UUID</td> </tr>
|
||||||
|
<tr><td>vmname</td> <td> </td> <td>string</td> <td>VirtualBox VM name (in VirtualBox itself)</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
105
docs/api/v1projectidvirtualboxvmsvmid.rst
Normal file
105
docs/api/v1projectidvirtualboxvmsvmid.rst
Normal file
@ -0,0 +1,105 @@
|
|||||||
|
/v1/{project_id}/virtualbox/vms/{vm_id}
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
GET /v1/**{project_id}**/virtualbox/vms/**{vm_id}**
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Get a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **200**: Success
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
|
||||||
|
Output
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>adapter_start_index</td> <td> </td> <td>integer</td> <td>adapter index from which to start using adapters</td> </tr>
|
||||||
|
<tr><td>adapter_type</td> <td> </td> <td>string</td> <td>VirtualBox adapter type</td> </tr>
|
||||||
|
<tr><td>adapters</td> <td> </td> <td>integer</td> <td>number of adapters</td> </tr>
|
||||||
|
<tr><td>console</td> <td> </td> <td>integer</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>enable_remote_console</td> <td> </td> <td>boolean</td> <td>enable the remote console</td> </tr>
|
||||||
|
<tr><td>headless</td> <td> </td> <td>boolean</td> <td>headless mode</td> </tr>
|
||||||
|
<tr><td>name</td> <td>✔</td> <td>string</td> <td>VirtualBox VM instance name</td> </tr>
|
||||||
|
<tr><td>project_id</td> <td>✔</td> <td>string</td> <td>Project UUID</td> </tr>
|
||||||
|
<tr><td>vm_id</td> <td>✔</td> <td>string</td> <td>VirtualBox VM instance UUID</td> </tr>
|
||||||
|
<tr><td>vmname</td> <td> </td> <td>string</td> <td>VirtualBox VM name (in VirtualBox itself)</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
|
||||||
|
PUT /v1/**{project_id}**/virtualbox/vms/**{vm_id}**
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Update a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **200**: Instance updated
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **409**: Conflict
|
||||||
|
|
||||||
|
Input
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>adapter_start_index</td> <td> </td> <td>integer</td> <td>adapter index from which to start using adapters</td> </tr>
|
||||||
|
<tr><td>adapter_type</td> <td> </td> <td>string</td> <td>VirtualBox adapter type</td> </tr>
|
||||||
|
<tr><td>adapters</td> <td> </td> <td>integer</td> <td>number of adapters</td> </tr>
|
||||||
|
<tr><td>console</td> <td> </td> <td>integer</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>enable_remote_console</td> <td> </td> <td>boolean</td> <td>enable the remote console</td> </tr>
|
||||||
|
<tr><td>headless</td> <td> </td> <td>boolean</td> <td>headless mode</td> </tr>
|
||||||
|
<tr><td>name</td> <td> </td> <td>string</td> <td>VirtualBox VM instance name</td> </tr>
|
||||||
|
<tr><td>vmname</td> <td> </td> <td>string</td> <td>VirtualBox VM name (in VirtualBox itself)</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
Output
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>adapter_start_index</td> <td> </td> <td>integer</td> <td>adapter index from which to start using adapters</td> </tr>
|
||||||
|
<tr><td>adapter_type</td> <td> </td> <td>string</td> <td>VirtualBox adapter type</td> </tr>
|
||||||
|
<tr><td>adapters</td> <td> </td> <td>integer</td> <td>number of adapters</td> </tr>
|
||||||
|
<tr><td>console</td> <td> </td> <td>integer</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>enable_remote_console</td> <td> </td> <td>boolean</td> <td>enable the remote console</td> </tr>
|
||||||
|
<tr><td>headless</td> <td> </td> <td>boolean</td> <td>headless mode</td> </tr>
|
||||||
|
<tr><td>name</td> <td>✔</td> <td>string</td> <td>VirtualBox VM instance name</td> </tr>
|
||||||
|
<tr><td>project_id</td> <td>✔</td> <td>string</td> <td>Project UUID</td> </tr>
|
||||||
|
<tr><td>vm_id</td> <td>✔</td> <td>string</td> <td>VirtualBox VM instance UUID</td> </tr>
|
||||||
|
<tr><td>vmname</td> <td> </td> <td>string</td> <td>VirtualBox VM name (in VirtualBox itself)</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
|
||||||
|
DELETE /v1/**{project_id}**/virtualbox/vms/**{vm_id}**
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Delete a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance deleted
|
||||||
|
|
@ -0,0 +1,38 @@
|
|||||||
|
/v1/{project_id}/virtualbox/vms/{vm_id}/adapters/{adapter_id:\d+}/nio
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/virtualbox/vms/**{vm_id}**/adapters/**{adapter_id:\d+}**/nio
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Add a NIO to a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
- **adapter_id**: Adapter where the nio should be added
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **201**: NIO created
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
|
||||||
|
|
||||||
|
DELETE /v1/**{project_id}**/virtualbox/vms/**{vm_id}**/adapters/**{adapter_id:\d+}**/nio
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Remove a NIO from a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
- **adapter_id**: Adapter from where the nio should be removed
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: NIO deleted
|
||||||
|
|
20
docs/api/v1projectidvirtualboxvmsvmidreload.rst
Normal file
20
docs/api/v1projectidvirtualboxvmsvmidreload.rst
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
/v1/{project_id}/virtualbox/vms/{vm_id}/reload
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/virtualbox/vms/**{vm_id}**/reload
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Reload a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance reloaded
|
||||||
|
|
20
docs/api/v1projectidvirtualboxvmsvmidresume.rst
Normal file
20
docs/api/v1projectidvirtualboxvmsvmidresume.rst
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
/v1/{project_id}/virtualbox/vms/{vm_id}/resume
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/virtualbox/vms/**{vm_id}**/resume
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Resume a suspended VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance resumed
|
||||||
|
|
20
docs/api/v1projectidvirtualboxvmsvmidstart.rst
Normal file
20
docs/api/v1projectidvirtualboxvmsvmidstart.rst
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
/v1/{project_id}/virtualbox/vms/{vm_id}/start
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/virtualbox/vms/**{vm_id}**/start
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Start a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance started
|
||||||
|
|
20
docs/api/v1projectidvirtualboxvmsvmidstop.rst
Normal file
20
docs/api/v1projectidvirtualboxvmsvmidstop.rst
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
/v1/{project_id}/virtualbox/vms/{vm_id}/stop
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/virtualbox/vms/**{vm_id}**/stop
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Stop a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance stopped
|
||||||
|
|
20
docs/api/v1projectidvirtualboxvmsvmidsuspend.rst
Normal file
20
docs/api/v1projectidvirtualboxvmsvmidsuspend.rst
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
/v1/{project_id}/virtualbox/vms/{vm_id}/suspend
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/virtualbox/vms/**{vm_id}**/suspend
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Suspend a VirtualBox VM instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance suspended
|
||||||
|
|
45
docs/api/v1projectidvpcsvms.rst
Normal file
45
docs/api/v1projectidvpcsvms.rst
Normal file
@ -0,0 +1,45 @@
|
|||||||
|
/v1/{project_id}/vpcs/vms
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/vpcs/vms
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Create a new VPCS instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **201**: Instance created
|
||||||
|
- **409**: Conflict
|
||||||
|
|
||||||
|
Input
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>console</td> <td> </td> <td>['integer', 'null']</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>name</td> <td>✔</td> <td>string</td> <td>VPCS VM name</td> </tr>
|
||||||
|
<tr><td>startup_script</td> <td> </td> <td>['string', 'null']</td> <td>Content of the VPCS startup script</td> </tr>
|
||||||
|
<tr><td>vm_id</td> <td> </td> <td>string</td> <td>VPCS VM identifier</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
Output
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>console</td> <td>✔</td> <td>integer</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>name</td> <td>✔</td> <td>string</td> <td>VPCS VM name</td> </tr>
|
||||||
|
<tr><td>project_id</td> <td>✔</td> <td>string</td> <td>Project UUID</td> </tr>
|
||||||
|
<tr><td>script_file</td> <td> </td> <td>['string', 'null']</td> <td>VPCS startup script</td> </tr>
|
||||||
|
<tr><td>startup_script</td> <td> </td> <td>['string', 'null']</td> <td>Content of the VPCS startup script</td> </tr>
|
||||||
|
<tr><td>vm_id</td> <td>✔</td> <td>string</td> <td>VPCS VM UUID</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
92
docs/api/v1projectidvpcsvmsvmid.rst
Normal file
92
docs/api/v1projectidvpcsvmsvmid.rst
Normal file
@ -0,0 +1,92 @@
|
|||||||
|
/v1/{project_id}/vpcs/vms/{vm_id}
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
GET /v1/**{project_id}**/vpcs/vms/**{vm_id}**
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Get a VPCS instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **200**: Success
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
|
||||||
|
Output
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>console</td> <td>✔</td> <td>integer</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>name</td> <td>✔</td> <td>string</td> <td>VPCS VM name</td> </tr>
|
||||||
|
<tr><td>project_id</td> <td>✔</td> <td>string</td> <td>Project UUID</td> </tr>
|
||||||
|
<tr><td>script_file</td> <td> </td> <td>['string', 'null']</td> <td>VPCS startup script</td> </tr>
|
||||||
|
<tr><td>startup_script</td> <td> </td> <td>['string', 'null']</td> <td>Content of the VPCS startup script</td> </tr>
|
||||||
|
<tr><td>vm_id</td> <td>✔</td> <td>string</td> <td>VPCS VM UUID</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
|
||||||
|
PUT /v1/**{project_id}**/vpcs/vms/**{vm_id}**
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Update a VPCS instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **200**: Instance updated
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **409**: Conflict
|
||||||
|
|
||||||
|
Input
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>console</td> <td> </td> <td>['integer', 'null']</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>name</td> <td> </td> <td>['string', 'null']</td> <td>VPCS VM name</td> </tr>
|
||||||
|
<tr><td>startup_script</td> <td> </td> <td>['string', 'null']</td> <td>Content of the VPCS startup script</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
Output
|
||||||
|
*******
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<table>
|
||||||
|
<tr> <th>Name</th> <th>Mandatory</th> <th>Type</th> <th>Description</th> </tr>
|
||||||
|
<tr><td>console</td> <td>✔</td> <td>integer</td> <td>console TCP port</td> </tr>
|
||||||
|
<tr><td>name</td> <td>✔</td> <td>string</td> <td>VPCS VM name</td> </tr>
|
||||||
|
<tr><td>project_id</td> <td>✔</td> <td>string</td> <td>Project UUID</td> </tr>
|
||||||
|
<tr><td>script_file</td> <td> </td> <td>['string', 'null']</td> <td>VPCS startup script</td> </tr>
|
||||||
|
<tr><td>startup_script</td> <td> </td> <td>['string', 'null']</td> <td>Content of the VPCS startup script</td> </tr>
|
||||||
|
<tr><td>vm_id</td> <td>✔</td> <td>string</td> <td>VPCS VM UUID</td> </tr>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
|
||||||
|
DELETE /v1/**{project_id}**/vpcs/vms/**{vm_id}**
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Delete a VPCS instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance deleted
|
||||||
|
|
38
docs/api/v1projectidvpcsvmsvmidportsportnumberdnio.rst
Normal file
38
docs/api/v1projectidvpcsvmsvmidportsportnumberdnio.rst
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
/v1/{project_id}/vpcs/vms/{vm_id}/ports/{port_number:\d+}/nio
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/vpcs/vms/**{vm_id}**/ports/**{port_number:\d+}**/nio
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Add a NIO to a VPCS instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
- **port_number**: Port where the nio should be added
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **201**: NIO created
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
|
||||||
|
|
||||||
|
DELETE /v1/**{project_id}**/vpcs/vms/**{vm_id}**/ports/**{port_number:\d+}**/nio
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Remove a NIO from a VPCS instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
- **port_number**: Port from where the nio should be removed
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: NIO deleted
|
||||||
|
|
20
docs/api/v1projectidvpcsvmsvmidreload.rst
Normal file
20
docs/api/v1projectidvpcsvmsvmidreload.rst
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
/v1/{project_id}/vpcs/vms/{vm_id}/reload
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/vpcs/vms/**{vm_id}**/reload
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Reload a VPCS instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance reloaded
|
||||||
|
|
20
docs/api/v1projectidvpcsvmsvmidstart.rst
Normal file
20
docs/api/v1projectidvpcsvmsvmidstart.rst
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
/v1/{project_id}/vpcs/vms/{vm_id}/start
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/vpcs/vms/**{vm_id}**/start
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Start a VPCS instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance started
|
||||||
|
|
20
docs/api/v1projectidvpcsvmsvmidstop.rst
Normal file
20
docs/api/v1projectidvpcsvmsvmidstop.rst
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
/v1/{project_id}/vpcs/vms/{vm_id}/stop
|
||||||
|
-----------------------------------------------------------
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
|
||||||
|
POST /v1/**{project_id}**/vpcs/vms/**{vm_id}**/stop
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
Stop a VPCS instance
|
||||||
|
|
||||||
|
Parameters
|
||||||
|
**********
|
||||||
|
- **vm_id**: UUID for the instance
|
||||||
|
- **project_id**: UUID for the project
|
||||||
|
|
||||||
|
Response status codes
|
||||||
|
**********************
|
||||||
|
- **400**: Invalid request
|
||||||
|
- **404**: Instance doesn't exist
|
||||||
|
- **204**: Instance stopped
|
||||||
|
|
Loading…
Reference in New Issue
Block a user