【已评审】CLI&Rest&IPMI&资源树新增机框信息管理接口及属性

Interface SIG Interface评审
1

背景

新增机框信息管理能力，cli&rest&资源树新增接口及字段

关联ISSUE

整体方案

CLI&Rest&资源树新增机框信息管理接口及属性，支持机框产品信息管理

评审点

评审点1：cli新增接口支持机框信息管理

评审点2：Rest管理概览接口新增属性支持背板类型展示

评审点3：新增资源协作接口bmc.kepler.AggregationService.Chassis支持机框信息管理

评审点4：新增资源协作接口bmc.kepler.AggregationService.Backplane支持背板信息管理

详细描述

评审点1：cli新增接口支持机框信息管理

查询机框信息的CLI命令：

变化类型：新增命令字

操作权限：ReadOnly

ipmcget -l shelf [-t target] -d dataitem
                  -t <target>
                   		fru                           Get the fru information       
                  -d <dataitem>
                  		fruinfo                       Get shelf fru information 
ipmcget -l shelf  -d dataitem
                  -d <dataitem>
                  		chassisid                     Get chassis id                                    
	                   	chassisname                   Get chassis name                                  
    	               	location                      Get chassis location                              
        	           	version                       Get chassis version                               
            	       	health                        Get shelf health status                           
                	   	healthevents                  Get shelf health events                           
                   		unhealthylocations            Get shelf unhealthy locations                     
	                   	realtimepower                 Get shelf real-time power                         
    	               	subnet                        Get inner subnet segment

使用示例：

// 请求：查询机框Fru信息
ipmcget -l shelf -t fru -d fruinf
FRU Device Description : Builtin FRU Device (FRUID 1, BackPlane)
 Chassis Type          : Other
 Chassis Part Number   : 8
 Chassis Serial Number : 210230195710KA001234
 Board Mfg. Date       : 2026/06/17 Thu 23:00:00
 Board Manufacturer    : HHHHHHH
 Board Product Name    : 1234MMMM
 Board Serial Number   : 026XYG10M60000000
 Board Part Number     : 03026XXX
 Board FRU File ID     : 5.13.00.01
 Extend label          : Description=Manufactured Board
 Product Manufacturer  : Huawei
 Product FRU File ID   : 5.13.00.01

设置机框信息的CLI命令：

变化类型：新增命令字

操作权限：BasicSetting

ipmcset -l shelf -d dataitem [-v value]
                 -d <dataitem>
                       chassisid                     Set chassis id                                    
                       chassisname                   Set chassis name                                  
                       location                      Set chassis location                              
                       subnet                        Set inner subnet segment

使用示例：

// 请求：设置机框名称
ipmcset -l shelf -d chassisname -v 123456
Set chassis name ok.

参数说明：

参数名称 取值类型 说明 取值范围 是否可选
chassisid integer 机框ID [0, 1000000) 否
chassisname string 机框名称 最长20Byte 否
location string 机框位置 最长20Byte 否
subnet string 机框设备管理网段地址 网段IP 否

评审点2：Rest管理概览接口新增属性支持背板类型展示

URL：UI/Rest/Enclosure/Overview

变化类型：新增属性

操作权限：ReadOnly

操作类型：GET

应用场景：用于前端首页进行系统低速背板类型、系统高速背板类型显示

一级属性 二级属性 变化类型 数据类型 默认值 取值范围 读写&权限 说明
Chassis HighSpeedBackplaneType 新增属性 string 无 长度1-20 只读-ReadOnly 系统高速背板类型
PowerBackplaneType 新增属性 string 无 长度1-20 只读-ReadOnly 电源低速背板类型

评审点3：新增资源协作接口bmc.kepler.AggregationService.Chassis支持机框信息管理

接口描述：接口承载了机框管理的信息。

新增属性

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 变更影响
ChassisId uint32 False True 机框ID，支持框内分发场景使用，默认1000000 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响
ChassisLocation String False True 机框位置，支持框内分发场景使用 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响
ChassisName String False True 机框名称，支持框内分发场景使用 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响

新增接口影响

路径 新增接口影响 CSR配置影响 持久化影响 其他影响
/bmc/kepler/AggregationService/Aggregates/:AggregateId/ChassisService 提供机框信息管理框内分发功能 不涉及重名属性，无影响 不涉及持久化，无兼容性问题 需实现新增属性和方法

评审点4：新增资源协作接口bmc.kepler.AggregationService.Backplane支持背板信息管理

接口描述：接口承载了背板管理信息。

新增属性

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 变更影响
HighSpeedBackplaneType String False True 系统高速背板类型，支持框内分发场景使用 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响
PowerBackplaneType String False True 电源高速背板类型，支持框内分发场景使用 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响

新增接口影响

路径 新增接口影响 CSR配置影响 持久化影响 其他影响
/bmc/kepler/AggregationService/Aggregates/:AggregateId/ChassisService 提供背板管理能力及信息框内分发功能 不涉及重名属性，无影响 不涉及持久化，无兼容性问题 需实现新增属性和方法

是否准备好AI预审

是

评审结论

  1. 同意cli新增以下接口支持机框信息管理
查询机框信息的CLI命令：
变化类型：新增命令字
操作权限：ReadOnly
ipmcget -l shelf [-t target] -d dataitem
                  -t <target>
                   		fru                           Get the fru information       
                  -d <dataitem>
                  		fruinfo                       Get shelf fru information 
ipmcget -l shelf  -d dataitem
                  -d <dataitem>
                  		chassisid                     Get chassis id                                    
	                   	chassisname                   Get chassis name                                  
    	               	location                      Get chassis location                              
        	           	version                       Get chassis version                               
            	       	health                        Get shelf health status                           
                	   	healthevents                  Get shelf health events                           
                   		unhealthylocations            Get shelf unhealthy locations                     
	                   	realtimepower                 Get shelf real-time power                         
    	               	subnet                        Get inner subnet segment
设置机框信息的CLI命令：
变化类型：新增命令字
操作权限：BasicSetting
ipmcset -l shelf -d dataitem [-v value]
                 -d <dataitem>
                       chassisid                     Set chassis id                                    
                       chassisname                   Set chassis name                                  
                       location                      Set chassis location                              
                       subnet                        Set inner subnet segment
  1. 同意Rest管理概览接口新增属性支持背板类型展示
URL：UI/Rest/Enclosure/Overview
变化类型：新增属性
操作权限：ReadOnly
操作类型：GET

应用场景：用于前端首页进行系统低速背板类型、系统高速背板类型显示

一级属性 二级属性 变化类型 数据类型 默认值 取值范围 读写&权限 说明
Chassis HighSpeedBackplaneType 新增属性 string 无 长度1-20 只读-ReadOnly 系统高速背板类型
PowerBackplaneType 新增属性 string 无 长度1-20 只读-ReadOnly 电源低速背板类型
  1. 同意新增以下资源协作接口bmc.kepler.AggregationService.Chassis及属性支持机框信息管理
属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 变更影响
ChassisId uint32 False True 机框ID，支持框内分发场景使用，默认1000000 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响
ChassisLocation String False True 机框位置，支持框内分发场景使用 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响
ChassisName String False True 机框名称，支持框内分发场景使用 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响
  1. 同意新增以下资源协作接口bmc.kepler.AggregationService.Backplane支持背板信息管理
属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 变更影响
HighSpeedBackplaneType String False True 系统高速背板类型，支持框内分发场景使用 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响
PowerBackplaneType String False True 电源高速背板类型，支持框内分发场景使用 Read: ReadOnly Write: BasicSetting 带外获取 不持久化 无影响

遗留问题

1、机框信息的属性是可写的，不需要对应的方法。
结论：已删除
2、机框属性的详细描述与已有Chassis的差异
结论：
      ①已有Chassis接口的机框名称为只读类型，当前设计预期机框名称可写。
      ②已有Chassis接口缺少机框ID属性
      ③已有Chassis接口不支持框内分发机框信息的场景。
3、ChassisInfo接口名称需要修改，不能带info。
结论：Path修改为 /bmc/kepler/AggregationService/Aggregates/:AggregateId/ChassisService，机框信息接口名称修改为bmc.kepler.AggregationService.Chassis，背板信息接口名称修改为bmc.kepler.AggregationService.Backplane
4、确认下HighSpeedBackplaneType和PowerBackplaneType属性别的产业用不了，是否可以当前接口拆出来。
结论：已拆分至Backplane接口中
2

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

帖子评审结论：【待评审】CLI&Rest&资源树新增机框信息管理接口及属性

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

  • 总评审点数：3
  • MDB 资源协作接口评审点：1
  • 其他评审点：2

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

评审点 1：变更资源协作接口bmc.kepler.Chassis.Enclosure新增字段及接口支持机框信息管理【MDB】

结果：通过

  • 规则合规性检查：通过（27 项检查全部通过）
3

遗留问题记录：
1、机框信息的属性是可写的，不需要对应的方法。
2、机框属性的详细描述与已有Chassis的差异
3、ChassisInfo接口名称需要修改，不能带info。
4、确认下HighSpeedBackplaneType和PowerBackplaneType属性别的产业用不了，是否可以当前接口拆出来。