summaryrefslogtreecommitdiff
path: root/api-ref/source/baremetal-api-v1-nodes-inventory.inc
blob: ed3fb9a814963717dcb80266e31c8d94c74b9149 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
.. -*- rst -*-

==============
Node inventory
==============

.. versionadded:: 1.81

Given a Node identifier, the API provides access to the introspection data
associated to the Node via ``v1/nodes/{node_ident}/inventory`` endpoint.

The format inventory comes from ironic-python-agent and is currently documented
in the `agent inventory documentation
<https://docs.openstack.org/ironic-python-agent/latest/admin/how_it_works.html#hardware-inventory>`_.

Show Node Inventory
===================

.. rest_method:: GET /v1/nodes/{node_ident}/inventory

Normal response code: 200

Error codes:
    - 404 (NodeNotFound, InventoryNotRecorded)

Request
-------

.. rest_parameters:: parameters.yaml

   - node_ident: node_ident

Response
--------

.. rest_parameters:: parameters.yaml

   - inventory: n_inventory
   - plugin_data: n_plugin_data

**Example of inventory from a node:**

.. literalinclude:: samples/node-inventory-response.json
   :language: javascript