【已评审】支持web和redfish接口管理SSU BIOS模块

Interface SIG Interface评审
1

背景

SSU（Smart Storage Unit）模组是独立计算/存储单元，每个SSU有自己的BIOS固件。本次议题申报通过2个北向接口（Redfish、Web）对外暴露SSU的BIOS固件信息（版本号、启动项等），支持设置BIOS优先启动项、生效模式。

关联ISSUE

整体方案

Redfish接口

1.标准ComputerSystem资源 /redfish/v1/Systems/SSU:id 新增Oem字段管理SSU BIOS子资源

Web接口
2. /UI/Rest/System/SSUs/:id/Bios展示SSU BIOS

评审点

Redfish接口
1.新增标准ComputerSystem资源 /redfish/v1/Systems/SSU:id 新增Oem字段管理SSU BIOS子资源

Web接口
2.新增/UI/Rest/System/SSUs/:id/Bios展示SSU BIOS

详细描述

评审点1

资源URI ：/redfish/v1/Systems/SSU:id

资源版本 ：ComputerSystem.v1_23_0（DMTF Schema）

属性列表 ：

属性名 类型 示例/取值约束 readonly 易变属性 实现PATCH 操作权限 描述
BiosVersion string “30.28” true 否 / ReadOnly SSU BIOS固件版本号
Boot object / / / / / SSU BIOS启动配置
BootSourceOverrideEnabled string “Once” false 否 是 BasicSetting SSU BIOS 启动项生效模式
BootSourceOverrideTarget string “Hdd” true 否 / ReadOnly SSU BIOS优先启动项
BootSourceOverrideTarget@Redfish.AllowableValues array [“Hdd”,“Pxe”, “None”] true 否 / ReadOnly SSU BIOS优先启动项可选值
Oem object / / / / / 厂商自定义资源
openUBMC object / / / / / 厂商标志
ExtendedBoot object / / / / / SSU BIOS 扩展启动配置
DefaultBootOrder array [“Hdd”,“PxeOverEthernet”, “PxeOverUB”] true 否 / ReadOnly 默认启动顺序
PreferredBootSource string 枚举值： “None”,“Hdd”,“PxeOverEthernet”，“PxeOverUB” false 否 是 BasicSetting 优先启动项

Get响应示例（SSU System）

{
    "BiosVersion": "32.68",
    "Boot": {
        "BootSourceOverrideEnabled": "Once",
        "BootSourceOverrideTarget": "Hdd",
        "BootSourceOverrideTarget@Redfish.AllowableValues": [
            "None","Hdd","Pxe"
        ]
    },
    "Oem": {
        "Huawei": {
            "ExtendedBoot":{
                "PreperredBootSource": "Hdd",
                "DefaultBootOrder":[
                    "Hdd",
                    "PxeOverUB",
                    "PxeOverEthernet"
                ]
            }
        }
    }
}

评审点2

新增接口：/UI/Rest/System/SSUs/:id/Bios
接口类型：GET

属性名称 取值类型 说明 取值范围 操作权限 约束
Version string BIOS固件版本 \ ReadOnly 无
BootOrder array 默认启动顺序 [“Hdd”,“PxeOverEthernet”, “PxeOverUB”] ReadOnly 无
PreferredBootMedium object 启动项配置 \ ReadOnly 无
Target string 优先启动项 枚举值： “None”,“Hdd”,“PxeOverEthernet”，“PxeOverUB” ReadOnly 无
EffectivePeriod string 启动项生效模式 枚举值：“Disabled”, “Once”, “Continuous” ReadOnly 无
AllowableValues array 可选择的优先启动项 [“Hdd”,“PxeOverEthernet”, “PxeOverUB” ] ReadOnly 无

RspBody响应体示例：

{
   "Version": "33.01",
   "BootOrder" : ["Hdd","PxeOverEthernet", "PxeOverUB"],
   "PreferredBootMedium": {
       "Target":"None",
       "EffectivePeriod":"Disabled",
       "AllowableValues": [
              "None",
              "PxeOverEthernet",
              "Hdd",
              "PxeOverUB"
         ]
   }
}

接口类型：PATCH

属性名称 取值类型 说明 取值范围 操作权限 约束
PreferredBootMedium object 启动项配置 \ ReadOnly 无
Target string 优先启动项 枚举值： “None”,“Hdd”,“PxeOverUB”,“PxeOverEthernet” BasicSetting 无
EffectivePeriod string 启动项生效模式 枚举值：“Disabled”, “Once”, “Continuous” BasicSetting 无

ReqBody请求体示例：

{
   "PreferredBootMedium": {
       "Target":"None",
       "EffectivePeriod":"Disabled"
   }
}

Web显示

42D70D46-6B61-4766-E5E9-990AB06AF6F8
42D70D46-6B61-4766-E5E9-990AB06AF6F83840×2160 116 KB

是否准备好AI预审

是

评审结论

1.同意在标准ComputerSystem资源 /redfish/v1/Systems/SSU:id 新增Oem字段管理SSU BIOS子资源，详见评审点1

2.同意新增/UI/Rest/System/SSUs/:id/Bios展示SSU BIOS，详见评审点2

遗留问题

1、确认web界面bios配置启动项位置
—已修改，放在SSU界面下的bios标签中

2

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

帖子评审结论：【待评审】支持web和redfish接口管理SSU BIOS模块

帖子相关性：相关（Redfish 相关: 帖子内容包含 ‘redfish’ 关键字）

  • 总评审点数：2
  • Redfish 相关评审点：1
  • 其他评审点：1

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

评审点 1：新增标准ComputerSystem资源 /redfish/v1/Systems/SSU:id 新增Oem字段管理SSU BIOS子资源【Redfish】

结果：不通过

  • URI 示例生成：通过
  • Schema 验证：不通过（2 项失败）
    • Schema 来源：DMTF ✓，OEM ✗（实际参与校验：DMTF）
    • 入口 schema 文件：dmtf/ComputerSystem.v1_23_0.json（DMTF 官方 schema（SchemaFiles/dmtf））
    • Schema 依据：静态校验直接依据：DMTF 官方 schema（SchemaFiles/dmtf）（dmtf/ComputerSystem.v1_23_0.json）
    • [Required Property Error] Required Property Error: Property ‘Id’ is mandatory, but not present in the payload.
    • [Required Property Error] Required Property Error: Property ‘Name’ is mandatory, but not present in the payload.
  • 规则合规性检查：不通过（2/18 项失败）

    • 静态验证失败项：
      规则ID：N/A
      级别：Schema
      问题描述：Required Property Error: Required Property Error: Property ‘Id’ is mandatory, but not present in the payload.
      处理建议：添加必需属性 ‘Id’

      规则ID：N/A
      级别：Schema
      问题描述：Required Property Error: Required Property Error: Property ‘Name’ is mandatory, but not present in the payload.
      处理建议：添加必需属性 ‘Name’

    • 规则合规性失败项（必须项）：
      规则ID：RULE-001
      级别：必须项
      问题描述：评审点中的 ComputerSystem 资源缺少必需属性 Id 和 Name，现有属性名均符合 PascalCase 规范
      处理建议：添加 Id 和 Name 属性，例如：“Id”: “1”, “Name”: “Computer System”。根据 Redfish 规范，所有资源必须包含 Id 和 Name 属性