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}
|
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
|
Parameter |
Type |
Description |
|---|---|---|
|
data |
AlarmInfoDTO object |
Alarm details. |
|
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 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: 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: 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: 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
|
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.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot