【已评审】webrest需要新增属性Position显示电源位置

issue链接

背景

在web新增属性显示电源所在的位置

现状

当前webrest接口没有属性指示电源位置,而redfish接口由Position属性指示电源位置

决策点

webrest接口新增属性,支持查询电源位置查询

详细描述

1)webrest接口新增属性
URL:UI/Rest/System/PowerSupply
变化类型:"SupplyList"对象新增Position属性
操作类型: GET
应用场景:在多框电源的场景下,由web显示该属性到页面上为“位置”

属性名称 取值类型 说明 取值范围 默认值 操作权限 约束
Position string 电源所处位置 NA NA ReadOnly 电源不在位时为null

{

“SupplyList”: [
{

“Position”:“PowerShelf1”

},

],

“RecommendedPowerMode”: null
}
如下图所示,电源信息显示读取信息根据PoweringChassis显示到页面上为位置:PoweringChassis1

评审结论

同意在webrest接口/UI/Rest/System/PowerSupply的“SupplyList”里面新增如下属性:
属性名称:Position
类型:string
读写&权限:只读,ReadOnly
说明:电源所处位置
取值范围:NA
默认值:NA
约束:电源不在位时为null

遗留问题及确认结论
1、确认字符串是否可能为空,以及字符串的长度范围
结论:电源在位时,CSR中如果没有配置该属性,则资源协作接口属性值为“”, webrest接口属性值也为“”,电源不在位时,webrest接口属性取值null;字符串当前长度没有限制。