【待评审】新增资源协作接口提供获取框内节点信息能力

Interface SIG Interface评审
1

背景

框式设备包含管理板和节点板，管理板需要汇聚整框单板的部分信息进行统一显示。

关联ISSUE

无

整体方案

主用管理板上获取框内节点的信息，通过资源协作接口的属性展示，供北向接口查询并显示。

评审点

  1. 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/:AggregateId/ChassisService/Blades/:BladeId
    1. 新增资源协作接口 bmc.kepler.AggregationService.Blade
      1. 新增获取框内节点内部通信ip和token方法GetForwardingCredentials
      2. 新增属性Id、Presence、ChassisFunctionType、HotSwapState

详细描述

评审点1：新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/:AggregateId/ChassisService/Blades/:BladeId

路径描述：新增路径用于提供管理板获取框内节点信息能力。
path(新增)： /bmc/kepler/AggregationService/Aggregates/:AggregateId/ChassisService/Blades/:BladeId
interface(新增)： bmc.kepler.AggregationService.Blade

实现接口

实现接口 实现接口描述 CSR配置影响 持久化影响 其他影响
bmc.kepler.AggregationService.Blade 实现Id, Presence, ChassisFunctionType, HotSwapState属性和GetForwardingCredentials方法 Id、Presence和ChassisFunctionType属性需要进行配置 不涉及持久化，无影响 无

新增属性

属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性
Id s true false 节点Id ReadOnly CSR 不持久化 false
Presence y true true 单板在位，1：在位；0:不在位 ReadOnly CSR 不持久化 true
ChassisFunctionType y true false 单板类型: 0表示计算板, 1表示交换板, 3表示管理板，默认值为0 ReadOnly CSR 不持久化 false
HotSwapState y true true 单板热插拔状态: 取值0 ~ 7, 对应M0 ~ M7，默认为0 ReadOnly 从节点板获取 不持久化 true

新增方法

方法名称 请求签名 请求参数描述 响应签名 响应参数描述 方法描述 访问权限 变更影响
GetForwardingCredentials b RefreshToken: b，是否从节点上直接获取token；
true: 从节点上获取最新token值;
false: 从app缓存中获取token		 ss TargetIp: s 节点内部通信ip
Token: s 节点上redfish会话的token		 获取框内节点内部通信ip和token,用于转发redfish请求到框内节点 BasicSetting 新增方法，无影响

是否准备好AI预审

是

评审结论

同意 新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/:AggregateId/ChassisService/Blades/:BladeId
1. 新增资源协作接口 bmc.kepler.AggregationService.Blade
1. 新增获取框内节点内部通信ip和token方法GetForwardingCredentials
2. 新增属性Id、Presence、ChassisFunctionType、HotSwapState

遗留问题

  1. /bmc/kepler/AggregationService/Aggregates/${AggregateId}/Blades/${BladeId} 合并到
    /bmc/kepler/AggregationService/Aggregates/${AggregateId}/ChassisService 下增加子路径
    已调整路径
  2. GetForwardingDetails 修改为GetForwardingCredentials
    已修改
  3. bmc.kepler.AggregationService.Blade 接口新增属性的属性描述单板在位增加取值描述；单板类型修改为ChassisFunctionType
    已修改
2

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

帖子评审结论：【待评审】新增资源协作接口提供获取框内节点信息能力

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

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

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

评审点 1：新增资源协作路径 /bmc/kepler/AggregationService/Aggregates/:AggregateId/IpmbEthBlades/:IpmbEthBladeId【MDB】

结果：不通过

  • 规则合规性检查：不通过（1/28 项失败）
    • 规则合规性失败项（必须项）：
      规则ID：MDB-NAMING-006
      级别：必须项
      问题描述：属性 HotSwap 描述为状态但未使用 Status 或 State 后缀；方法名 GetForwardInfos 使用 Infos 泛化后缀承载核心语义。
      处理建议：1. 将属性 HotSwap 重命名为 HotSwapStatus 或 HotSwapState，以符合状态类字段的命名硬约束；2. 将方法 GetForwardInfos 重命名为 GetForwardDetails 或更精确的领域术语，避免使用 Info/Infos 泛化后缀。
    • 警告项（建议性）：
      规则ID：MDB-RISK-004
      级别：建议性
      问题描述：方法 GetForwardInfos 涉及获取 Redfish 会话 Token（密钥/凭据），属于高风险安全行为，但未说明防误操作、凭据保护或审计日志策略。
      处理建议：severity=‘should’ 建议性规则，建议修改以提升规范符合性