Updated on 2026-09-02 GMT+08:00

Deleting a Configuration File

This API is used to delete a Logstash configuration file. You are advised to use the API for deleting a configuration file V2.

For details, see Calling APIs.

DELETE /v1.0/{project_id}/clusters/{cluster_id}/lgsconf/delete

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. For details about how to obtain the project ID and name, see Obtaining the Project ID and Name. Constraints N/A Range Project ID of an account. The value contains 32 characters, consisting of lowercase letters and digits. Default Value N/A
cluster_id	Yes	String	Definition ID of the cluster whose configuration file is to be deleted. For details about how to obtain the cluster ID, see Obtaining the Cluster ID. Constraints N/A Range The value is a UUID containing 36 characters. Default Value N/A

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
name	Yes	String	Definition Configuration file name. Constraints N/A Range N/A Default Value N/A

Status code: 200

Request succeeded.

None

Delete a configuration file.

DELETE https://{Endpoint}/v1.0/{project_id}/clusters/{cluster_id}/lgsconf/delete

{
  "name" : "conf1"
}

None

Status Code	Description
200	Request succeeded.
400	Invalid request. The client should modify the request instead of re-initiating it.
409	The request cannot be processed due to a conflict. This status code indicates that the resource that the client attempts to create already exits, or the requested update failed due to a conflict.
412	The server did not meet one of the preconditions contained in the request.

Parent topic: Logstash