【已评审】支持资源协作接口设置门限传感器属性

背景

  • 当前部分装备测试活动会调试传感器读值关联的业务组件,导致传感器读值变更进而触发门限产生告警
  • 此测试阶段的告警导致告警灯闪烁,给生产人员带来误解,因此需要在测试阶段临时修改传感器门限,避免误告警
  • 传感器的门限通常是固定值,并且由于资源协作接口是只读的,无法直接修改,因此需要新增资源协作接口,用于设置传感器属性
  • 由于测试活动结束后会自动复位,即此设置不需要持久化

关联ISSUE

[需求]: 支持资源协作接口设置门限传感器的门限告警值 sensor #52

整体方案

提供资源协作接口方法,设置指定传感器的门限值。

评审点

评审点1:新增设置门限传感器属性接口SetThresholds

path(已有): /bmc/kepler/Chassis/:chassisId/Sensors
interface(已有): bmc.kepler.Chassis.Sensors
method(新增): SetThresholds

新增方法详情如下:

项目 说明
方法名 SetThresholds
方法描述 设置指定门限传感器的门限属性
权限 BasicSetting
请求签名 sya{ss}
请求说明 SensorName:签名为 s,表示需要修改的传感器名称
注意: 传感器名称如果有重复则修改以第一个为准
PersistenceType:签名为 y,表示设置的持久化类型,取值有:
 0:不持久化
 1:掉电持久化
Attributes:签名为 a{ss},表示需要修改的传感器属性与取值,支持同时设置多个,其中字典的 key 值包括:
 UpperNonrecoverable:传感器紧急事件上限
 UpperCritical:传感器严重事件上限
 UpperNoncritical:传感器一般事件上限
 LowerNonrecoverable:传感器紧急事件下限
 LowerNoncritical:传感器严重事件下限
 LowerCritical:传感器一般事件下限
注意: 门限属性值均为双精度类型的数字字符串,取值精度为 3 位小数格式,例如1.000
响应签名
响应说明 无响应,如果设置错误,则进行 error 报错处理

评审结论

通过,同意在资源协作接口 bmc.kepler.Chassis.Sensors 下新增方法 SetThresholds,表征设置指定门限传感器的门限值,方法操作权限为 BasicSetting;方法请求签名为 sya{ss},请求参数说明见议题;方法无响应,设置处理失败时进行 error 报错。

遗留问题