summaryrefslogtreecommitdiff
path: root/api-ref/source/os-baremetal-nodes.inc
blob: c79b5bd77c3b2dd5cd16ac812c1a803a9fd0e969 (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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
.. -*- rst -*-

===================================================
 Bare metal nodes (os-baremetal-nodes) (DEPRECATED)
===================================================

.. warning::

   These APIs are proxy calls to the Ironic service. They exist for
   legacy compatibility, but no new applications should use them.
   Nova has deprecated all the proxy APIs and users should use the native
   APIs instead. These will fail with a 404 starting from microversion 2.36.
   See: `Relevant Bare metal APIs
   <https://docs.openstack.org/api-ref/baremetal/index.html#nodes-nodes>`__.

Bare metal nodes.

List Bare Metal Nodes
=====================

.. rest_method:: GET /os-baremetal-nodes

Lists the bare metal nodes known by the compute environment.

Normal response codes: 202

Error response codes: unauthorized(401), forbidden(403),
notImplemented(501)


Response
--------

.. rest_parameters:: parameters.yaml

   - nodes: baremetal_nodes
   - id: baremetal_id
   - interfaces: baremetal_interfaces
   - host: baremetal_host
   - task_state: baremetal_taskstate
   - cpus: baremetal_cpus
   - memory_mb: baremetal_mem
   - disk_gb: baremetal_disk

**Example List Bare Metal Nodes**

.. literalinclude:: ../../doc/api_samples/os-baremetal-nodes/baremetal-node-list-resp.json
   :language: javascript

Show Bare Metal Node Details
============================

.. rest_method:: GET /os-baremetal-nodes/{node_id}

Shows details for a bare metal node.

Normal response codes: 202

Error response codes: unauthorized(401), forbidden(403),
itemNotFound(404), notImplemented(501)

Request
-------

.. rest_parameters:: parameters.yaml

  - node_id: node_id

Response
--------

.. rest_parameters:: parameters.yaml

   - node: baremetal_node
   - id: baremetal_id
   - instance_uuid: baremetal_instance_uuid
   - interfaces: baremetal_interfaces
   - host: baremetal_host
   - task_state: baremetal_taskstate
   - cpus: baremetal_cpus
   - memory_mb: baremetal_mem
   - disk_gb: baremetal_disk

**Example Show Bare Metal Node Details**

.. literalinclude:: ../../doc/api_samples/os-baremetal-nodes/baremetal-node-get-resp.json
   :language: javascript