Deleting an Active Alarm¶

Function¶

This API is used to delete an active alarm.

URI¶

POST /v2/{project_id}/{domain_id}/lts/alarms/sql-alarm/clear

**Table 1** Path Parameters¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain a project ID, see Obtaining the Project ID, Account ID, Log Group ID, and Log Stream ID. Minimum: 32 Maximum: 32
domain_id	Yes	String	Account ID. For details about how to obtain an account ID, see Obtaining the Project ID, Account ID, Log Group ID, and Log Stream ID. Minimum: 32 Maximum: 32

Request Parameters¶

**Table 2** Request header parameters¶
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token obtained from IAM. For details about how to obtain a user token, see Obtaining a User Token. Minimum: 1000 Maximum: 2000
Content-Type	Yes	String	Set this parameter to application/json;charset=UTF-8. Minimum: 30 Maximum: 30

**Table 3** Request body parameters¶
Parameter	Mandatory	Type	Description
events	Yes	Array of Event objects	Topic information.

**Table 4** Event¶
Parameter	Mandatory	Type	Description
metadata	Yes	Metadata object	Alarm information. Minimum length: 0 Maximum length: 2048
starts_at	Yes	Long	Alarm generation time (timestamp). Minimum: 0 Maximum: 32

**Table 5** Metadata¶
Parameter	Mandatory	Type	Description
event_type	Yes	String	Alarm type.
event_id	Yes	String	Alarm ID.
event_severity	Yes	String	Alarm severity.
event_name	Yes	String	Alarm name.
resource_type	Yes	String	Resource type.
resource_id	Yes	String	Log group/stream name.
resource_provider	Yes	String	Alarm source.
lts_alarm_type	Yes	String	Alarm rule type (SQL/keyword).

Response Parameters¶

None

Example Requests¶

Deleting an active alarm by alarm ID

POST https://{endpoint}/v2/{project_id}/{domain_id}/lts/alarms/sql-alarm/clear

{
  "events" : [ {
    "metadata" : {
      "event_type" : "alarm",
      "event_id" : "1",
      "lts_alarm_type" : "keywords/sql",
      "resource_type" : "Log group/stream.",
      "event_severity" : "Critical",
      "resource_id" : "lts-group-demo/lts-topic-demo",
      "event_name" : "demo",
      "resource_provider" : "LTS"
    },
    "starts_at" : 1629947408497
  } ]
}

Example Responses¶

None

Status Codes¶

Status Code	Description
200	The request is successful.
500	The server has received the request but encountered an internal error.

Error Codes¶

See Error Codes.

last updated: 2025-10-17 11:00 UTC - commit: 1aef8cbecb9139d36db154d6ff3015832882e151