变更声明
背景
https://discuss.openubmc.cn/t/topic/5803
受影响的版本
-
openUBMC 25.03
-
openUBMC 25.06
-
openUBMC 25.09
-
openUBMC 25.12
变更描述
规格变化
不涉及
外观变化
不涉及
外部接口变化
接口：/redfish/v1/Systems/:systemid/EthernetInterfaces/:ethernetinterfaceid
操作类型：Get
-
变更前：AutoNeg、 FullDuplex 、IsOnBoot（Oem属性）在读取硬件数据失败时返回false
-
变更后：AutoNeg、 FullDuplex 、IsOnBoot（Oem属性）在读取硬件数据失败时返回null
接口：/redfish/v1/Systems/:systemid/EthernetInterfaces/:ethernetinterfaceid/VLANs/:vlanid
操作类型：Get
-
变更前：IsOnBoot（Oem属性）在读取硬件数据失败时返回false
-
变更后：IsOnBoot（Oem属性）在读取硬件数据失败时返回null
接口：/redfish/v1/Chassis/:chassisid/NetworkAdapters/:networkadapterid/NetworkPorts/:portid/OpticalModule
操作类型：Get
-
变更前：RxLosState（Oem属性）和TxFaultState（Oem属性）在读取硬件数据失败时返回false
-
变更后：RxLosState（Oem属性）和TxFaultState（Oem属性）在读取硬件数据失败时返回null
接口：/redfish/v1/Chassis/:chassisid/Transceivers/OpticalModule_:opticalid
操作类型：Get
-
变更前：RxLosState（Oem属性）和TxFaultState（Oem属性）在读取硬件数据失败时返回false
-
变更后：RxLosState（Oem属性）和TxFaultState（Oem属性）在读取硬件数据失败时返回null
兼容性说明
- BMC固件兼容性：当前变更仅设计BMC的固件软件版本，不涉及兼容性
- openUBMC和BMC SDK兼容性：上述接口不依赖SDK，不涉及兼容性
- BMC与上层网管的兼容性：上层网管如果访问上述接口的相关属性，读取硬件数据失败时会返回null，脚本可能未处理null的情况导致解析失败，需要修改网管软件进行适配
文档影响
不涉及
建议动作
确认上层网管是否会访问上述接口，如果涉及上述接口，相关属性返回null是否会导致脚本解析失败，若存在影响，需要修改网管软件进行适配，并确保兼容openUBMC旧版本的接口