How to Delete Cluster BluePrint and HostConfig Using Resmgr API

Problem

An existing cluster blueprint and host config cannot be deleted through the user interface (UI).

Environment

  • Private Cloud Director Virtualization - v2025.4 and Higher

  • Self-Hosted Private Cloud Director Virtualization - v2025.4 and Higher

  • Component - Blueprint

Procedure

Info

This can be used when there is a need to delete an existing blueprint or host configuration, or in cases where issues occur—such as failure to save or errors while creating a new blueprint. It is recommended to always list the existing blueprints to check for any stale entries before proceeding.

  1. Retrieve the token:

$ token=$(openstack token issue -f value -c id)
  1. Get the list of Blueprints and Hostconfigs

$ curl -s -X GET -H "X-Auth-Token: $token" https://<REGION_FQDN>/resmgr/v2/blueprint | jq '.[] | {name}'
$ curl -s -X GET -H "X-Auth-Token: $token" https://<REGION_FQDN>/resmgr/v2/hostconfigs | jq '.[] | {id, name}'
  1. Delete the required Blueprint and Hostconfig

$ curl -s -X DELETE \ -H "X-Auth-Token: $token" \ "https://<REGION_FQDN>/resmgr/v2/blueprint/<BLUEPRINT_NAME>"
$ curl -s -X DELETE \ -H "X-Auth-Token: $token" \ "https://<REGION_FQDN>/resmgr/v2/hostconfigs/<HOSTCONFIG_ID>"

Validation

$ curl -s -X GET -H "X-Auth-Token: $token" https://<REGION_FQDN>/resmgr/v2/blueprint | jq '.[] | {name}' $ curl -s -X GET -H "X-Auth-Token: $token" https://<REGION_FQDN>/resmgr/v2/hostconfigs | jq '.[] | {id, name}'