【已评审】支持redfish和web接口查询光模块BOM编码信息

yuanfeng · 2026 年8 月 13 日 02:26

背景

支持redfish和web接口查询光模块BOM编码信息

关联ISSUE

整体方案

资源协作接口bmc.kepler.Systems.OpticalModule新增属性承载光模块BOM编码，并通过带内BMA更新
redfish资源Transceivers新增属性显示光模块BOM编码
BMCWeb界面展示光模块BOM编码

评审点

资源协作接口bmc.kepler.Systems.OpticalModule新增BomId属性
redfish资源Transceivers新增BomId属性（GET接口）
web_backend对应URI下新增BomId字段

详细描述

评审点1：资源协作接口bmc.kepler.Systems.OpticalModule新增BomId属性

资源协作接口：bmc.kepler.Systems.OpticalModule下新增属性

资源interface：bmc.kepler.Systems.OpticalModule

新增属性

变更类型	属性名称	签名	只读	变化通知	属性描述	访问权限	属性来源	持久化类型	变更影响
新增	BomId	s	True	false	光模块BOM编码	Read：ReadOnly	BMA	无需持久化	无影响

评审点2：redfish资源Transceivers新增BomId属性（GET接口）

资源Uri：/redfish/v1/Chassis/:chassisid/Transceivers/OpticalModule_{opticalid}

资源版本：HwTransceiver.v1_0_0.HwTransceiver

属性评审点：

属性名	类型	示例/取值约束	readonly	易变属性	实现 PATCH	操作权限	描述
BomId	string,null	“34xxxxxx”	true	否	否	ReadOnly	光模块BOM编码

Get响应示例

{
    "@odata.context": "/redfish/v1/xxx",
    "@odata.id": "/redfish/v1/Chassis/1/Transceivers/xxxPort1",
    "@odata.type": "xxxTransceiver",
    "Name": "OpticalModule",
    "Id": "OpticalModule_xxxPort1",
    ...
    "BomId": "34xxxxxx",
    ...
}

评审点3：web_backend对应URI下新增BomId字段
接口：/UI/Rest/System/NetworkAdapter/:adapterid/NetworkPorts/:portnum
接口类型：GET
新增字段

一级属性	二级属性	取值类型	操作权限	属性说明
OpticalModule	/	object	ReadOnly	光模块
OpticalModule	BomId	string, null	ReadOnly	光模块BOM编码

RspBody响应体示例：

{
    OpticalModule : {
        "BomId" : "34xxxxxx"  
        ...
    }
}

BOM_码图

是否准备好AI预审

是

评审结论

同意资源协作接口bmc.kepler.Systems.OpticalModule新增BomId属性
新增属性：BomId，含义为光模块BOM编码，类型为string，默认值为空字符串，只读
同意redfish资源Transceivers新增BomId属性（GET接口）并保证历史名称Item无人使用
资源URI：/redfish/v1/Chassis/:chassisid/Transceivers/OpticalModule_{opticalid}
资源版本：HwTransceiver.v1_0_0.HwTransceiver
操作类型：get
操作权限：ReadOnly
新增属性：BomId，光模块BOM编码，类型为string,null，默认为null
同意 web_backend对应URI下新增BomId字段
接口：/UI/Rest/System/NetworkAdapter/:adapterid/NetworkPorts/:portnum
接口类型：GET
新增字段：OpticalModule.BomId，类型为string, null，只读，默认为null，Web不显示

遗留问题

PartNumber部件编码还是BomId 需要确定
解决方案：确定使用BomId

ubmc_assistant · 2026 年8 月 13 日 02:38

预审答案内容由AI生成，仅供参考：

帖子评审结论：【待评审】资源协作接口OpticalModule新增Item属性和相应redfish Rest资源

帖子相关性：相关（MDB 相关: 标题含强特征: 资源协作）

总评审点数：3
MDB 资源协作接口评审点：1
Redfish 相关评审点：1
其他评审点：1

总体结果：通过（2/2 个评审点通过）

评审点 1：资源协作接口OpticalModule新增属性【MDB】

结果：通过

规则合规性检查：通过（28 项检查全部通过）
- 警告项（建议性）：
  规则ID：MDB-REVIEW-003
  级别：建议性
  问题描述：新增属性缺少业务背景、消费方/使用场景说明，且方案1与方案2的复用取舍未阐述。
  处理建议：severity=‘should’ 建议性规则，建议修改以提升规范符合性

评审点 2：redfish资源Transceivers新增属性（GET接口）【Redfish】