Edit Baremetal CloudBoot Compute Resource

To edit a baremetal CloudBoot compute resource, use the following request:

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

XML Request Example

curl -i -X PUT http://onapp.test/settings/assets/00:0a:95:9d:68:16/hypervisors.xml -d '<hypervisor><label>baremetal</label><ip_address></ip_address><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:

JSON Request Example

curl -i -X PUT http://onapp.test/settings/assets/00:0a:95:9d:68:16/hypervisors.json -d '{"hypervisor":{"label":"baremetal","ip_address":"","enabled":"1","failover_recipe_id":"get_if_config"}}' -u account_email:API_key -H 'Accept:application/json' -H 'Content-type: application/json'


  • label * - the name of the compute resource 
  • ip_address - the compute resource IP address

    • When you change the Pxe IP address, you should reboot the CloudBoot compute resource immediately after saving the new settings. If you do not reboot the resource immediately, the Control Panel will fail to connect to the new IP address, causing failover transactions. You can reboot the compute resource manually from the console or use the Power Cycle command (if configured). 
      You cannot use the Reboot option on the CP UI to reboot the resource after changing the IP address. 
      You can also change the IP address of a CloudBoot compute resource that is offline and once the resource is booted, it will be available on the new IP Address.

    • If InfiniBand is enabled for CloudBoot, you should change the value of the cloud_boot pxe config after changing the Pxe IP address.
  • 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 the failover_recipe_id parameter


  • added the ip_address parameter