为用户提供redfish接口支持中文event定义信息查询

背景

(必选)从最终用户视角阐述当前有什么问题,包含问题的场景、影响点,以及当前系统的差距。(提交议题时删除此引导说明)为用户提供redfish接口支持中文event定义信息查询,如下字段的值应该展示为中文:DescriptionMessageSeverityResolutionEventEffectEventCauseEventName

关联ISSUE

(可选)此议题关联的代码仓的issue链接。(提交议题时删除此引导说明)

暂无关联

整体方案

(可选)简要描述此议题关联的整体方案,包括但不限于逻辑架构、组件依赖关系、交互上下文。(提交议题时删除此引导说明)

1.根据英文接口新增一个中文接口支持用户event定义信息查询
2.在上级接口 /redfish/v1/Registries/iBMCEvents.v3_0_0 下的属性添加中文查询内容

评审点1:新增“Uri”: “/redfish/v1/RegistryStore/Messages/zh/iBMCEvents@odata.contextv3_0_0.json” Oem资源

(必选)一句话概括描述待评审的内容。(提交议题时删除此引导说明)

资源URI:“/redfish/v1/RegistryStore/Messages/zh/iBMCEvents@odata.contextv3_0_0.json”
资源版本:iBMCEvents3.0.0
操作类型:GET

属性名 类型 示例/取值约束 readonly 易变属性 实现PATCH 操作权限 描述
@odata.type string true Readonly 这个属性的值应该是一个 URI 片段,用来指定资源的类型,并且它应该是 Redfish 规范中定义的形式。
Id string true Readonly
Name string true Readonly
Language string 示例:en true Readonly 属性注册表的 RFC5646 兼容语言代码。
Description string true Readonly
RegistryPrefix string 示例:iBMCEvents true Readonly 指示该服务是否支持按 RegistryPrefixes 属性过滤
RegistryVersion string 示例:3.0.0 true Readonly 该属性应包含此消息注册的版本
OwningEntity string 示例:Huawei true Readonly 发布此属性注册表的组织或公司。• 此属性应表示该属性注册表的发布者。
Messages object true Readonly
ResourceUpdated object true Readonly
Description string true Readonly
Message string true Readonly
Severity string 枚举值:“OK”, “Warning”, “Critical” true Readonly 健康状态
NumberOfArgs string 示例:0 true Readonly 消息中的参数数量。• 该属性包含用于替换消息中用 % 标记的位置的参数数量
ParamTypes string true Readonly 消息参数的数据类型,在转换为字符串以包含在消息中之前。
Resolution string true Readonly
Oem object true Readonly
Huawei object true Readonly
@odata.type string true Readonly
EventId string true Readonly
EventName string true Readonly
EventEffect string true Readonly
EventCause string true Readonly

详细描述

评审点2:在/redfish/v1/Registries/iBMCEvents.v3_0_0 下添加属性内容

详细描述

在上级接口 /redfish/v1/Registries/iBMCEvents.v3_0_0 里以下属性(Languages、Location)添加内容

变更前:

   {

“@odata.contextodata.contextodata.contextodata.context”: “/redfish/v1/$metadata#MessageRegistryFile.Messag@odata.idRegi@odata.idtryFile”,

“@odata.id”: “/redfish/v1/Registrie@odata.type/i@odata.typeMCEvents.v3_0_0”,

“@odata.type”: “#MessageRegistryFile.v1_0_2.MessageRegistryFile”,

“Id”: “iBMCEvents.v3_0_0”,

“Name”: “iBMC Event Message Registry File”,

“Description”: “iBMC Event Message Registry File locations”,

“Languages”: [

“en”

],

“Registry”: “iBMCEvents.3.0”,

“Location”: [

{

“Language”: “en”,

“Uri”: “/redfish/v1/RegistryStore/Messages/en/iBMCEvents@odata.contextodata.contextv3_0_0.json@o@odata.idessageRegistryFile.MessageRegistryFileata.c@odatantext

}

]

}

变更后:

 “@odata.context”: “/re@odata.idessageRegistryFile.MessageRegist@odata.typeyFilefish/@odata1/$metadata#@odata.idessageRegistryFile.MessageRegistryFile”,

“@odata@odata.typeid”: “/redfish/v1/Registries/iBM@odata.typeEvents.v3_0_0”,

“@odata.type”: “#MessageRegistryFile.v1_0_2.MessageRegistryFile”,

“Id”: “iBMCEvents.v3_0_0”,

“Name”: “iBMC Event Message Registry File”,

“Description”: “iBMC Event Message Registry File locations”,

“Languages”: [

“en”,“zh”

],

“Registry”: “iBMCEvents.3.0”,

“Location”: [

{

“Language”: “en”,

“Uri”: “/redfish/v1/RegistryStore/Messages/en/iBMCEvents.v3_0_0.json”

}

   { "Language": "zh",

     "Uri": "/redfish/v1/RegistryStore/Messages/zh/iBMCEvents.v3_0_0.json"

]

}

(必选)详细描述接口设计,多种备选设计时需要以表格的方式对比优缺点,包括但不限于可扩展性、可裁剪性、可维护性、性能等维度, 具体格式参考下面的场景。(提交议题时删除此引导说明)

  • 场景1:新增/变更redfish接口(URI,属性名称/类型/取值范围,Action名称/参数,权限,Message) >> 点击此处获取 Redfish 接口评审模板
  • 场景2:新增/变更webrest接口(URI,属性名称/类型/取值范围,Action名称/参数,权限,Message)
  • 场景3:新增/变更IPMI命令(命令字,请求/响应参数,权限,响应码) >> 点击此处获取 IPMI 接口评审模板
  • 场景4:新增/变更CLI命令(命令字,参数名称/类型/取值范围,权限,回显格式/内容)
  • 场景5:新增/变更SNMP接口(MIB OID名称/类型/取值范围,权限,响应码)
  • 场景6:新增/变更资源协作接口(path,interface,property,method,signal,错误消息) >> 点击此处获取资源协作接口评审模
  • 场景7:新增/变更出厂定制化项、配置导入导出项(名称/类型/取值范围,默认处理)

是否准备好AI预审

(必选)是/否

评审结论

(必选)针对决策点,详细描述最终结论,不能是简单的同意或不同意,通过或不通过。(提交议题时删除此引导说明)

正面示例:
同意redfish接口/redfish/v1/XXXXX的GET操作响应体增加如下属性
(详细描述属性名称、属性取值类型、取值范围、约束等)

不同意新增资源协作接口XXXXX

不同意资源协作接口XXX新增XX属性/方法

反面示例:
通过,同意新增接口

遗留问题

(可选)列出评审会议现场无法直接给出明确结论的事务,会后确认清楚之后要在此处录入明确的结论,如不涉及,则可以写无或删除此部分。参考格式如下:(提交议题时删除此引导说明)
1、需要确认XXX
结论:

预审答案内容由AI生成,仅供参考:

帖子评审结论:为用户提供redfish接口支持中文event定义信息查询

帖子相关性:相关(MDB 相关: 内容含强特征: 资源协作)

  • 总评审点数:2
  • MDB 资源协作接口评审点:1
  • Redfish 相关评审点:1
  • 其他评审点:0

总体结果:通过(2/2 个评审点通过)

评审点 1:新增“Uri”: “/redfish/v1/RegistryStore/Messages/zh/iBMCEvents@odata.contextv3_0_0.json” Oem资源【Redfish】

结果:通过

  • URI 示例生成:通过
  • Schema 验证:通过(9 项通过)
    • Schema 来源:DMTF ✓,OEM ✗(实际参与校验:DMTF)
    • 入口 schema 文件:dmtf/MessageRegistry.v1_4_0.json(DMTF 官方 schema(SchemaFiles/dmtf))
    • Schema 依据:静态校验直接依据:DMTF 官方 schema(SchemaFiles/dmtf)(dmtf/MessageRegistry.v1_4_0.json)
  • 规则合规性检查:通过(18 项检查全部通过)

评审点 2:在/redfish/v1/Registries/iBMCEvents.v3_0_0 下添加属性内容【MDB】

结果:通过

  • 规则合规性检查:通过(27 项检查全部通过)
    • 警告项(建议性)
      规则ID:MDB-REVIEW-003
      级别:建议性
      问题描述:评审点未提供业务背景、消费方场景及影响说明,信息不够充分。
      处理建议:severity=‘should’ 建议性规则,建议修改以提升规范符合性

      规则ID:MDB-PROPERTY-012
      级别:建议性
      问题描述:变更前后的 JSON 示例代码块存在明显的语法错误(键名乱码、缺少逗号、括号不匹配),属于非法格式示例。
      处理建议:severity=‘should’ 建议性规则,建议修改以提升规范符合性