Get List of Baremetal Servers

To get the list of all baremetal server in the cloud, use the following request:

GET /baremetal_servers.xml
GET /baremetal_servers.json

XML Request Example

curl -i -X GET -H 'Accept: application/xml' -H 'Content-type: application/xml' -u user:userpass --url http://onapp.test/baremetal_servers.xml

JSON Request Example

curl -i -X GET -H 'Accept: application/json' -H 'Content-type: application/json' -u user:userpass --url http://onapp.test/baremetal_servers.json

XML Output Example

<baremetal_servers type="array">
<admin_note nil="true"/>
<allowed_swap type="boolean">true</allowed_swap>
<built type="boolean">true</built>
<cpu_sockets nil="true"/>
<cpu_threads nil="true"/>
<cpu_units nil="true"/>
<created_at type="datetime">2015-03-04T17:10:24+02:00</created_at>
<deleted_at nil="true"/>
<hypervisor_id type="integer">123</hypervisor_id>
<id type="integer">3842</id>
<initial_root_password_encrypted type="boolean">false</initial_root_password_encrypted>
<local_remote_access_ip_address nil="true"/>
<locked type="boolean">false</locked>
<note nil="true"/>
<recovery_mode nil="true"/>
<template_id type="integer">19</template_id>
<updated_at type="datetime">2015-03-04T17:15:26+02:00</updated_at>
<user_id type="integer">1</user_id>
<ip_addresses type="array">
<created_at type="datetime">2014-01-15T11:18:12+02:00</created_at>
<customer_network_id nil="true"/>
<disallowed_primary type="boolean">false</disallowed_primary>
<hypervisor_id nil="true"/>
<id type="integer">324</id>
<ip_address_pool_id nil="true"/>
<network_id type="integer">4</network_id>
<pxe type="boolean">false</pxe>
<updated_at type="datetime">2014-01-15T11:18:12+02:00</updated_at>
<user_id nil="true"/>
<free type="boolean">false</free>


admin_note - an optional note of the administrator

allowed_swap - true if swap disk is allowed (depends on the template the server is based on); otherwise false

built - true if the server is built; otherwise false

cpu_sockets the amount of CPU sockets per core. This parameter can be set for KVM compute resources only by those users who have Enable CPU topology permission granted

cpu_threads the amount of CPU threads per core. This parameter can be set for KVM compute resources only by those users who have Enable CPU topology permission granted

cpu_units - the amount of CPU units per core if the CPU priority is replaced with CPU units in user billing plan.

created_at - the date in the [YYYY][MM][DD]T[hh][mm][ss]Z format

deleted_at time when the VS was deleted

hostname - the name of your host

hypervisor_id - the ID of the compute resource used by this baremetal server

id - the baremetal server ID

identifier - the baremetal server identifier

initial_root_password - the baremetal server root password

initial_root_password_encrypted - true, if the baremetal server root password is encrypted, otherwise false

label - the baremetal server label

local_remote_access_ip_address IP address used for remote access

locked - true if the baremetal server is locked; otherwise false

note - an optional reminder for this baremetal server made by a user account

operating_system - operating system used by the baremetal server

operating_system_distro - the distribution of the OS from which this baremetal server is built

template_id - the ID of the template the baremetal server is based on

template_label - the name of the template from which this baremetal server is built

updated_at - the date when the baremetal server was updated in the [YYYY][MM][DD]T[hh][mm][ss]Z format

ip_addresses - an array of  IP addresses with their details assigned to this baremetal server:

  • address – baremetal server IP
  • broadcast – a logical address at which all devices connected to a multiple-access communications network are enabled to receive datagrams.
  • created_at – time when the IP address was created in the [YYYY][MM][DD]T[hh][mm][ss]Z format
  • customer_network_id - customer network ID
  • disallowed_primary – true if not allowed to be used as primary (for baremetal server), otherwise false
  • gateway - gateway address
  • hypervisor_id - the ID of a compute resource the IP address is associated with
  • id –the ID of the IP address
  • ip_address_pool_id - ID of the IP address pool the IP address is associated with
  • pxe - true, if this compute resource address can be used for cloudbooting a compute resource
  • updated at - time when the IP address was updated in the [YYYY][MM][DD]T[hh][mm][ss]Z format
  • user_id - the ID of the user this IP address is assigned to
  • free – true if free, otherwise false
  • netmask — netmask for the IP address