Delete cluster

edit

DEPRECATED (Scheduled to be removed in the next major version): Deletes the Kibana instance. Before you delete the Kibana instance, you must first successfully issue a _shutdown command.

Request

edit

DELETE /api/v1/clusters/kibana/{cluster_id}

Path parameters

edit
Name Type Required Description

cluster_id

string

Y

The Kibana deployment identifier.

Responses

edit
200

(EmptyResponse) The cluster has been successfully deleted

404

(BasicFailedReply) The cluster specified by {cluster_id} cannot be found (code: 'clusters.cluster_not_found')

412

(BasicFailedReply) The Kibana cluster has not been shutdown yet (code: 'clusters.cluster_plan_state_error')

449

(BasicFailedReply) elevated permissions are required. (code: '"root.unauthorized.rbac.elevated_permissions_required"')

To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.

Request example

edit
curl -XDELETE https://{{hostname}}/api/v1/clusters/kibana/{cluster_id} \
-H "Authorization: ApiKey $ECE_API_KEY"