查询关键词告警规则 - ListKeywordsAlarmRules
功能介绍
该接口用于查询关键词告警。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
lts:alarmRule:listWordAlarmRule
List
-
-
-
-
URI
GET /v2/{project_id}/lts/alarms/keywords-alarm-rule
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 参数解释: 项目ID,可以从调用API处获取,也可以从控制台获取。获取方式请参见:获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数解释: 从IAM服务获取的用户Token,获取方式请参见:获取用户Token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
Content-Type | 是 | String | 参数解释: 用于定义消息体的格式,该字段填为:application/json;charset=utf8。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
keywords_alarm_rules | Array of KeywordsAlarmRuleRespList objects | 参数解释: 关键词告警规则ID。 |
参数 | 参数类型 | 描述 |
|---|---|---|
projectId | String | 参数解释: 项目ID。 取值范围: 不涉及。 |
keywords_alarm_rule_id | String | 参数解释: 关键词告警规则ID。 取值范围: 不涉及。 |
keywords_alarm_rule_name | String | 参数解释: 关键词告警规则名称。 取值范围: 不涉及。 |
keywords_alarm_rule_description | String | 参数解释: 关键词告警规则的简要描述。 取值范围: 不涉及。 |
condition_expression | String | 参数解释: 告警条件表达式。 取值范围: 不涉及。 |
keywords_requests | Array of KeywordsRequestResponse objects | 参数解释: 关键词告警规则信息。 |
frequency | FrequencyRespBody object | 参数解释: 关键词告警统计周期信息。 约束限制: 不涉及。 |
keywords_alarm_level | String | 参数解释: 关键词告警级别。 取值范围: |
domain_id | String | 参数解释: 账号ID,获取方式请参见:获取账号ID。 取值范围: 不涉及。 |
create_time | Long | 参数解释: 创建时间(毫秒时间戳)。 取值范围: 不涉及。 |
update_time | Long | 参数解释: 更新时间(毫秒时间戳)。 取值范围: 不涉及。 |
status | String | 参数解释: 关键词告警状态。 取值范围: |
trigger_condition_count | Integer | 参数解释: 告警触发条件:满足条件次数。 取值范围: 不涉及。 |
trigger_condition_frequency | Integer | 参数解释: 告警触发条件:统计周期次数。 取值范围: 不涉及。 |
whether_recovery_policy | Boolean | 参数解释: 是否配置告警恢复策略。 取值范围: |
recovery_policy | Integer | 参数解释: 告警恢复策略周期次数。 取值范围: |
notification_frequency | Integer | 参数解释: 关键词告警通知频率,单位(分钟)。 取值范围: 0、5、10、15、30、60、180、360 |
alarm_action_rule_name | String | 参数解释: 告警行动规则名称。 取值范围: 不涉及。 |
tags | Array of tagsResBody objects | 参数解释: 告警标签信息。标签是以键值对(key-value)的形式表示,key和value为一一对应关系。 |
参数 | 参数类型 | 描述 |
|---|---|---|
log_stream_id | String | 参数解释: 日志流ID,获取方式请参见:获取日志组ID和日志流ID。 取值范围: 不涉及。 |
log_stream_name | String | 参数解释: 日志流名称。 取值范围: 不涉及。 |
log_group_id | String | 参数解释: 日志组ID。 取值范围: 不涉及。 |
log_group_name | String | 参数解释: 日志组名称。 取值范围: 不涉及。 |
keywords | String | 参数解释: 在日志搜索能查到的日志关键字。 取值范围: 不涉及。 |
condition | String | 参数解释: 告警查询条件。 取值范围: <、- >、 <=、>= |
number | Integer | 参数解释: 告警匹配条数。 取值范围: 不涉及。 |
search_time_range | Integer | 参数解释: 查询执行告警任务时最近数据的时间范围。 取值范围: |
search_time_range_unit | String | 参数解释: 查询告警时间范围单位。 取值范围: |
custom_date | CustomDate object | 参数解释: 根据与告警执行时间的相对时间自定义告警查询时间区间。 约束限制: 不涉及。 |
is_time_range_relative | Boolean | 参数解释: 告警查询日志的时间区间为相对时间还是整点时间。 约束限制: 不涉及。 取值范围: 默认取值: true |
参数 | 参数类型 | 描述 |
|---|---|---|
start | Integer | 参数解释: 查询起始时间相对于告警计划执行时间的偏移量数值。 约束限制: 根据start_unit字段的单位将有不同的取值范围,根据单位将start换算为时间不超过1天。 取值范围: start_unit取值为second,start取值范围为 1-86400; start_unit取值为minute,start取值范围为 1-1440; start_unit取值为hour,start取值范围为 1-24。 默认取值: -无。 |
start_unit | String | 参数解释: 查询起始时间相对于告警计划执行时间的偏移量单位。 约束限制: 整点时间即is_time_range_relative为false时start_unit不支持second。 取值范围: 默认取值: minute |
end | Integer | 参数解释: 查询结束时间相对于告警计划执行时间的偏移量数值。 约束限制: 根据end_unit字段的单位将有不同的取值范围,根据单位将end换算为时间不超过1天; 取值范围: end_unit取值为second,end取值范围为 0-86399; end_unit取值为minute,end取值范围为 0-1439; end_unit取值为hour,end取值范围为 0-23。 默认取值: -无。 |
end_unit | String | 参数解释: 查询结束时间相对于告警计划执行时间的偏移量单位。 约束限制: 整点时间即is_time_range_relative为false时end_unit不支持second。 取值范围: 默认取值: minute |
参数 | 参数类型 | 描述 |
|---|---|---|
type | String | 参数解释: 告警统计周期类型。 取值范围: |
cron_expr | String | 参数解释: CRON表达式。当type取值为CRON时,返回该字段。CRON最小精度为分钟,格式为24小时制。 取值范围: 不涉及。 |
hour_of_day | Integer | 参数解释: 每天每小时。当type取值为DAILY或HOURLY时,返回该字段。 取值范围: 不涉及。 |
day_of_week | Integer | 参数解释: 每周。当type取值为WEEKLY时,返回该字段。 取值范围: 不涉及。 |
fixed_rate | Integer | 参数解释: 固定间隔。当type取值为FIXED_RATE时,返回该字段。 取值范围: 不涉及。 |
fixed_rate_unit | String | 参数解释: 固定间隔时间单位。 取值范围: |
状态码:500
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释: 错误码,请参见:错误码。 取值范围: 不涉及。 |
error_msg | String | 参数解释: 调用失败响应信息描述。 取值范围: 不涉及。 |
请求示例
查询关键词告警规则。
GET https://{endpoint}/v2/{project_id}/lts/alarms/keywords-alarm-rule
/v2/{project_id}/lts/alarms/keywords-alarm-rule 响应示例
状态码:200
请求响应成功。
{
"keywords_alarm_rules" : [ {
"projectId" : "string",
"keywords_alarm_rule_id" : "string",
"keywords_alarm_rule_name" : "string",
"keywords_alarm_rule_description" : "string",
"condition_expression" : "string",
"keywords_requests" : [ {
"log_stream_id" : "string",
"log_stream_name" : "string",
"log_group_id" : "string",
"log_group_name" : "string",
"keywords" : "string",
"condition" : ">=",
"number" : 1,
"search_time_range" : 0,
"search_time_range_unit" : "minute"
} ],
"frequency" : {
"type" : "CRON",
"cron_expr" : "string",
"hour_of_day" : 0,
"day_of_week" : 0,
"fixed_rate" : 0,
"fixed_rate_unit" : "minute"
},
"keywords_alarm_level" : "Info",
"domain_id" : "string",
"create_time" : 0,
"update_time" : 0,
"status" : "RUNNING",
"trigger_condition_count" : "1",
"trigger_condition_frequency" : "1",
"whether_recovery_policy" : false,
"recovery_policy" : "3",
"notification_frequency" : 5,
"alarm_action_rule_name" : ""
} ]
} 状态码:500
表明服务端能被请求访问到,但是服务内部出错。
{
"error_code" : "LTS.2008",
"error_msg" : "Find Alarm rule failed."
} 状态码
状态码 | 描述 |
|---|---|
200 | 请求响应成功。 |
500 | 表明服务端能被请求访问到,但是服务内部出错。 |
错误码
请参见错误码。

