【已评审】支持Redfish接口查询待生效固件的描述信息

Interface SIG Interface评审
1

背景

目前Redfish接口UpdateService支持查询待生效固件的描述信息包括待生效固件的固件类型、版本号、对应设备等，但是无法查询待生效固件的生效方式等，导致生效时只能依据经验来触发生效。

关联ISSUE

暂无ISSUE

整体方案

现网运维场景下，在设备的固件升级后，查询待生效固件的描述信息

评审点

Redfish 接口UpdateService OEM属性FirmwareToTakeEffect增加待生效固件的描述信息:

  1. ActiveStatus：生效状态
  2. ActivationControl：生效控制方式

详细描述

资源URI: /redfish/v1/UpdateService
资源版本：#UpdateService.v1_17_0.UpdateService
操作类型：GET
操作权限：ReadOnly
变更类型：响应中新增OEM属性
请求参数：无
响应参数：

{
    …
    "Oem": {
        "Huawei": {
                    …
              "FirmwareToTakeEffect": [
                          {
                              "FirmwareType": “BMC",
                              "RelatedFirmwareItems": [
                                  {
                                      "@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/ActiveBMC"
                                  }
                              ],
                              "StagedVersion": “5.12.00.02",
                              “StagedTime”: “2026-03-27T17:13:20”,
                              “ActiveStatus”: “Pending” ,
                              “ActivationControl”: [“ResetBMC”]
                          }
              ],
    …
        }
    }
}

Schema定义：

"FirmwareToTakeEffect": {
            "type": "object",
            "properties": {
                ...
                "ActiveStatus": {
                    "type": "string",
                    "readonly": true,
                    "description": "Active status of the firmware to take effect.",
                    "longDescription": "Active status of the firmware to take effect."
                },
                "ActivationControl": {
                    "type": "array",
                    "readonly": true,
                    "description": "Effective control mode of the firmware to take effect.",
                    "longDescription": "Effective control mode of the firmware to take effect."
                },
            },
            "additionalProperties": false
        },
属性名 类型 示例/取值约束 readonly 易变属性 实现PATCH 操作权限 描述
ActiveStatus 字符串 Exception、Pending、Running、Completed true 否 否 ReadOnly 生效状态
ActivationControl 数组 ResetBMC、PowerOff、PowerOn、ResetTargetDevice true 否 否 ReadOnly 生效控制方式

评审结论

  1. 同意Redfish 接口UpdateService OEM属性FirmwareToTakeEffect增加待生效固件的描述信息:ActiveStatus表示生效状态，ActivationControl表示生效控制方式

遗留问题

2

具体新增的什么描述信息，属性是哪个，明确一下

3

示例给出的 “ToBeActivated” 为什么没列举在下表 示例/取值约束 中，明确到底是否支持 “ToBeActivated”