代码仓
中
文档中心
ThermalSubsystem
更新时间： 2026/06/26
在AtomGit上查看源码

ResourceDefinition ​

uris ​

  • /redfish/v1/Chassis/chassis_id/ThermalSubsystem
  • /redfish/v1/Chassis/chassis_id/ThermalSubsystem/Actions/Oem/{{OemIdentifier}}/ThermalControlUnitGroup.SetExpectedSpeedPercent

properties ​

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-散热资源模型的OData描述信息
@odata.idstringtrue-散热资源的访问路径
@odata.typestringtrue-散热资源的类型
Idstringtrue-散热资源ID
Namestringtrue-散热资源名称
Oem {objecttrue-自定义属性
Oem.Public {objecttrue-自定义属性
Oem.Public.LiquidSpeedAdjustmentModestringfalse-液冷设备调速模式，包括：
● Automatic：自动
● Manual：手动
● Mixed：混合
Oem.Public.LiquidCoolingUnitsLevelnumberfalse-液冷设备转速百分比
Oem.Public.LiquidManualModeTimeoutSecondsnumberfalse-液冷设备手动模式持续时间 说明 已屏蔽该属性值频繁变化导致的事件上报
Oem.Public.FanSpeedDeviationThresholdPercentnumberfalse-风扇转速偏差阈值
Oem.Public.ThermalControlUnitGroup {objecttrue-热控单元组
Oem.Public.ThermalControlUnitGroup.FanGroups [ {arraytrue-指定风扇组对象
Oem.Public.ThermalControlUnitGroup.FanGroups[].GroupIdnumbertrue-指定具体风扇组
Oem.Public.ThermalControlUnitGroup.FanGroups[].ExpectedSpeedPercentnumbertrue-指定风扇组内风扇转速
Oem.Public.ThermalControlUnitGroup.FanGroups[].Fans[ ]arraytrue-风扇Id数组，关联具体风扇资源
Oem.Public.ThermalControlUnitGroup.FanGroups[].Fans[].@odata.idstringtrue-成员资源节点的访问路径
} ]
} ]
Oem.Public.ThermalControlUnitGroup.PumpGroups [ {arraytrue-指定泵组对象
Oem.Public.ThermalControlUnitGroup.PumpGroups[].GroupIdnumbertrue-指定具体泵组
Oem.Public.ThermalControlUnitGroup.PumpGroups[].ExpectedSpeedPercentnumbertrue-指定泵组内泵转速
Oem.Public.ThermalControlUnitGroup.PumpGroups[].Pumps[ ]arraytrue-泵Id数组，关联具体泵资源
Oem.Public.ThermalControlUnitGroup.PumpGroups[].Pumps[].@odata.idstringtrue-成员资源节点的访问路径
} ]
} ]
}
}
}
Fans {objecttrue-风扇Id数组，关联具体风扇资源
Fans.@odata.idstringtrue-Fans资源的访问路径
}
Actions {objecttrue-Redfish允许的散热资源可执行操作
Actions.Oem {objecttrue-自定义属性
Actions.Oem.{{OemIdentifier}} {objecttrue-自定义操作信息
Actions.Oem.{{OemIdentifier}}.#ThermalControlUnitGroup.SetExpectedSpeedPercent {objecttrue-设置期望转速百分比操作
Actions.Oem.{{OemIdentifier}}.#ThermalControlUnitGroup.SetExpectedSpeedPercent.@redfish.Actioninfostringtrue-设置期望转速百分比操作的查询路径
Actions.Oem.{{OemIdentifier}}.#ThermalControlUnitGroup.SetExpectedSpeedPercent.targetstringtrue-操作路径
}
}
}
}
CoolantConnectorRedundancy[ ]arraytrue-本子系统中冷却器连接器的冗余信息 。该属性应包含连接到此设备的冷却器连接器集合的冗余信息， 冗余组数组内的值需引用冷却器连接器类型的资源。 说明 BMC500 5.13.0及以上版本支持。
Status {objecttrue-指定泵传感器的状态，包括：
● State：泵传感器是否使能
● Health：泵传感器健康状态 说明 配置为标准泵资源时不显示该对象
Status.Healthstringtrue-散热服务健康状态
Status.Statestringtrue-散热的内存的在位状态
}
@odata.idstringtrue-风扇集合资源的访问路径
Pumps [ {arraytrue-泵Id数组，关联具体泵资源
Pumps[].PartNumbernumbertrue-指定泵的部件号 说明 配置为标准泵资源时不显示该属性
Pumps[].PumpSpeedPercent {objecttrue-指定泵传感器的转速，包括：
● Reading：泵的速率比，单位Percent
● SpeedRPM：泵传感器的当前读数 说明 已屏蔽该属性及其子属性频繁变化导致的事件上报，配置为标准泵资源时不显示该对象
Pumps[].PumpSpeedPercent.Readingnumbertrue-泵转速读数
Pumps[].PumpSpeedPercent.SpeedRPMnumbertrue-泵转速（RPM）
}
Pumps[].Status {objecttrue-散热资源的状态，包括State：散热资源是否使能Health：散热资源的健康状态
Pumps[].Status.Healthstringtrue-散热资源的健康状态，包括：
● OK：正常
● Warning：警告
● Critical：严重
● null
Pumps[].Status.Statestringtrue-散热的内存的在位状态
}
Pumps[].@odata.idstringtrue-泵资源访问路径
Pumps[].@odata.typestringtrue-泵的资源类型
Pumps[].Idstringtrue-泵Id
Pumps[].Namestringtrue-泵名称
} ]
FanRedundancy [ {arraytrue-冗余风扇组
FanRedundancy[].RedundancyTypestringtrue-冗余类型
FanRedundancy[].MaxSupportedInGroupnumbertrue-组内最大支持数
FanRedundancy[].MinNeededInGroupnumbertrue-组内最小需求数
FanRedundancy[].RedundancyGroup[ ]arraytrue-冗余风扇组的风扇资源链接的集合
FanRedundancy[].RedundancyGroup[].@odata.idstringtrue-风扇资源的访问路径
} ]
FanRedundancy[].Status {objecttrue-冗余风扇组的状态，包括State:：冗余风扇组是否使能Health：冗余风扇组的健康状态
FanRedundancy[].Status.Healthstringtrue-散热资源的健康状态，包括：
● OK：正常
● Warning：警告
● Critical：严重
● null
FanRedundancy[].Status.Statestringtrue-散热的内存的在位状态
}
} ]
ThermalMetrics {objecttrue-热量指标的链接
ThermalMetrics.@odata.idstringtrue-热量指标资源的访问路径
}

supported_methods ​

  • GET
  • PATCH
  • POST

HTTP methods ​

GET ​

命令功能

查询指定机箱泵资源信息

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/ThermalSubsystem

请求头:


X-Auth-Token: 123456789***********************

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
chassis_id机箱资源的ID● 针对机架服务器，取值 为1
● 针对高密服务器，取值 为BladeN（N表示节点 槽位号），例如 “Blade1”
● 针对刀片服务器，取值 可以为BladeN（N表示 计算节点槽位号）或 SwiN（N表示交换模块 槽位号），例如 “Swi1”
● 针对X6800 V5，X6000 V5，G5500，XA320 V2 服务器，取值还可以为 Enc，表示计算节点所在 的机框资源
● 针对设备U位信息，取 值可以为UN(N表示设 备U位号)，例如"U1"
● 针对机柜资源，取值为 Rack
auth_value执行该GET请求时，必须在 “Headers”中携带“X- Auth-Token”值用于鉴权可通过/redfish/v1/ SessionService/Sessions 创建会话时获得

使用指南

无

使用实例

请求样例：

http
GET https://device_ip/redfish/v1/Chassis/1/ThermalSubsystem

请求头：


X-Auth-Token: 123456789***********************

请求消息体：无

响应样例：

json
{
  "@odata.context": "/redfish/v1/$metadata#ThermalSubsystem.ThermalSubsystem",
  "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem",
  "@odata.type": "#Thermal.v1_2_0.ThermalSubsystem",
  "Id": "ThermalSubsystem",
  "Name": "ThermalSubsystem",
  "Actions": {
    "Oem": {
      "{{OemIdentifier}}": {
        "#ThermalControlUnitGroup.SetExpectedSpeedPercent": {
          "target": "/redfish/v1/Chassis/1/ThermalSubsystem/Actions/Oem/{{OemIdentifier}}/ThermalControlUnitGroup.SetExpectedSpeedPercent",
          "@redfish.Actioninfo": "/redfish/v1/Chassis/1/ThermalSubsystem/Actions/Oem/{{OemIdentifier}}/SetExpectedSpeedPercentActionInfo"
        }
      }
    }
  },
  "CoolantConnectorRedundancy": [],
  "Oem": {
    "Public": {
      "LiquidSpeedAdjustmentMode": "Automatic",
      "LiquidCoolingUnitsLevel": 25,
      "LiquidManualModeTimeoutSeconds": 30,
      "ThermalControlUnitGroup": {
        "FanGroups": [
          {
            "ExpectedSpeedPercent": 55,
            "GroupId": 1,
            "Fans": [
              {
                "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Fans/1"
              },
              {
                "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Fans/2"
              }
            ]
          }
        ],
        "PumpGroups": [
          {
            "ExpectedSpeedPercent": 55,
            "GroupId": 1,
            "Pumps": [
              {
                "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Pumps/1"
              },
              {
                "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Pumps/2"
              }
            ]
          }
        ]
      },
      "FanSpeedDeviationThresholdPercent": 25
    }
  },
  "Pumps": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem#/Pumps/1",
      "@odata.type": "#Pump.v1_2_0.Pump",
      "Id": "1",
      "Name": "Pump1",
      "PartNumber": 32060001,
      "Status": {
        "Health": "OK",
        "State": "Enabled"
      },
      "PumpSpeedPercent": {
        "Reading": 80,
        "SpeedRPM": 4800
      }
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem#/Pumps/2",
      "@odata.type": "#Pump.v1_2_0.Pump",
      "Id": "2",
      "Name": "Pump2",
      "PartNumber": 32060001,
      "Status": {
        "Health": "OK",
        "State": "Enabled"
      },
      "PumpSpeedPercent": {
        "Reading": 80,
        "SpeedRPM": 4800
      }
    }
  ],
  "FanRedundancy": [
    {
      "RedundancyType": "NotRedundant",
      "MaxSupportedInGroup": 2,
      "MinNeededInGroup": 2,
      "RedundancyGroup": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Fans/1"
        },
        {
          "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Fans/2"
        }
      ],
      "Status": {
        "State": "Enabled",
        "Health": "OK"
      }
    },
    {
      "RedundancyType": "NotRedundant",
      "MaxSupportedInGroup": 2,
      "MinNeededInGroup": 2,
      "RedundancyGroup": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Fans/3"
        },
        {
          "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Fans/4"
        }
      ],
      "Status": {
        "State": "Enabled",
        "Health": "OK"
      }
    }
  ],
  "Fans": {
    "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Fans"
  },
  "ThermalMetrics": {
    "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/ThermalMetrics"
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  }
}

响应码：200

PATCH ​

命令功能

修改指定机箱泵资源信息

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/ThermalSubsystem

请求头:


X-Auth-Token: 123456789***********************
Content-Type: header_type
If-Match: ifmatch_value

请求消息体:

json
{
  "Oem": {
    "Public": {
      "LiquidSpeedAdjustmentMode": liquid_model_value,
      "LiquidCoolingUnitsLevel": liquid_percent_value,
      "LiquidManualModeTimeoutSeconds": liquid_manual_sencond,
      "FanSpeedDeviationThresholdPercent": fan_speed_deviation_threshold_percent
    }
  }
}

URL参数说明

参数参数说明取值
chassis_id机箱资源的ID● 针对机架服务器，取值 为1
● 针对高密服务器，取值 为BladeN（N表示节点 槽位号），例如 “Blade1”
● 针对刀片服务器，取值 可以为EBladeN（N表示 计算节点槽位号）或 SwiN（N表示交换模块 槽位号），例如 “Swi1”
● 针对X6800 V5，X6000 V5，G5500，XA320 V2 服务器，取值还可以为 Enc，表示计算节点所在 的机框资源
● 针对设备U位信息，取 值可以为UN(N表示设 备U位号)，例如"U1"
● 针对机柜资源，取值为 Rack

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
LiquidSpeedAdjustmentMode液冷设备调速模式液冷设备调速模式，包 括：
● Automatic
● Manual
LiquidCoolingUnitsLevel液冷设备转速百分比不支持小数
LiquidManualModeTimeoutSeconds液冷设备手动模式持续时间支持设置范围：0 ~ 100000000（不支持小 数）
FanSpeedDeviationThresholdPercent风扇转速偏差阈值支持设置范围：10 ~100 （不支持小数）

使用指南

无

使用实例

请求样例：

http
PATCH https://device_ip/redfish/v1/Chassis/1/ThermalSubsystem

请求头：


X-Auth-Token: 123456789***********************
Content-Type: application/json
If-Match: W/"3d607e36"

请求消息体：

json
{
  "Oem": {
    "Public": {
      "LiquidSpeedAdjustmentMode": "Manual",
      "LiquidCoolingUnitsLevel": 50,
      "LiquidManualModeTimeoutSeconds": 30,
      "FanSpeedDeviationThresholdPercent": 30
    }
  }
}

响应样例：

json
{
  "@odata.context": "/redfish/v1/$metadata#ThermalSubsystem.ThermalSubsystem",
  "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem",
  "@odata.type": "#Thermal.v1_2_0.ThermalSubsystem",
  "Id": "ThermalSubsystem",
  "Name": "ThermalSubsystem",
  "Oem": {
    "Public": {
      "LiquidSpeedAdjustmentMode": "Manual",
      "LiquidCoolingUnitsLevel": 50,
      "LiquidManualModeTimeoutSeconds": 30,
      "FanSpeedDeviationThresholdPercent": 30
    }
  },
  "Pumps": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem#/Pumps/1",
      "@odata.type": "#Pump.v1_2_0.Pump",
      "Id": "1",
      "Name": "Pump1",
      "PartNumber": 32060001,
      "Status": {
        "Health": "OK",
        "State": "Enabled"
      },
      "PumpSpeedPercent": {
        "Reading": 80,
        "SpeedRPM": 4800
      }
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem#/Pumps/2",
      "@odata.type": "#Pump.v1_2_0.Pump",
      "Id": "2",
      "Name": "Pump2",
      "PartNumber": 32060001,
      "Status": {
        "Health": "OK",
        "State": "Enabled"
      },
      "PumpSpeedPercent": {
        "Reading": 80,
        "SpeedRPM": 4800
      }
    }
  ]
}

响应码：200

POST (ACTION) ​

SetExpectedSpeedPercent ​

命令功能

设置风扇组、泵组转速批量下发

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/ThermalSubsystem/Actions/Oem/{{OemIdentifier}}/ThermalControlUnitGroup.SetExpectedSpeedPercent 请求头:


X-Auth-Token: 123456789***********************
Content-Type: header_type

请求消息体:

json
{
  "GroupId": 1,
  "ExpectedSpeedPercent": 55
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
FanGroups数组指定的风扇组对象
GroupId数字指定的具体风扇组
ExpectedSpeedPerce nt数字指定的风扇组内风扇转速
PumpGroups数组指定的泵组对象
GroupId数字指定的具体泵组
ExpectedSpeedPerce nt数字指定的泵组内泵转速，FanGroups 的ExpectedSpeedPercent范围为 [20,100],PumpGroups的 ExpectedSpeedPercent范围为 [25,100]
chassis_id机箱资源的ID● 针对机架服务器，取值为1
● 针对高密服务器，取值为 BladeN（N表示节点槽位 号），例如“Blade1”
● 针对刀片服务器，取值可以为 BladeN（N表示计算节点槽位 号）或SwiN（N表示交换模块 槽位号），例如“Swi1”
● 针对X6800 V5，X6000 V5， G5500，XA320 V2服务器， 取值还可以为Enc，表示计算 节点所在的机框资源
● 针对设备U位信息，取值可以 为UN(N表示设备U位号)，例 如"U1"
● 针对机柜资源，取值为Rack

使用指南

无

使用实例

请求样例： https://device_ip/redfish/v1/Chassis/chassis_id/ThermalSubsystem/Actions/Oem/{{OemIdentifier}}/ThermalControlUnitGroup.SetExpectedSpeedPercent

请求头：


X-Auth-Token: auth_value
Content-Type: header_type

请求消息体： "Oem": { "{{OemIdentifier}}": { "ThermalControlUnitGroup":{ "FanGroups": [

json
{
  "GroupId": 1,
  "ExpectedSpeedPercent": 55
}

{ "GroupId":2, "ExpectedSpeedPercent": 60 } ], "PumpGroups": [ { "GroupId":1, "ExpectedSpeedPercent": 55 }, { "GroupId":2, "ExpectedSpeedPercent": 60 } ] } } } 响应样例：

json
{
  "error": {
    "code": "Base.1.0.GeneralError",
    "message": "A general error has occurred. See ExtendedInfo for more information.",
    "@Message.ExtendedInfo": [
      {
        "@odata.type": "#Message.v1_0_0.Message",
        "MessageId": "Base.1.0.Success",
        "RelatedProperties": [],
        "Message": "Successfully Completed Request",
        "MessageArgs": [],
        "Severity": "OK",
        "Resolution": "None"
      }
    ]
  }
}

响应码：200

下一篇探索openUBMC