55 lines
1.1 KiB
PHP
55 lines
1.1 KiB
PHP
![]() |
.. -*- rst -*-
|
||
|
|
||
|
=====================================
|
||
|
Attach / Detach Virtual Media (nodes)
|
||
|
=====================================
|
||
|
|
||
|
.. versionadded:: 1.89
|
||
|
|
||
|
Attach a generic image as virtual media device to a node or remove
|
||
|
it from a node using the ``v1/nodes/{node_ident}/vmedia`` endpoint.
|
||
|
|
||
|
Attach a virtual media to a node
|
||
|
================================
|
||
|
|
||
|
.. rest_method:: POST /v1/nodes/{node_ident}/vmedia
|
||
|
|
||
|
Attach virtual media device to a node.
|
||
|
|
||
|
Normal response code: 204
|
||
|
|
||
|
Error codes: 400,401,403,404,409
|
||
|
|
||
|
Request
|
||
|
-------
|
||
|
|
||
|
.. rest_parameters:: parameters.yaml
|
||
|
|
||
|
- node_ident: node_ident
|
||
|
- device_type: vmedia_device_type
|
||
|
- image_url: vmedia_image_url
|
||
|
- image_download_source: vmedia_image_download_source
|
||
|
|
||
|
**Example request to attach virtual media to a Node:**
|
||
|
|
||
|
.. literalinclude:: samples/node-vmedia-attach-request.json
|
||
|
|
||
|
|
||
|
Detach virtual media from a node
|
||
|
================================
|
||
|
|
||
|
.. rest_method:: DELETE /v1/nodes/{node_ident}/vmedia
|
||
|
|
||
|
Detach virtual media device from a Node.
|
||
|
|
||
|
Normal response code: 204
|
||
|
|
||
|
Error codes: 400,401,403,404
|
||
|
|
||
|
Request
|
||
|
-------
|
||
|
|
||
|
.. rest_parameters:: parameters.yaml
|
||
|
|
||
|
- node_ident: node_ident
|