【已评审】新增redfish接口属性支持查询和设置风扇转速偏差阈值

Interface SIG Interface评审
1

背景

当前“风扇转速偏差大”告警的阈值固定为25（百分比），客户希望可以通过redfish接口实现风扇转速偏差大阈值的查询和设置，需要提供相应redfish属性及设置接口

关联ISSUE

支持风扇转速告警阈值查询和设置能力

评审点

redfish接口新增属性支持查询和设置风扇转速偏差阈值

详细描述

1 、redfish接口新增属性查询风扇转速偏差阈值

URI：/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem

变化类型：新增属性

操作类型：GET

权限：ReadOnly

应用场景：redfish接口查询风扇转速偏差阈值

属性名称 取值类型 说明 取值范围 默认值 操作权限 是否频繁变化并需要屏蔽变化事件 约束
FanSpeedDeviationThresholdPercent integer 风扇转速偏差阈值 [10,100] 25 ReadOnly 否

响应示例：

{
    "@odata.context": "/redfish/v1/$metadata#ThermalSubsystem.ThermalSubsystem",
    "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem",
    "@odata.type": "#ThermalSubsystem.v1_3_2.ThermalSubsystem",
    ...

    "Oem": {
        "openUBMC": {
            "LiquidSpeedAdjustmentMode": null,
            "LiquidCoolingUnitsLevel": null,
            "LiquidManualModeTimeoutSeconds": null,
            "ThermalControlUnitGroup": {
                "FanGroups": [],
                "PumpGroups": []
            },
           "FanSpeedDeviationThresholdPercent": 25
        }
    },
    ...
    "ThermalMetrics": {
        "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/ThermalMetrics"
    },
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    }
}

2、redfish接口新增属性设置风扇转速偏差阈值

URI：/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem

变化类型：新增请求体参数

操作类型：PATCH

权限：BasicSetting

应用场景：redfish接口设置风扇转速偏差阈值

属性名称 取值类型 说明 取值范围 默认值 操作权限 是否频繁变化并需要屏蔽变化事件 约束
FanSpeedDeviationThresholdPercent integer 风扇转速偏差阈值 [10,100] 25 BasicSetting 否

请求体示例：

{
    "Oem": {
        "openUBMC": {
           "FanSpeedDeviationThresholdPercent": 15
        }
    }
}

schema说明：

{
    "Oem{{OemIdentifier}}": {
        "type": "object",
        "properties": {
            "FanSpeedDeviationThresholdPercent": {
              "type": "integer",
              "minimum": 10,
              "maximum": 100,
              "readonly": false，
              "description": "Threshold for fan speed deviation."，
              "longDescription": "This attribute specifies the threshold for fan speed deviation."
            }
        }
    }
}

评审结论

同意redfish接口新增OEM属性支持查询和设置风扇转速偏差阈值

uri：/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem
操作类型：GET、PATCH
变化类型：新增Oem属性

  • FanSpeedDeviationThresholdPercent：表示风扇转速偏差告警阈值，类型为integer，取值范围：10~100，GET权限：ReadOnly，PATCH权限：BasicSetting

遗留问题

无