ironic/api-ref/source/baremetal-api-v1-nodes-firm...

49 lines
1.1 KiB
ReStructuredText

.. -*- rst -*-
=====================
Node Firmware (nodes)
=====================
.. versionadded:: 1.86
Given a Node identifier (``uuid`` or ``name``), the API exposes the list of
all Firmware Components associated with that Node.
These endpoints do not allow modification of the Firmware Components; that
should be done by using ``clean steps``.
List all Firmware Components by Node
====================================
.. rest_method:: GET /v1/nodes/{node_ident}/firmware
Return a list of Firmware Components associated with ``node_ident``.
Normal response code: 200
Error codes: 404
Request
-------
.. rest_parameters:: parameters.yaml
- node_ident: node_ident
Response
--------
.. rest_parameters:: parameters.yaml
- firmware: firmware_components
- created_at: created_at
- updated_at: updated_at
- component: firmware_component
- initial_version: firmware_component_initial_version
- current_version: firmware_component_current_version
- last_version_flashed: firmware_component_last_version_flashed
**Example list of a Node's Firmware Components:**
.. literalinclude:: samples/node-firmware-components-list-response.json