查询告警列表
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/alarm-history-record
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
|
start_time |
是 |
String |
参数解释: 查询开始时间。 约束限制: 不涉及。 取值范围: 格式为“yyyy-mm-ddThh:mm:ssZ”。其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。最多可以获取最近7天的数据。 默认取值: 不涉及。 |
|
level |
否 |
Integer |
参数解释: 实例告警等级。 约束限制: 不涉及。 取值范围:
默认取值: 1 |
|
limit |
是 |
Integer |
参数解释: 查询记录数。例如该参数设定为10,则查询结果最多只显示10条记录。 约束限制: 不涉及。 取值范围: [1, 50] 默认取值: 50 |
|
offset |
是 |
Integer |
参数解释: 索引位置,偏移量。从第一条数据偏移offset条数据后开始查询。例如:该参数指定为1,limit指定为10,则只展示第2-11条数据。 约束限制: 不涉及。 取值范围: [0, 2^31-1] 默认取值: 默认为0(偏移0条数据,表示从第一条数据开始查询)。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
X-Language |
否 |
String |
参数解释: 语言。 约束限制: 不涉及。 取值范围:
默认取值: en-us |
响应参数
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total_count |
Integer |
参数解释: 总数量。 取值范围: 不涉及。 |
|
history_records |
Array of 表4 objects |
参数解释: 告警记录列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
alarm_id |
String |
参数解释: 告警规则ID。 取值范围: 不涉及。 |
|
name |
String |
参数解释: 告警规则名称。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 告警记录的状态。 取值范围:
|
|
alarm_type |
String |
参数解释: 告警规则类型。 取值范围:
|
|
level |
Integer |
参数解释: 告警历史的告警级别。 取值范围:
|
|
instance_id |
String |
参数解释: 实例ID。 取值范围: 只能由英文字母、数字组成,且长度为36个字符。 |
|
instance_name |
String |
参数解释: 实例名称。 取值范围: 不涉及。 |
|
begin_time |
Long |
参数解释: 告警开始时间。 取值范围: UNIX时间戳,单位毫秒,例如:1603131199000。 |
|
update_time |
Long |
参数解释: 告警状态变更的时间。 取值范围: UNIX时间戳,单位毫秒,例如:1603131199000。 |
请求示例
查询告警列表。
GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/9a29cc53af2f499cb48a6d81839264cb/alarm-history-record?start_time=2022-06-22T16:38:02%2B0800&offset=0&limit=100
响应示例
{
"total_count": 1,
"history_records": [
{
"alarm_id": "al1603131199286dzxpqK3Ez",
"name": "磁盘资源不足",
"status": "alarm",
"alarm_type": "EVENT.SYS",
"level": "1",
"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin14",
"instance_name": "gauss_test",
"begin_time": "1603131199000",
"update_time": "1603131199000"
}
]
}
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。