Updated on 2025-10-24 GMT+08:00

Querying Alarm Details

Function

This API is used to query alarm details by alarm ID.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    coc:alarm:get

    Read

    -

    -

    -

    -

URI

GET /v1/alarm-mgmt/alarm/{alarm_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

alarm_id

Yes

String

Definition:

Alarm ID.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

data

AlarmInfoDTO object

Alarm details.

Table 3 AlarmInfoDTO

Parameter

Type

Description

id

String

Definition:

Alarm ID, which uniquely identifies an alarm. You can obtain the alarm ID from the aggregated alarms page of the alarm management module on COC.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

name

String

Definition:

Alarm name.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

importance

String

Definition:

Alarm severity.

Constraints:

N/A

Value range:

urgent

  • major

  • minor

  • warn

Default value:

N/A

come_from

String

Definition:

Alarm source, which can be obtained from the integration management module. The value is the name of each cloud service.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

transfer_rule

String

Definition:

Unique ID of an alarm conversion rule. You can obtain the alarm conversion rule ID from the alarm management module of COC. An alarm is created using an alarm conversion rule.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

transfer_rule_name

String

Definition:

Name of the alarm conversion rule. You can obtain the alarm conversion rule name from the alarm management module of COC.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

app

String

Definition:

Application name. You need to enter the application name when creating an alarm conversion rule. You can obtain the application name from the alarm conversion rule.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

status

String

Definition:

Alarm status. There are two alarm states: alarming and resolved. When you click the button for clearing an alarm, the alarm status changes into resolved.

Constraints:

N/A

Value range:

  • alarming

  • resolved

Default value:

alarming

owner

String

Definition:

Owner ID. When creating an alarm conversion rule, you need to specify the owner. You can obtain the owner ID in the personnel management module.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

owner_name

String

Definition:

Owner name. When creating an alarm conversion rule, you need to specify the owner. You can obtain the owner name in the personnel management module.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

owner_alias

String

Definition:

Owner alias. COC allows you to set aliases for owners. You can obtain the aliases in the personnel management module.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

converge_count

Integer

Definition:

Number of alarms that meet the alarm conversion rule in a specified period.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

associate_event_id

String

Definition:

Associated incident ID, which uniquely identifies an incident. You can obtain the incident ID from the incident management page on COC. After an alarm is converted to an incident, the alarm can be associated with an incident.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

domain_id

String

Definition:

Tenant ID.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

creator

String

Definition:

ID of the user who creates the alarm conversion rule.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

creator_name

String

Definition:

Name of the user who creates the alarm conversion rule.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

create_time

Long

Definition:

Time the alarm was created.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

update_time

Long

Definition:

Alarm update time. This parameter is updated when you perform operations on an alarm.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

remarks

String

Definition:

Remarks. You can enter remarks when clearing an alarm.

Value range:

N/A

Default value:

N/A

region

String

Definition:

Region ID.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

task_type

String

Definition:

Task type. A specific task needs to be executed to handle alarms. For details, see the value range.

Constraints:

N/A

Value range:

  • SCRIPT: script

  • RUNBOOK: job

  • PLAN: contingency plan

Default value:

N/A

associated_task_type

String

Definition:

Task type. Each task can be classified as a custom task or a public task. Custom tasks are created by users, and public tasks are those provided by COC.

Constraints:

N/A

Value range:

  • CUSTOMIZATION: custom task.

  • COMMUNAL: public task.

Default value:

N/A

associated_task_id

String

Definition:

Unique ID of a task. You can obtain the task ID from the Resource O&M > Automated O&M page on COC.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

associated_task_name

String

Definition:

Task name. You can obtain the task name from the Resource O&M > Automated O&M page on COC.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Status code: 400

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Error code

error_msg

String

Error description

Example Requests

Query information about the alarm whose ID is ALM2025071216523205dS85AL9.

GET https://{Endpoint}/v1/alarm-mgmt/alarm/ALM2025071216523205dS85AL9

Example Responses

Status code: 200

The details about the alarm are queried successfully.

{
  "app" : "67878512ed22d8546b44fce4",
  "associated_task_id" : "SC20250422142607018c62b2d",
  "associated_task_name" : "Example",
  "associated_task_type" : "CUSTOMIZATION",
  "come_from" : "Cloud Eye",
  "come_from_en" : "HUAWEI CLOUD Cloud Monitor",
  "converge_count" : 1,
  "create_time" : 1752310352673,
  "enterprise_project_id" : "0",
  "id" : "ALM2025071216523205dS85AL9",
  "importance" : "minor",
  "name" : "Example",
  "owner" : "****",
  "owner_name" : "****",
  "region" : "***",
  "status" : "alarming",
  "task_type" : "SCRIPT",
  "transfer_rule" : "993568f199d7eb5d7cf297902250fdc8",
  "transfer_rule_name" : "Example"
}

Status Codes

Status Code

Description

200

The details about the alarm are queried successfully.

400

Invalid request from the client.

Error Codes

See Error Codes.