新增资源树协作接口方法查询当前所有告警的指定字段内容

背景

当前告警查询接口 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预审

评审结论

(必选)针对决策点,详细描述最终结论,不能是简单的同意或不同意,通过或不通过。(提交议题时删除此引导说明)

遗留问题