变更声明
光模块原URI（/redfish/v1/Chassis/{chassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkPorts/{NetworkPortId}/OpticalModule）体现了网口与光模块的上下级关系。然而随着服务器硬件的演进，网口与光模块不再一一对应，继续应用原URI容易造成用户误解。因此，openUBMC提出了一种新的光模块资源模型（/redfish/v1/Chassis/{chassisId}/Transceivers/{TransceiverId}）。
为了保证openUBMC Redfish各接口演进的一致性，26.03及后续版本会将PerformanceCollection资源的光模块URI替换为新URI（新URI各项操作的响应结果完全兼容旧URI）。更多详细内容请见评审材料：
受影响的版本
- openUBMC 25.03
- openUBMC 25.06
- openUBMC 25.09
- openUBMC 25.12
变更描述
规格变化
不涉及
外观变化
不涉及
外部接口变化
/redfish/v1/PerformanceCollection的光模块URI从/redfish/v1/Chassis/{chassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkPorts/{NetworkPortId}/OpticalModule变更为/redfish/v1/Chassis/{chassisId}/Transceivers/{TransceiverId}，具体变更点如下：
变更前
"OpticalModule": [
{
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/EthernetAdapterBoard/NetworkPorts/1/OpticalModule"
}
]
变更后
"OpticalModule": [
{
"@odata.id": "/redfish/v1/Chassis/1/Transceivers/OpticalModule_EthernetAdapterBoardPort1"
}
]
安装方式变化
不涉及
兼容性说明
- BMC固件兼容性：当前变更仅涉及BMC的固件软件版本，不涉及兼容性
- openUBMC 和 BMC SDK 兼容性：此接口不依赖SDK，不涉及兼容性
- BMC与上层网管的兼容性：如果上层网管调用此接口并对其中的光模块URI存在格式检查，则可能导致链接跳转失败或引起其他异常，需要修改网管软件进行适配
文档影响
不涉及
建议动作
- 确认上层网管是否会调用
/redfish/v1/PerformanceCollection，并对其中的光模块URI有格式检查或强匹配操作，如果存在此种场景，需要修改网管软件适配新URI，并能兼容原URI