【已评审】支持电源输出电压调压功能接口评审

Interface SIG Interface评审
1

背景

当前为提高服务器整机的供电转换效率，达成节能目标，需要提供接口设置、查询电源输出电压调压功能。

关联ISSUE

支持电源输出电压调压能力

整体方案

1、在已有资源协作路径/bmc/kepler/Chassis/:ChassisId/PowerSubsystem下新增接口bmc.kepler.Chassis.PowerSubsystem.PSUStrategy接口，用于电源策略相关属性和方法的挂载；
2、bmc.kepler.Chassis.PowerSubsystem.PSUStrategy接口下新增OutputVoltageAdjustmentEnabled表示电源输出电压调压功能使能状态，新增OutputVoltageAdjustmentSupported表示是否支持电源输出电压调压功能；
3、新增Web接口允许客户设置和查询电源输出电压调压功能使能状态；

评审点

1、 新增资源协作接口bmc.kepler.Chassis.PowerSubsystem.PSUStrategy和属性OutputVoltageAdjustmentEnabled表示电源输出电压调压功能使能状态、OutputVoltageAdjustmentSupported表示是否支持电源输出电压调压功能；
2、web GET接口/UI/Rest/System/PowerSupply新增属性OutputVoltageAdjustmentSupported表示是否支持电源输出电压调压功能、OutputVoltageAdjustmentEnabled表示电源输出电压调压功能使能状态；
3、web PATCH接口/UI/Rest/System/PowerSupply新增属性OutputVoltageAdjustmentEnabled，设置电源输出电压调压功能使能；

详细描述

评审点1：新增资源协作接口bmc.kepler.Chassis.PowerSubsystem.PSUStrategy

接口描述 ：整机电源策略接口，用于挂载电源策略的属性和方法

新增属性

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性
OutputVoltageAdjustmentSupported b True false 表示是否支持电源输出电压调压功能,默认值为false Read: ReadOnly CSR / false
OutputVoltageAdjustmentEnabled b False true 表示电源输出电压调压功能的使能状态，默认值为false Read:
ReadOnly
Write:
PowerMgmt		 代码 掉电持久化 false

评审点2、web GET接口新增属性OutputVoltageAdjustmentSupported、OutputVoltageAdjustmentEnabled

资源URI：/UI/Rest/System/PowerSupply
变化类型 ：新增属性
操作类型：GET
操作权限：ReadOnly
应用场景 ：获取电源输出电压调压功能是否支持和使能状态
输出参数：

参数名 类型 示例/取值约束 描述
OutputVoltageAdjustmentSupported bool true: 支持电源输出电压调压能力
false: 不支持电源输出电压调压能力
默认取值：false		 表示是否支持电源输出电压调压功能
OutputVoltageAdjustmentEnabled bool true: 电源调压功能开启
false: 电源调压功能关闭
默认取值：false		 电源输出电压调压使能状态

请求样例：

GET /UI/Rest/System/PowerSupply
请求头：
Content-Type: header_type 
Cookie: SessionId=session_id_value
请求消息体：无
响应样例：
{
    "DeepSleep": "Off",
    "PowerMode": "Sharing",
    "NormalAndRedundancy": "Disabled",
    ......
    "OutputVoltageAdjustmentSupported": true,
    "OutputVoltageAdjustmentEnabled": false
}
响应码：200

评审点3、web PATCH接口新增属性OutputVoltageAdjustmentEnabled

资源URI：/UI/Rest/System/PowerSupply
变化类型 ：新增属性
操作类型：PATCH
操作权限：PowerMgmt
应用场景 ：电源输出电压调压使能
输入参数：

参数名 类型 必填 示例/取值约束 描述
OutputVoltageAdjustmentEnabled bool 否 true: 电源调压功能开启
false: 电源调压功能关闭		 电源输出电压调压使能

请求样例:

PATCH /UI/Rest/System/PowerSupply
请求头：
Content-Type: header_type 
X-CSRF-Token: auth_value 
Cookie: SessionId=session_id_value
请求消息体：
{ 
 "OutputVoltageAdjustmentEnabled": true
}
响应样例：
{
    "DeepSleep": "Off",
    "PowerMode": "Sharing",
    "NormalAndRedundancy": "Disabled",
    ......
    "OutputVoltageAdjustmentSupported": true,
    "OutputVoltageAdjustmentEnabled": true
}
响应码：200

是否准备好AI预审

是

评审结论

1、同意新增资源协作接口bmc.kepler.Chassis.PowerSubsystem.PSUStrategy和属性OutputVoltageAdjustmentEnabled表示电源输出电压调压功能使能状态、OutputVoltageAdjustmentSupported表示是否支持电源输出电压调压功能，OutputVoltageAdjustmentSupported属性为只读，操作权限为ReadOnly，OutputVoltageAdjustmentEnabled属性为可读可写，操作权限为读：ReadOnly，写：PowerMgmt；
2、同意webrest接口 /UI/Rest/System/PowerSupply Get操作新增属性OutputVoltageAdjustmentSupported、OutputVoltageAdjustmentEnabled，操作权限ReadOnly；
3、同意webrest接口 /UI/Rest/System/PowerSupply PATCH操作新增属性OutputVoltageAdjustmentEnabled，操作权限PowerMgmt；

遗留问题

1、webui功能开关中文描述去掉“电源”；— 已去除
2、是否存在产品支持，电源本身不支持的情况；— 整机电源输出电压调压策略支持，但是电源不支持的情况可能会出现，这种属于产品配置异常，在代码内部做校验拦截，不会使能电源输出电压调压功能；
3、考虑提供导入导出项；— 需要做电源输出电压调压功能使能状态OutputVoltageAdjustmentEnabled配置导入导出，已报名评审