背景
当前告警查询接口 GetAlarmList 返回完整告警对象,字段较多。部分业务场景仅需要获取当前所有告警中的单一字段,例如 LED 显示故障码 LedFaultCode。拟在已有资源协作接口 bmc.kepler.Systems.Events 下新增只读方法 GetAlarmSpecifiedFields。
关联ISSUE
暂无
整体方案
在已有接口 bmc.kepler.Systems.Events 中新增方法 GetAlarmSpecifiedFields。该方法接收字段名称 EventFieldName,根据枚举值查询当前告警列表中的对应字段,并返回去重后的字符串数组 EventFieldValues。
实现上复用事件模块已有当前告警查询能力 get_alarm_list_before_format,避免重复实现告警过滤、告警状态判断、语言查询、严重等级过滤等逻辑。方法内部只做字段抽取、空值过滤和去重处理,不改变现有 GetAlarmList、GetEventList 等接口行为。
评审点
| 项目 | 内容 |
|---|---|
| 接口变更类型 | 新增方法 |
| 方法名称 | GetAlarmSpecifiedFields |
| 方法描述 | 查询当前所有告警的指定字段内容 |
| 访问权限 | ReadOnly |
| 是否新增路径 | 否 |
| 是否新增属性 | 否 |
| 是否新增信号 | 否 |
| 是否新增错误消息 | 否,非法枚举值复用 PropertyValueError(EventFieldName) |
详细描述
- `场景1:查询当前所有告警的指定字段内容
| 方法名称 | 请求签名 | 请求参数描述 | 响应签名 | 响应参数描述 | 方法描述 | 访问权限 |
|---|---|---|---|---|---|---|
| GetAlarmSpecifiedFields | s | Param1: EventFieldName,表示待查询的告警字段名称,当前仅支持LedFaultCode。 | as | Param1: EventFieldValues,表示当前所有告警指定字段内容列表,返回字符串数组,重复字段值仅返回一次。 | 查询当前所有告警的指定字段内容。 | ReadOnly |
是否准备好AI预审
否
评审结论
(必选)针对决策点,详细描述最终结论,不能是简单的同意或不同意,通过或不通过。(提交议题时删除此引导说明)