Remove unwanted deployment templates and instance configurations

If you configure the deployment templates in ECE and find that you created instance configurations or deployment templates that you no longer need, you can use these steps to delete them through the RESTful API. Alternatively, you can also use the UI to delete these artifacts.

Before you begin

Deleting instance configurations or deployment templates does not affect existing deployments that got created from these artifacts, but you should still make sure that you no longer need these artifacts, as there is no undo function. You cannot delete system-owned instance configurations or deployment templates.


To remove an instance configuration:

  1. List the available instance configurations to find out the ID for the instance configuration you want to delete:

    curl -k -X POST -u $USER:$PASSWORD https://$COORDINATOR_HOST:12443/api/v1/platform/configuration/instances

    A user with sufficient privileges, such as the admin user

    The password for the user

    A host that you installed Elastic Cloud Enterprise on that holds the coordinator role, such as a host where you can log into the Cloud UI.

  2. Delete the instance configuration using the ID:

    curl -k -X  DELETE -u $USER:$PASSWORD https://$COORDINATOR_HOST:12443/api/v1/platform/configuration/instances/$INSTANCE_CONFIGURATION_ID

    The instance configuration ID as returned by the instance_configuration_id field

To remove a deployment template through the RESTful API:

  1. List the available deployment templates to find out the ID:

    curl -k -X GET -u $USER:$PASSWORD https://$COORDINATOR_HOST:12443/api/v1/platform/configuration/templates/deployments
  2. Delete the deployment templates using the ID:

    curl -k -X DELETE -u $USER:$PASSWORD https://$COORDINATOR_HOST:12443/api/v1/platform/configuration/templates/deployments/$DEPLOYMENT_TEMPLATE_ID

    The deployment template ID as returned by the id field