【变更声明】关于移除Redfish历史版本Schema资源的计划通知

Interface SIG
1

变更声明

openUBMC 计划于 2027 年 移除 Redfish 历史版本 Schema 资源（包括JSON Schema、CSDL），以便优化 Redfish Schema 的维护和使用效率。本声明旨在提前通知社区相关用户，以便在正式移除前完成迁移适配工作。

受影响的版本

  • openUBMC 计划于2027 年发布的相关版本

变更描述

规格变化

不涉及

外观变化

不涉及

外部接口变化

变更点1：移除/redfish/v1/JsonSchemas接口响应体中历史版本JSON Schema资源

相关URI: /redfish/v1/JsonSchemas

变化点：GET操作响应体

变更前

{
       ...
	"Members": [
		{
		  "@odata.id": "/redfish/v1/JsonSchemas/AccountService"
		},
		{
		  "@odata.id": "/redfish/v1/JsonSchemas/AccountService.v1_0_0"  -- 历史版本schema, 计划移除
		},
		{
		  "@odata.id": "/redfish/v1/JsonSchemas/AccountService.v1_0_2"  -- 历史版本schema, 计划移除
		},
		{
		  "@odata.id": "/redfish/v1/JsonSchemas/AccountService.v1_0_3"  -- 历史版本schema, 计划移除
		},
		{
		  "@odata.id": "/redfish/v1/JsonSchemas/AccountService.v1_x_x"  -- 支持的最新版本
		}
                ...
	]
}

变更后

{
       ...
	"Members": [
		{
		  "@odata.id": "/redfish/v1/JsonSchemas/AccountService"
		},
		{
		  "@odata.id": "/redfish/v1/JsonSchemas/AccountService.v1_x_x"    -- 保留最新支持的版本
		}
                ...
	]
}

变更点2：移除/redfish/v1/$metadata接口响应体中历史版本CSDL资源

相关URI: /redfish/v1/$metadata

变化点：GET操作响应体

变更前

<edmx:Edmx xmlns:edmx="http://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
    ...
    <edmx:Reference Uri="/redfish/v1/Schemas/AccountService_v1.xml">
        <edmx:Include Namespace="AccountService"/>
        <edmx:Include Namespace="AccountService.v1_0_2"/>   -- 历史版本schema, 计划移除
        <edmx:Include Namespace="AccountService.v1_x_x"/>   -- 支持的最新版本
    </edmx:Reference>
    ...

变更后

<edmx:Edmx xmlns:edmx="http://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
    ...
    <edmx:Reference Uri="/redfish/v1/Schemas/AccountService_v1.xml">
        <edmx:Include Namespace="AccountService"/>
        <edmx:Include Namespace="AccountService.v1_x_x"/>   -- 保留支持的最新版本
    </edmx:Reference>
    ...

安装方式变化

不涉及

兼容性说明

  • BMC固件兼容性：预计2027年变更仅涉及BMC的固件软件版本，不涉及兼容性
  • openUBMC 和 BMC SDK 兼容性：此接口不依赖SDK，不涉及兼容性
  • BMC与上层网管的兼容性：如果上层网管访问/redfish/v1/JsonSchemas、/redfish/v1/$metadata的历史版本Schema资源，可能导致解析失败，需要修改网管软件进行适配

文档影响

不涉及

建议动作

如您的实现或工具链依赖上述历史版本 Schema 文件，请在正式移除前完成以下操作：

  • 检查代码或配置中是否存在对历史版本 Schema 的硬编码引用。如果存在，则建议通过/redfish/v1/JsonSchemas、/redfish/v1/$metadata接口动态发现openUBMC支持的Schema资源，避免硬编码。