50657a87df
This change adds missing POST request parameters and makes other minor corrections to the REST API documentation. Its possible that some of the parameters for /v1/nodes were never intended to be available for the POST call, but this docs change is to document what has been implemented, not the original intention. Change-Id: I1e35586d20bd3eda4d727931235340dd408c7508
90 lines
1.7 KiB
ReStructuredText
90 lines
1.7 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
==================================
|
|
VIFs (Virtual Interfaces) of nodes
|
|
==================================
|
|
|
|
.. versionadded:: 1.28
|
|
|
|
Attaching and detaching VIFs (Virtual Interfaces) to or from a node are done
|
|
via the ``v1/nodes/{node_ident}/vifs`` endpoint. Attaching a VIF to a node
|
|
means that a VIF will be mapped to a free port or port group of the specified
|
|
node.
|
|
|
|
List attached VIFs of a Node
|
|
============================
|
|
|
|
.. rest_method:: GET /v1/nodes/{node_ident}/vifs
|
|
|
|
Return a list of VIFs that are attached to the node.
|
|
|
|
Normal response code: 200
|
|
|
|
Error codes: 400,401,403,404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- node_ident: node_ident
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- vifs: n_vifs
|
|
- id: node_vif_ident
|
|
|
|
**Example list of VIFs that are attached to the node:**
|
|
|
|
.. literalinclude:: samples/node-vif-list-response.json
|
|
:language: javascript
|
|
|
|
|
|
Attach a VIF to a node
|
|
======================
|
|
|
|
.. rest_method:: POST /v1/nodes/{node_ident}/vifs
|
|
|
|
Attach a VIF to a node.
|
|
|
|
Normal response code: 204
|
|
|
|
Error codes: 400,401,403,404,409
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- id: req_node_vif_ident
|
|
- port_uuid: req_node_vif_port_uuid
|
|
- portgroup_uuid: req_node_vif_portgroup_uuid
|
|
- node_ident: node_ident
|
|
|
|
**Example request to attach a VIF to a Node:**
|
|
|
|
.. literalinclude:: samples/node-vif-attach-request.json
|
|
|
|
|
|
Detach VIF from a node
|
|
======================
|
|
|
|
.. rest_method:: DELETE /v1/nodes/{node_ident}/vifs/{node_vif_ident}
|
|
|
|
Detach VIF from a Node.
|
|
|
|
Normal response code: 204
|
|
|
|
Error codes: 400,401,403,404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- node_ident: node_ident
|
|
- node_vif_ident: req_node_vif_ident
|