获取设备告警列表
功能介绍
获取设备告警列表
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/{project_id}/alarm-manager/alarms
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
查询的起始位置,取值范围为非负整数,默认为0 |
|
limit |
否 |
Integer |
每页显示的条目数量,取值范围1~100,默认为100 |
|
device_id |
否 |
String |
设备ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
租户Token。获取方法请参见获取Token |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
满足条件的设备告警总数 |
|
data |
Array of GetDeviceAlarmArrayObject objects |
设备告警实体列表 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
设备告警记录ID |
|
name |
String |
设备告警名称 |
|
alarm_id |
Integer |
设备告警ID |
|
level |
String |
设备告警等级,紧急告警(critical),严重告警(major),一般告警(minor) |
|
platform |
String |
设备平台 |
|
impact |
String |
设备告警的影响 |
|
detail |
String |
设备告警详情内容 |
|
reason |
String |
设备告警原因 |
|
deal_suggestion |
String |
设备告警处理建议 |
|
create_time |
Long |
创建时间(时间戳) |
请求示例
无
响应示例
状态码: 200
获取设备告警列表成功
{
"total" : 0,
"data" : [ {
"id" : "6b0e806f35c2470a825da1f1ab05caf5",
"name" : "安装在设备HiLens_69上的技能test-unzip异常且无法恢复",
"alarm_id" : 5,
"level" : "critical",
"platform" : "hilens",
"impact" : "业务中断",
"detail" : "多次尝试恢复技能均失败",
"reason" : "技能10分钟内退出就会被认为是异常退出",
"deal_suggestion" : "查看Log分析原因",
"create_time" : 1636451227616
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
获取设备告警列表成功 |
|
500 |
服务内部错误 |
错误码
请参见错误码。