【已评审】Redfish接口HBMHighRAS资源新增属性承载HBM维护状态

Interface SIG Interface评审
1

背景

当前BMC已具备HBM健康风险检测能力，需新增redfish接口属性承载HBM维护状态

关联ISSUE

整体方案

HBMHighRAS资源下新增属性承载HBM维护状态

评审点

/redfish/v1/Managers/{ManagerId}/FDMService/NpuFPC/HBMHighRAS 下新增属性

详细描述

评审点1：HBMHighRAS资源新增属性

资源URI：/redfish/v1/Managers/{ManagerId}/FDMService/NpuFPC/HBMHighRAS
资源版本：HBMHighRAS.v1_1_0

一级属性 二级属性 类型 示例/取值约束 readonly 易变属性 实现PATCH 操作权限 描述
HBMStatus array / true 否 / ReadOnly HBM状态信息列表
DeviceLocator string “Npu2” true 否 否 ReadOnly 特定HBM所在的处理器
MaintenanceRequired bool true 或 false true 否 否 ReadOnly 是否建议安排维护

Schema定义：

schema文件名：hbmhighras.v1_1_0.json

{
    "$id": "http://redfish.dmtf.org/schemas/v1/HBMHighRAS.v1_1_0.json",
    "$ref": "#/definitions/HBMHighRAS",
    "$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json",
    "copyright": "Copyright 2014-2026 DMTF. For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright",
    "definitions": {
        "HBMHighRAS": {
            "type": "object",
            "patternProperties": {
                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message|Privileges)\\.[a-zA-Z_][a-zA-Z0-9_.]+$": {
                    "type": [
                        "array",
                        "boolean",
                        "number",
                        "null",
                        "object",
                        "string"
                    ],
                    "description": "This property shall specify a valid odata or Redfish property."
                }
            },
            "additionalProperties": false,
            "properties": {
                "@odata.context": {
                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata.4.0.0.json#/definitions/context"
                },
                "@odata.id": {
                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata.4.0.0.json#/definitions/id"
                },
                "@odata.type": {
                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata.4.0.0.json#/definitions/type"
                },
                "Name": {
                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Name"
                },
                "Id": {
                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Id"
                },
                "HBMStatus": {
                    "type": "array",
                    "readonly": true,
                    "items": {
                        "$ref": "#/definitions/HBMStatus"
                    },
                    "description": "List of HBM Information",
                    "longDescription": "List of HBM Information"
                }
            },
            "required": [
                "@odata.context",
                "@odata.id",
                "@odata.type",
                "Id",
                "Name"
            ],
            "description": "HBM High RAS.",
            "longDescription": "HBM High RAS."
        },
        "HBMStatus": {
            "type": "object",
            "patternProperties": {
                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message|Privileges)\\.[a-zA-Z_][a-zA-Z0-9_.]+$": {
                    "type": [
                        "array",
                        "boolean",
                        "number",
                        "null",
                        "object",
                        "string"
                    ],
                    "description": "This property shall specify a valid odata or Redfish property."
                }
            },
            "additionalProperties": false,
            "properties": {
                "DeviceLocator": {
                    "type": "string",
                    "readonly": true,
                    "description": "The HBM-located Processor.",
                    "longDescription": "The HBM-located Processor."
                },
                "MaintenanceRequired": {
                    "type": "boolean",
                    "readonly": true,
                    "description": "This attribute indicates whether maintenance is recommended to be scheduled.",
                    "longDescription": "This attribute indicates whether maintenance is recommended to be scheduled."
                }
            }
        }
    },
    "language": "en",
    "owningEntity": "DMTF",
    "release": "2026.8",
    "title": "#HBMHighRAS.v1_1_0.HBMHighRAS"
}

请求样例

GET https://device_ip/redfish/v1/Managers/1/FDMService/NpuFPC/HBMHighRAS

请求头：
X-Auth-Token: 6599174c38c36838737d9749179e1ee1

请求消息体：无

响应样例

{
	"@odata.context": "/redfish/v1/$metadata#HBMHighRAS.HBMHighRAS",
	"@odata.id": "/redfish/v1/Managers/1/FDMService/NpuFPC/HBMHighRAS",
	"@odata.type": "#HBMHighRAS.v1_1_0.HBMHighRAS",
	"Name": "HBMHighRAS",
	"Id": "HBMHighRAS",
	"HBMStatus": [
		{
			"DeviceLocator": "Npu1",
			"MaintenanceRequired": false
		},
		{
			"DeviceLocator": "Npu2",
			"MaintenanceRequired": false
		}
	]
}

是否准备好AI预审

是

评审结论

同意在HBMHighRAS资源下新增属性HBMStatus，属性类型为数组，只读，权限为ReadOnly，详细信息见评审点1

遗留问题

1、需要确认资源定义采用那种方式：资源集合、Links还是关联
结论：不采用集合资源\links\关联的实现方式，HBMHighRAS是独立资源节点，直接对外呈现对应资源属性，把DeviceLocator修改成string类型