2016-12-23 12:34:58 +00:00
|
|
|
.. -*- rst -*-
|
|
|
|
|
|
|
|
==================================
|
|
|
|
VIFs (Virtual Interfaces) of nodes
|
|
|
|
==================================
|
|
|
|
|
2017-08-02 13:32:27 +01:00
|
|
|
.. 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.
|
2016-12-23 12:34:58 +00:00
|
|
|
|
|
|
|
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
|
|
|
|
|
2018-07-03 11:23:25 +00:00
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- node_ident: node_ident
|
|
|
|
|
2016-12-23 12:34:58 +00:00
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- vifs: n_vifs
|
2018-07-03 11:23:25 +00:00
|
|
|
- id: node_vif_ident
|
2016-12-23 12:34:58 +00:00
|
|
|
|
|
|
|
**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
|
|
|
|
|
2017-11-06 16:04:33 +08:00
|
|
|
- id: req_node_vif_ident
|
2020-10-12 10:11:53 +13:00
|
|
|
- port_uuid: req_node_vif_port_uuid
|
|
|
|
- portgroup_uuid: req_node_vif_portgroup_uuid
|
2017-01-20 20:30:09 +00:00
|
|
|
- node_ident: node_ident
|
2016-12-23 12:34:58 +00:00
|
|
|
|
|
|
|
**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
|
2017-11-08 19:00:39 +08:00
|
|
|
|
|
|
|
Request
|
|
|
|
-------
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- node_ident: node_ident
|
2017-11-06 16:04:33 +08:00
|
|
|
- node_vif_ident: req_node_vif_ident
|