会议质量告警信息查询接口用于获取会议质量类型的告警列表,支持分页查询和多维度过滤。
默认接口请求频率限制:20次/秒
REST URL
GET /api/rest/external/v1/ops/meeting/quality/alert/query?enterpriseId=xxx&alarmLevel=xxx&alarmStatus=xxx&startTime=xxxx&endTime=xxxx&pageIndex=0&pageSize=20
请求参数说明
参数 | 参数类型 | 参数位置 | 是否必须 | 默认值 | 说明 | 初始平台 |
enterpriseId | String | Query | 是 | 无 | 企业ID,通过管理平台-云视讯API获得 | 分区云5.2-20260327 公有云不存在 |
pageIndex | int | Query | 否 | 0 | 页码,默认为0 | 分区云5.2-20260327 公有云不存在 |
pageSize | int | Query | 否 | 20 | 每页大小,默认为20,最大不能超过100 | 分区云5.2-20260327 公有云不存在 |
startTime | Long | Query | 否 | 今天 00:00 | 时间戳,最大查询 7 天 | 分区云5.2-20260327 公有云不存在 |
endTime | Long | Query | 否 | 当前时间 | 时间戳 | 分区云5.2-20260327 公有云不存在 |
alarmLevel | String | Query | 否 | 无 | 告警级别。 1:一级告警,2:二级告警,3:三级告警。一级是严重告警 | 分区云5.2-20260327 公有云不存在 |
alarmStatus | String | Query | 否 | 无 | 状态。已触发: on。已恢复:off | 分区云5.2-20260327 公有云不存在 |
返回结果示例:
成功时返回200,失败时返回小鱼RESTAPI错误码
{
"page": 1,
"pageTotal": 5,
"rowsTotal": 100,
"rows": 20,
"list": [
{
"ruleName": "sdk_record",
"alarmLevel": 1,
"alarmType": "meeting_quality",
"alarmSource": [
{
"name": "云会议室",
"value": "欧子豪的会议室"
},
{
"name": "云会议室号",
"value": "4277526602"
},
{
"name": "应用ID(clientID)",
"value": "MGxl9CImAXnfKmCSBzsSmTx9"
},
{
"name": "应用名称",
"value": "xvcvxcvcxv-------"
}
],
"alarmRule": {
"rules": [
"整体音频质量:中",
"整体会议视频质量:差"
],
"duration": 300,
"percent": 80,
"frequency": 60
},
"alarmStatus": "off",
"firstAlarmTimestamp": 1765336700000,
"alarmTimestamp": 1765336900000
}
]
}成功时返回结果数据,失败时返回小鱼RESTAPI错误码
返回参数说明
参数名称 | 说明 |
ruleName | 规则名称 |
alarmLevel | 告警级别(1=严重,2=警告,3=提示) |
alarmType | 告警类型:resource_alarm(资源告警),meeting_quality(会议质量),device_quality(终端质量),event_alarm(事件告警),device_performance(设备质量) |
alarmSource | 告警来源 |
└name | 来源名称 |
└value | 来源值 |
alarmRule | 告警规则 |
└duration | 持续时长,单位秒 |
└percent | 终端占会议室比例 |
└frequency | 抑制时间,单位秒 |
alarmStatus | 告警状态("on"触发,"off"恢复) |
firstAlarmTimestamp | 首次触发时间(Unix毫秒时间戳) |
alarmTimestamp | 最近触发时间(Unix毫秒时间戳) |