Help Center/ Application Operations Management/ API Reference/ APIs/ Alarm/ Querying the Alarm Template List

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

Online Debugging

CLI Examples

View PDF

Querying the Alarm Template List

Function

This API is used to query the alarm template list.

Calling Method

For details, see Calling APIs.

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
aom:alarmRuleTemplate:list	List	-	-	-	-

URI

GET /v4/{project_id}/alarm-rules-template

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID, which can be obtained from the console or by calling an API. For details, see Obtaining a Project ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
id	No	String	Alarm template ID.
type	Yes	String	Alarm template type. Default: template.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token obtained from IAM. For details, see Obtaining a Token.
Content-Type	No	String	Message body type or format. Content type, which is application/json.
Enterprise-Project-Id	No	String	Enterprise project ID. For details, see Obtaining an Enterprise Project ID. To query the instances in an enterprise project, enter the enterprise project ID. To query the instances in all enterprise projects, enter all_granted_eps.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
alarm_rule_templates	Array of AlarmRuleTemplateBody objects	Alarm template list.
count	Integer	Total number of alarm templates.

**Table 5** AlarmRuleTemplateBody
Parameter	Type	Description
alarm_rule_template_name	String	Alarm template name.
alarm_rule_template_name_en	String	Name of an alarm template.
alarm_rule_template_description	String	Alarm template description.
alarm_rule_template_id	String	Alarm template ID.
alarm_rule_template_project_id	String	Project ID, which can be obtained from the console or by calling an API. For details, see Obtaining a Project ID.
alarm_rule_template_type	String	Alarm template type. statics: static alarm template. dynamic: dynamic alarm template.
alarm_rule_template_source	String	Source of an alarm template.
alarm_rule_template_binding	Map<String,String>	Alarm rule bound to the alarm template.
alarm_template_spec_list	Array of AlarmRuleTemplateSpecWithCloudService objects	Alarm template list.
enterprise_project_id	String	Enterprise project ID. For details, see Obtaining an Enterprise Project ID.
create_time	Long	Creation time (UTC timestamp, in milliseconds). Example: 2024-10-16 16:03:01 needs to be converted to UTC timestamp 1702759381000 using a tool.
modify_time	Long	Update time (UTC timestamp, in milliseconds). Example: 2024-10-16 16:03:01 needs to be converted to UTC timestamp 1702759381000 using a tool.
templating	Templating object	List of variables in an alarm template.
template_version	String	Version of an alarm template.

**Table 6** AlarmRuleTemplateSpecWithCloudService
Parameter	Type	Description
related_cloud_service	String	Associated cloud service.
related_cce_clusters	Array of strings	Associated CCE cluster.
related_prometheus_instances	Array of strings	Associated Prometheus instance.
alarm_notification	AlarmNotification object	Notification information.
alarm_template_spec_items	Array of AlarmTemplateSpecItem objects	Alarm template list.

**Table 7** AlarmNotification
Parameter	Type	Description
notification_type	String	Notification type. direct: direct alarm reporting alarm_policy: alarm reporting after noise reduction
route_group_enable	Boolean	Whether to enable the alarm grouping rule. If the notification type is set to alarm_policy, set this parameter to true. If the notification type is set to direct, set this parameter to false. If both notify_triggered and notify_resolved are set to false, route_group_enable must be set to false.
route_group_rule	String	Alarm grouping rule name. If route_group_enable is set to true, enter an alarm grouping rule name. If route_group_enable is set to false, enter "".
notification_enable	Boolean	Whether to enable the alarm notification rule. If the notification type is direct, set this parameter to true. If the notification type is alarm_policy, set this parameter to false. If both notify_triggered and notify_resolved are set to false, notification_enable must be set to false.
bind_notification_rule_id	String	Alarm action rule ID. If notification_enable is set to true, enter an alarm action rule ID. If notification_enable is set to false, enter "".
notify_resolved	Boolean	Whether to send a notification when an alarm is cleared. true: Send a notification. false: Do not send any notification.
notify_triggered	Boolean	Whether to send a notification when an alarm is triggered. true: Send a notification. false: Do not send any notification.
notify_frequency	Integer	Notification frequency. If the notification type is alarm_policy, set this parameter to -1. If the notification type is direct, set this parameter to any of the following: 0: alarm sent only once 300: every 5 minutes 600: every 10 minutes 900: every 15 minutes 1800: every 30 minutes 3600: every hour 10800: every 3 hours 21600: every 6 hours 43200: every 12 hours 86400: every day

**Table 8** AlarmTemplateSpecItem
Parameter	Type	Description
alarm_template_name	String	Name of an alarm rule in an alarm template.
alarm_template_name_en	String	Name of an alarm rule in an alarm template.
desc	String	Description of an alarm rule in an alarm template.
desc_en	String	Description of an alarm rule in an alarm template.
alarm_template_spec_type	String	Type of an alarm rule. metric: metric alarm rule. event: event alarm rule.
metric_alarm_template_spec	MetricAlarmTemplateSpec object	Metric alarm template.
event_alarm_template_spec	EventAlarmTemplateSpec object	Event alarm template.

**Table 9** MetricAlarmTemplateSpec
Parameter	Type	Description
alarm_subtype	String	Definition Alarm rule type. Range node_status: host status. node_resources: host resource. workloads: workload. cluster_status: cluster status. node_scaling: node pool status. static: multi-resource threshold. single: single-resource threshold. event: event.
alarm_source	String	Alarm source, for example, CCE.
monitor_type	String	Definition Monitoring type. Range resource all_metric promql
trigger_conditions	Array of TemplateTriggerCondition objects	Trigger condition.
no_data_conditions	Array of NoDataCondition objects	Action taken when data is insufficient.
alarm_tags	Array of AlarmTags objects	Alarm tag.
recovery_conditions	RecoveryCondition object	Alarm clearance condition.

**Table 10** TemplateTriggerCondition
Parameter	Type	Description
metric_query_mode	String	Metric query mode. AOM: native AOM. PROM: AOM Prometheus (metric query mode for a threshold alarm rule). NATIVE_PROM: native Prometheus (metric query mode for a PromQL alarm rule).
metric_namespace	String	Metric namespace.
metric_name	String	Metric name.
metric_unit	String	Metric unit.
metric_labels	Array of strings	Metric dimension.
promql	String	Prometheus statement.
promql_expr	String	Prometheus statement template.
trigger_times	Integer	Number of consecutive periods.
trigger_interval	String	Check interval. If trigger_type is set to HOURLY, set this parameter to "". If trigger_type* is set to DAILY, set 00:00–23:00. Example: 03:00. If trigger_type is set to WEEKLY, select a day in a week and then select 00:00–23:00. Example: 1 03:00" indicates 03:00 on every Monday. If trigger_type is set to CRON, specify a standard cron expression. If trigger_type is set to FIXED_RATE**, select 15s, 30s, 1–59 min, or 1–24 h.
trigger_type	String	Trigger frequency. Options: FIXED_RATE: fixed interval. HOURLY: every hour. DAILY: every day. WEEKLY: every week. CRON: cron expression.
promql_for	String	Duration. Options: 0: immediately. 15s: 15 seconds. 30s: 30 seconds. 1m: 1 minute.
aggregation_type	String	Detection rule. Options: average minimum maximum sum sampleCount
operator	String	Comparison operator. Options: >, <, =, >=, and <=.
thresholds	Map<String,String>	Key-value pair. The key indicates the alarm severity while the value indicates the alarm threshold.
aggregation_window	String	Statistical period. Options: 15s: 15 seconds. 30s: 30 seconds. 1m: 1 minute. 5m: 5 minutes. 15m: 15 minutes. 1h: 1 hour.
cmdb	CmdbInfo object	CMDB information.
query_match	String	Query filter criteria.
aom_monitor_level	String	Monitoring layer.
aggregate_type	String	Aggregation mode. by: not grouped avg max min sum
metric_statistic_method	String	Metric statistics method to be used when you set Configuration Mode to Select from all metrics during alarm rule setting. single: single metric mix: multi-metric combined operations
expression	String	Expression of a combined operation.
mix_promql	String	PromQL of a combined operation.
alarm_message_template	String	Notification content.
promql_monitor_templates	Array of strings	Prometheus monitoring template. Default: cluster.
query_param	Object	For a PromQL alarm rule, set this parameter to {"defaultRule":{"label":"custom","id":"custom"},"templateSelectd":null,"dimensionsList":[]}. For a threshold alarm rule, leave this parameter blank.

**Table 11** CmdbInfo
Parameter	Type	Description
app_id	String	Application ID.
node_ids	Array of NodeInfo objects	Node information list.

**Table 12** NodeInfo
Parameter	Type	Description
node_type	String	Node type.
node_id	String	Node ID.

**Table 13** NoDataCondition
Parameter	Type	Description
no_data_timeframe	Integer	Number of consecutive periods without data. Value range: 1–5. (If notify_no_data is set to true, this parameter is mandatory. If notify_no_data is set to false, leave this parameter blank.)
no_data_alert_state	String	Status of the threshold rule when the data is insufficient. (If notify_no_data is set to true, this parameter is mandatory. If notify_no_data is set to false, leave this parameter blank.) no_data: A notification indicating insufficient data is sent. alerting: An alarm is triggered. ok: No exception occurs. pre_state: Retain the previous state.
notify_no_data	Boolean	Whether to take action when no data is reported. true: Enable the function. false: Disable the function.

**Table 14** AlarmTags
Parameter	Type	Description
auto_tags	Array of strings	Automatic tag.
custom_tags	Array of strings	Custom tag.
custom_annotations	Array of strings	Alarm annotation.

**Table 15** RecoveryCondition
Parameter	Type	Description
recovery_timeframe	Integer	Number of consecutive periods for which the trigger condition is not met to clear an alarm. Value range: 1–3. (If recovery_timeframe is specified, this parameter is mandatory.)

**Table 16** EventAlarmTemplateSpec
Parameter	Type	Description
alarm_subtype	String	Alarm rule type.
alarm_source	String	Alarm source, for example, CCE.
event_source	String	Event source.
monitor_object_templates	Array of strings	Monitored object template. Currently, only clusterId is supported.
monitor_objects	Array of Map<String,String> objects	List of monitored objects. Key-value pair. event_type: notification type event_severity: alarm severity event_name: event name namespace: namespace clusterId: cluster ID customField: user-defined field
trigger_conditions	Array of EventTriggerCondition objects	Trigger condition.

**Table 17** EventTriggerCondition
Parameter	Type	Description
event_name	String	Event name.
trigger_type	String	Trigger mode. immediately: An alarm is triggered immediately if the alarm condition is met. accumulative: An alarm is triggered if the alarm condition is met for a specified number of times.
aggregation_window	Long	Monitoring period. Unit: second. For example, 3600 indicates 1 hour. If trigger_type is set to immediately, leave this parameter blank. If trigger_type is set to accumulative, this parameter is mandatory. Value range: 5 minutes, 20 minutes, 1 hour, 4 hours, or 24 hours.
operator	String	Operator. Options: >, <, =, >=, and <=. If trigger_type is set to immediately, leave this parameter blank. If trigger_type is set to accumulative, this parameter is mandatory.
thresholds	Map<String,Integer>	Key-value pair. The key indicates the alarm severity while the value indicates the number of accumulated trigger times. If trigger_type is set to immediately, the value is 1. If trigger_type is set to accumulative, the value ranges from 1 to 100. (This parameter is mandatory if trigger_conditions is specified.)
frequency	String	Event alarm notification frequency. If trigger_type is set to immediately, the value of this parameter is -1. -1: N/A. 0: alarm sent only once. 300: every 5 minutes. 600: every 10 minutes. 900: every 15 minutes. 1800: every 30 minutes. 3600: every hour. 10800: every 3 hours. 21600: every 6 hours. 43200: every 12 hours. 86400: every day.

**Table 18** Templating
Parameter	Type	Description
list	Array of TemplateInfo objects	Variable list.

**Table 19** TemplateInfo
Parameter	Type	Description
name	String	Variable name.
type	String	Definition Variable type. Range constant
query	String	Variable value.
description	String	Variable description.

Example Requests

Query the alarm template list.

https://{Endpoint}/v4/{project_id}/alarm-rules-template

Query the alarm template whose ID is 12142546931.

https://{Endpoint}/v4/{project_id}/alarm-rules-template?id=1214****2546****931

Example Responses

Status code: 200

OK: The request is successful.

{
  "alarm_rule_templates" : [ {
    "alarm_rule_template_binding" : { },
    "alarm_rule_template_id" : "130****1802****3121",
    "alarm_rule_template_name" : "aomTemplate",
    "alarm_rule_template_project_id" : "2a47****cca5****8373****1bff****",
    "alarm_rule_template_type" : "statics",
    "alarm_template_spec_list" : [ {
      "alarm_template_spec_items" : [ ],
      "related_cce_clusters" : [ ],
      "related_cloud_service" : "VPC",
      "related_prometheus_instances" : [ ]
    } ],
    "create_time" : 1732266984780,
    "enterprise_project_id" : "0",
    "modify_time" : 1732266984780
  } ],
  "count" : 119
}

SDK Sample Code

The SDK sample code is as follows.

Java

    
     
       
       
         package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.aom.v2.region.AomRegion;
import com.huaweicloud.sdk.aom.v2.*;
import com.huaweicloud.sdk.aom.v2.model.*;


public class ListAlarmRuleTemplateSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        AomClient client = AomClient.newBuilder()
                .withCredential(auth)
                .withRegion(AomRegion.valueOf("<YOUR REGION>"))
                .build();
        ListAlarmRuleTemplateRequest request = new ListAlarmRuleTemplateRequest();
        try {
            ListAlarmRuleTemplateResponse response = client.listAlarmRuleTemplate(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

        

      

    
   

Python

    
     
       
       
         # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkaom.v2.region.aom_region import AomRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkaom.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = AomClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(AomRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListAlarmRuleTemplateRequest()
        response = client.list_alarm_rule_template(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

        

      

    
   

Go

    
     
       
       
         package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    aom "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/aom/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/aom/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/aom/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := aom.NewAomClient(
        aom.AomClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListAlarmRuleTemplateRequest{}
	response, err := client.ListAlarmRuleTemplate(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

        

      

    
   

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

Status Codes

Status Code	Description
200	OK: The request is successful.

Error Codes

See Error Codes.

Parent topic: Alarm

Previous topic: Deleting an Alarm Template

Next topic: Adding a Message Template

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot