背景
为支持该redfish接口实现，新增资源协作接口
关联ISSUE
[需求]: redfish 支持PowerEquipment/PowerDistribution资源
评审点
1.新增PowerDistribution相关资源协作接口
2.新增资源协作接口：bmc.kepler.Chassis.PowerSubsystem.PowerSupplies.Metrics
详细描述
评审点1：新增PowerEquipment相关资源协作接口
path (新增）：/bmc/kepler/PowerEquipment/PowerDistribution/:Id
interface（新增）：bmc.kepler.PowerEquipment.PowerDistribution
| 属性名称 | 变化类型 | 签名 | 默认值 | 读写&权限 | 持久化 | 变化通知 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|---|
| EquipmentType | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 设备类型"RackPDU",“FloorPDU”,“Switchgear”,“PowerShelf”,“AutomaticTransferSwitch”,"ManualTransferSwitch ",“” | |
| AssetTag | 新增属性 | s | “” | R:ReadOnly W:PowerMgmt | 无 | false | 资产标签minLength: 1 maxLength: 20 | |
| FirmwareVersion | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 固件版本 | |
| Manufacturer | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 制造商 | |
| Model | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 设备产品型号 | |
| PartNumber | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 设备部件号 | |
| PowerCapacityVA | 新增属性 | u | 0xFFFFFFFF | R:ReadOnly W:无 | 无 | false | 功率容量VA | |
| ProductionDate | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 设备生产日期。时间格式"YYYY-MM-DDThh:mm:ssZ" | |
| SerialNumber | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 设备序列号 | |
| UserLabel | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 用户标签minLength: 1 maxLength: 20 | |
| UUID | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | UUID | |
| Version | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 设备的硬件版本 | |
| Health | 新增属性 | y | 0 | R:ReadOnly W:无 | 无 | true | 健康状态，取值为0：Normal，1：Minor，2：Major，3：Critical | |
| LocationServiceLabel | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 服务标签 | |
| LocationOrdinalValue | 新增属性 | y | 0XFF | R:ReadOnly W:无 | 无 | false | 位置序号值 | |
| LocationOrientation | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 方向"BackToFront",“BottomToTop”,“FrontToBack”,“LeftToRight”,“RightToLeft”,“TopToBottom”,“” | |
| LocationType | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 位置类型 “Backplane”,“Bay”,“Connector”,“Embedded”,“Slot”,“Socket” ,“” | |
| LocationReference | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 参考位置"Top",“Bottom”,“Front”,“Rear”,“Left”,“Right”,“Middle”,“” |
评审点2：新增 TransferConfig 相关资源协作接口属性和方法
interface（新增）：bmc.kepler.PowerEquipment.PowerDistribution.TransferConfig
| 方法名称 | 变化类型 | 请求签名 | 响应签名 | 权限 | 持久化 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|
| TransferControl | 新增方法 | 无 | 无 | PowerMgmt | 无 | 将电源输入从现有市电电路转移到备用市电电路 |
| 属性名称 | 变化类型 | 签名 | 默认值 | 读写&权限 | 持久化 | 变化通知 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|---|
| ActiveMainsId | 新增属性 | s | “” | R:ReadOnly W:PowerMgmt | 无 | false | 当前活动的主电源ID | |
| AutoTransferEnabled | 新增属性 | b | false | R:ReadOnly W:PowerMgmt | 无 | false | 是否启用自动转移 | |
| ClosedTransitionAllowed | 新增属性 | b | false | R:ReadOnly W:PowerMgmt | 无 | false | 是否允许关闭过渡 | |
| ClosedTransitionTimeoutSeconds | 新增属性 | u | 0xFFFFFFFF | R:ReadOnly W:PowerMgmt | 无 | false | 关闭过渡超时时间(秒) | |
| PreferredMainsId | 新增属性 | s | “” | R:ReadOnly W:PowerMgmt | 无 | false | 首选主电源ID | |
| RetransferDelaySeconds | 新增属性 | u | 0xFFFFFFFF | R:ReadOnly W:PowerMgmt | 无 | false | 重新传输延迟时间(秒) | |
| RetransferEnabled | 新增属性 | b | false | R:ReadOnly W:PowerMgmt | 无 | false | 是否启用重新传输 | |
| TransferDelaySeconds | 新增属性 | u | 0xFFFFFFFF | R:ReadOnly W:PowerMgmt | 无 | false | 转移延迟时间(秒) | |
| TransferInhibit | 新增属性 | b | false | R:ReadOnly W:PowerMgmt | 无 | false | 是否禁止转移 | |
| OverNominalFrequencyHz | 新增属性 | d | 0 | R:ReadOnly W:PowerMgmt | 无 | false | 超过额定频率Hz | |
| OverVoltageRMSPercent | 新增属性 | y | 0xFF | R:ReadOnly W:PowerMgmt | 无 | false | 超过额定电压RMS百分比 | |
| TransferSensitivity | 新增属性 | s | “” | R:ReadOnly W:PowerMgmt | 无 | false | 传输灵敏度"Low", “Medium”, “High”,“” | |
| UnderNominalFrequencyHz | 新增属性 | d | 0 | R:ReadOnly W:PowerMgmt | 无 | false | 低于额定频率Hz | |
| UnderVoltageRMSPercent | 新增属性 | y | 0xFF | R:ReadOnly W:PowerMgmt | 无 | false | 低于额定电压RMS百分比 |
评审点3：新增 PowerDistribution.Metrics 相关资源协作接口和属性
interface（新增）：bmc.kepler.PowerEquipment.PowerDistribution.Metrics
| 方法名称 | 变化类型 | 请求签名 | 响应签名 | 权限 | 持久化 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|
| ResetMetrics | 新增方法 | 无 | PowerMgmt | 无 | 重置采集的历史数据，重置之后重新开始采集 |
| 属性名称 | 变化类型 | 签名 | 默认值 | 读写&权限 | 持久化 | 变化通知 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|---|
| AbsoluteHumidity | 新增属性 | d | -1 | R:ReadOnly W:无 | 无 | false | 绝对湿度(g/m^3) | |
| EnergyApparentkVAh | 新增属性 | d | -1 | R:ReadOnly W:无 | 无 | false | 视在电能(kVAh) | |
| EnergyLifetimekWh | 新增属性 | d | -1 | R:ReadOnly W:无 | 无 | false | 能耗的总累积值(kWh) | |
| EnergyReactivekVARh | 新增属性 | d | -1 | R:ReadOnly W:无 | 无 | false | 无功电能(kVARh) | |
| EnergykWh | 新增属性 | d | -1 | R:ReadOnly W:无 | 无 | false | 能耗(kWh) | |
| EnergySensorResetTime | 新增属性 | s | “” | R:ReadOnly W:无 | 无 | false | 上次重置基于时间的属性的日期和时间。时间格式"YYYY-MM-DDThh:mm:ssZ" | |
| HumidityPercent | 新增属性 | y | 0xFF | R:ReadOnly W:无 | 无 | false | 湿度百分比 | |
| PowerLoadPercent | 新增属性 | y | 0XFF | R:ReadOnly W:无 | 无 | false | 负载百分比 | |
| PowerApparentVA | 新增属性 | d | -1 | R:ReadOnly W:无 | 无 | false | 交流电路的电压和电流的乘积，单位为伏安单位。 | |
| PowerPhaseAngleDegrees | 新增属性 | d | 1000 | R:ReadOnly W:无 | 无 | false | 电流和电压波形之间的相角（度）。 | |
| PowerFactor | 新增属性 | d | -1 | R:ReadOnly W:无 | 无 | false | 功率因数 | |
| PowerReactiveVAR | 新增属性 | d | -1 | R:ReadOnly W:无 | 无 | false | 视在VA平方和功率平方的差项的平方根，以VAR为单位 | |
| PowerWatts | 新增属性 | u | 0xFFFFFFFF | R:ReadOnly W:无 | 无 | false | 功耗(瓦特) | |
| TemperatureCelsius | 新增属性 | y | 0xFF | R:ReadOnly W:无 | 无 | false | 温度（摄氏度） |
评审点4：新增 PowerSupplies.Metrics 相关资源协作接口和属性
path：/bmc/kepler/Chassis/:ChassisId/PowerSubsystem/PowerSupplies
interface（新增）：bmc.kepler.Chassis.PowerSubsystem.PowerSupplies.Metrics
| 属性名称 | 变化类型 | 签名 | 默认值 | 读写&权限 | 持久化 | 变化通知 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|---|
| AllocatedWatts | 新增属性 | u | 0xFFFFFFFF | R:ReadOnly W:无 | 无 | false | 已分配的功率（单位：瓦） | |
| RequestedWatts | 新增属性 | u | 0xFFFFFFFF | R:ReadOnly W:无 | 无 | false | 请求的功率（单位：瓦） |
评审结论
通过，具体结论如下：
-
同意新增资源协作接口
bmc.kepler.PowerEquipment.PowerDistribution，接口下新增属性Health、ServiceLabel、Version、UUID、LocationUserLabel、EquipmentType、AssetTag、FirmwareVersion、Manufacturer、Model、PartNumber、SerialNumber、ProductionDate、PowerCapacityVA、LocationReference、LocationOrientation、LocationType、LocationOrdinalValue，属性的具体定义见评审点1 -
同意新增资源协作接口
bmc.kepler.PowerEquipment.PowerDistribution.TransferConfig，接口下新增属性
ActiveMainsId、AutoTransferEnabled、ClosedTransitionAllowed、ClosedTransitionTimeoutSeconds、PreferredMainsId、RetransferDelaySeconds、RetransferEnabled、TransferInhibit、TransferDelaySeconds、OverNominalFrequencyHz、OverVoltageRMSPercent、TransferSensitivity、UnderNominalFrequencyHz、UnderVoltageRMSPercent，属性的具体定义见评审点2；接口下新增方法TransferControl，方法无请求和响应参数，方法权限为 PowerMgmt -
同意新增资源协作接口
bmc.kepler.PowerEquipment.PowerDistribution.Metrics，接口下新增属性
AbsoluteHumidity、ApparentkVAh、EnergyLifetimekWh、ReactivekVARh、EnergykWh、SensorResetTime、HumidityPercent、PowerLoadPercent、ApparentVA、PhaseAngleDegrees、PowerFactor、ReactiveVAR、PowerWatts、TemperatureCelsius，属性的具体定义见评审点3；接口下新增方法ResetMetrics，方法无请求和响应参数，方法权限为 PowerMgmt -
同意新增资源协作接口
bmc.kepler.Chassis.PowerSubsystem.PowerSupplies.Metrics，接口下新增属性AllocatedWatts、RequestedWatts，属性的具体定义见评审点4
遗留问题
无