【待评审】新增的中文接口是否沿用原本英文接口的逻辑

背景

在支持运维管理软件通过BMC Redfish接口获取中文事件定义的过程中,当前新增的中文接口在“告警等级(Severity)”字段的呈现逻辑上,与公司内部规范存在差异。本评审旨在确定该字段的最终映射方案,保证接口设计的合理性和长期维护性

关联ISSUE

暂无

整体方案

本次新增中文事件定义查询接口,整体架构与现有英文接口保持一致,通过 /redfish/v1/RegistryStore/Messages/zh/{{SoftwareName}}Events.:id 提供中文资源。核心争议点在于 Severity(严重等级)属性的值域定义:

  • Redfish标准定义:仅支持 “OK”, “Warning”, “Critical” 三种枚举值。

  • 公司内部规范:定义了 “OK”, “Minor”, “Major”, “Critical” 四种等级。

  • 现有英文接口:将内部规范的 MinorMajor 均映射为Redfish标准的 “Warning”,实际对外呈现3种等级。

  • 当前中文接口实现:沿用了英文接口的映射逻辑,中文对应展示为 “正常”, “严重”, “紧急” 三种等级。

测试团队提出:中文接口未按公司内部4级规范呈现,存在不一致。

方案一:保持现有3级映射逻辑

方案一:按测试要求与公司的告警级别对齐

评审点

redfish接口中事件告警等级中文版的映射逻辑是否需要修改

详细描述

现状与冲突分析

来源 定义的等级 说明
Redfish 规范 OK, Warning, Critical 标准枚举,不可扩展
公司内部告警规范 OK, Minor, Major, Critical 业务侧定义的4级分类
现有英文接口 映射为 OK, Warning, Critical Minor/Major 统一归为 Warning
新增中文接口(当前实现) 映射为 “正常”, “严重”, “紧急” 与英文接口逻辑一致,对应3种中文

方案一:保持现有3级映射逻辑

方案二:按测试要求与公司的告警级别对齐

本项目提出如下两种备选方案,需评审组决策:

对比项 方案一(保持现有逻辑) 方案二(对齐公司规范)
等级数 3级 4级
中文展示 正常 / 严重 / 紧急 正常 / 轻微 / 严重 / 紧急
Redfish规范符合度 符合,使用标准枚举 不符合,使用非标准枚举
与现有英文接口一致性 完全一致 不一致,相同告警等级展示不同
字段映射逻辑 Minor/MajorWarning MinorMinorMajorMajor
实现改动点 无需改动 需修改中文接口映射逻辑及文档

是否准备好AI预审

评审结论

遗留问题

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

帖子评审结论:新增的中文接口是否沿用原本英文接口的逻辑

帖子相关性:相关(Redfish 相关: 帖子内容包含 ‘redfish’ 关键字)

  • 总评审点数:1
  • Redfish 相关评审点:1
  • 其他评审点:0

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

评审点 1:redfish接口中事件告警等级中文版的映射逻辑是否需要修改【Redfish】

结果:通过

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