Add Baremetal CloudBoot Compute Resource

To create a CloudBoot compute resource, use the following request:

POST /settings/assets/:asset_mac_address/hypervisors.xml
POST /settings/assets/:asset_mac_address/hypervisors.json

XML Request Example

curl -i -X POST http://onapp.test/settings/assets/00:30:48:fd:74:c6/hypervisors.xml -d '<hypervisor><label>baremetal</label><pxe_ip_address_id>2</pxe_ip_address_id><hypervisor_type>kvm</hypervisor_type><server_type>baremetal</server_type><enabled>1</enabled><failover_recipe_id>get_if_config</failover_recipe_id></hypervisor>' -u account_email:API_key -H 'Accept: application/xml' -H 'Content-type: application/xml'

JSON Request Example

curl -i -X POST http://onapp.test/settings/assets/00:30:48:fd:74:c6/hypervisors.json -d '{"hypervisor":{"label":"baremetal","pxe_ip_address_id":"2","hypervisor_type":"kvm","server_type":"baremetal","enabled":"1", "failover_recipe_id":"get_if_config"}}' -u account_email:API_key -H 'Accept:application/json' -H 'Content-type: application/json'


hypervisor - an array of compute resource details:

  • label * - the name of the compute resource
  • pxe_ip_address_id* - the ID of Cloud Boot IP address that will be used for this compute resource
  • hypervisor_type - specify if this is Xen or KVM compute resource

  • server_type - specify the type of servers that will be deployed on this compute resource:
    • baremetal - specify the baremetal server type to use this compute resource for baremetal server deployment. The server_type is virtual by default.
  •  enabled - set 1 to enable this compute resource, otherwise set 0
  • failover_recipe_id - the ID of a recipe to run before the failover process

Page History


  • added KVM as an option to the hypervisor_type parameter


  • added the failover_recipe_id parameter

v. 3.1 RC1

  • added the following parameters:
    • server_type
    • type (storage parameter)