查询告警规则模板列表(Beta)
功能介绍
该接口用于查询告警规则模板列表。(该接口在邀测中,受限开放,如有需求可以通过提交工单提申请开放此接口。)
调用方法
请参见如何调用API。
URI
GET /v4/{project_id}/alarm-rules-template
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户从IAM申请到的projectid,一般为32位字符串。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
否 |
String |
告警规则模板id。 |
type |
否 |
String |
告警规则模板类型。
|
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token。 |
Content-Type |
是 |
String |
指定类型为application/json。 |
Enterprise-Project-Id |
否 |
String |
企业项目id。
|
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
alarm_rule_templates |
Array of AlarmRuleTemplateBody objects |
告警规则模板列表。 |
count |
Integer |
告警规则模板总数。 |
参数 |
参数类型 |
描述 |
---|---|---|
alarm_rule_template_name |
String |
告警规则模板名称。 |
alarm_rule_template_name_en |
String |
告警规则模板英文名称。 |
alarm_rule_template_description |
String |
告警规则模板描述。 |
alarm_rule_template_id |
String |
告警规则模板id。 |
alarm_rule_template_project_id |
String |
租户从IAM申请到的projectid,一般为32位字符串。 |
alarm_rule_template_type |
String |
告警规则模板类型
|
alarm_rule_template_source |
String |
告警规则模板来源。 |
alarm_rule_template_binding |
Map<String,String> |
告警规则模板所绑定的告警规则。 |
alarm_template_spec_list |
Array of AlarmRuleTemplateSpecWithCloudService objects |
告警模板规则列表。 |
enterprise_project_id |
String |
企业项目id。 |
create_time |
Long |
创建时间。 |
modify_time |
Long |
更新时间。 |
templating |
Templating object |
告警规则模板变量列表。 |
template_version |
String |
告警规则模板版本。 |
参数 |
参数类型 |
描述 |
---|---|---|
related_cloud_service |
String |
关联的云服务。 |
related_cce_clusters |
Array of strings |
关联的CCE集群。 |
related_prometheus_instances |
Array of strings |
关联的Prom实例。 |
alarm_notification |
AlarmNotification object |
通知信息。 |
alarm_template_spec_items |
Array of AlarmTemplateSpecItem objects |
告警模板列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
notification_type |
String |
通知类型。
枚举值:
|
route_group_enable |
Boolean |
启用分组规则。
说明:
如果告警触发“notify_triggered”或告警恢复“notify_resolved”都设置为false(即都不进行告警通知),则route_group_enable需设置为false。 枚举值:
|
route_group_rule |
String |
分组规则名称。
|
notification_enable |
Boolean |
是否启用告警行动规则。
说明:
如果告警触发“notify_triggered”或告警恢复“notify_resolved”都设置为false(即都不进行告警通知),则notification_enable需设置为false。 |
bind_notification_rule_id |
String |
告警行动策略id。
|
notify_resolved |
Boolean |
告警解决是否通知。
枚举值:
|
notify_triggered |
Boolean |
告警触发是否通知。
枚举值:
|
notify_frequency |
Integer |
通知频率
|
参数 |
参数类型 |
描述 |
---|---|---|
alarm_template_name |
String |
告警规则模板下单个告警规则名称。 |
alarm_template_name_en |
String |
告警规则模板下单个告警规则英文名称。 |
desc |
String |
告警规则模板下单个告警规则描述。 |
desc_en |
String |
告警规则模板下单个告警规则英文描述。 |
alarm_template_spec_type |
String |
告警规则模板下单个告警规则类型。 “metric”:指标告警 “event”:事件告警 |
metric_alarm_template_spec |
MetricAlarmTemplateSpec object |
指标告警模板。 |
event_alarm_template_spec |
EventAlarmTemplateSpec object |
事件告警模板。 |
参数 |
参数类型 |
描述 |
---|---|---|
alarm_subtype |
String |
告警规则类别。 |
alarm_source |
String |
告警规则来源云服务:CCE 创建标识。 |
monitor_type |
String |
监控类型。 |
trigger_conditions |
Array of TemplateTriggerCondition objects |
触发条件。 |
no_data_conditions |
Array of NoDataCondition objects |
数据不足条件。 |
alarm_tags |
Array of AlarmTags objects |
告警标签。 |
recovery_conditions |
RecoveryCondition object |
告警恢复条件。 |
参数 |
参数类型 |
描述 |
---|---|---|
metric_query_mode |
String |
指标查询模式。
枚举值:
|
metric_namespace |
String |
指标命名空间。 |
metric_name |
String |
指标名称。 |
metric_unit |
String |
指标单位。 |
metric_labels |
Array of strings |
指标维度。 |
promql |
String |
Prometheus语句。 |
promql_expr |
Array of strings |
Prometheus语句模板。 |
trigger_times |
String |
连续周期个数。 |
trigger_interval |
String |
检查频率周期。
|
trigger_type |
String |
触发频率的类型:
枚举值:
|
promql_for |
String |
Prometheus原生监控时长。 |
aggregation_type |
String |
统计方式:
|
operator |
String |
判断条件:“>”,“<”,“=”,“>=”,“<=” |
thresholds |
Map<String,String> |
键值对形式,键为告警级别,值为告警阈值 |
aggregation_window |
String |
统计周期。
|
cmdb |
CmdbInfo object |
cmdb信息。 |
query_match |
String |
查询筛选条件。 |
aom_monitor_level |
String |
监控层级。 |
aggregate_type |
String |
聚合方式。
枚举值:
|
metric_statistic_method |
String |
当配置方式为全量指标时可选择的指标运算方式。
枚举值:
|
expression |
String |
混合运算的表达式。 |
mix_promql |
String |
混合运算的promQL。 |
参数 |
参数类型 |
描述 |
---|---|---|
no_data_timeframe |
Integer |
无数据周期的个数。 |
no_data_alert_state |
String |
数据不足时,阈值规则的状态。
枚举值:
|
notify_no_data |
Boolean |
数据不足是否通知。 |
参数 |
参数类型 |
描述 |
---|---|---|
auto_tags |
Array of strings |
自动标签。 |
custom_tags |
Array of strings |
自定义标签。 |
custom_annotations |
Array of strings |
告警标注。 |
参数 |
参数类型 |
描述 |
---|---|---|
alarm_subtype |
String |
告警规则类别。 |
alarm_source |
String |
告警规则来源云服务:CCE 创建标识。 |
event_source |
String |
告警来源。 |
monitor_object_templates |
Array of strings |
监控对象模板(创建告警时需要补齐里面的内容)。 |
monitor_objects |
Array of Map<String,String> objects |
监控对象列表。键值对形式,键值为:
|
trigger_conditions |
Array of EventTriggerCondition objects |
触发条件。 |
参数 |
参数类型 |
描述 |
---|---|---|
event_name |
String |
事件名称。 |
trigger_type |
String |
触发方式:
枚举值:
|
aggregation_window |
Long |
统计周期。单位为秒,例如 1小时 填“3600”,当trigger_type为“immediately”时 不填。 |
operator |
String |
判断条件:“>”,“<”,“=”,“>=”,“<=”,当trigger_type为“immediately”时 不填。 |
thresholds |
Map<String,Integer> |
键值对形式,键为告警级别,值为累计次数,当trigger_type为“immediately”时 值为空。 |
frequency |
String |
事件类告警频率。当trigger_type为“immediately”时 不填。
|
请求示例
-
查询告警规则列表
https://{Endpoint}/v4/{project_id}/alarm-rules-template
-
查询告警规则模板id为12142546931的告警规则模板
https://{Endpoint}/v4/{project_id}/alarm-rules-template?id=1214****2546****931
响应示例
状态码: 200
OK 请求响应成功。
{ "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 }
状态码
状态码 |
描述 |
---|---|
200 |
OK 请求响应成功。 |
错误码
请参见错误码。