ResourceDefinition

uris

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

properties

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

supported_methods

GET
PATCH
POST

HTTP methods

GET

命令功能

查询指定机箱泵资源信息

命令格式

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

请求头:

text


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>

请求头：

text


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

请求头:

text


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>

请求头：

text


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 请求头:

text


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

请求消息体:

json

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

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
FanGroups	数组	指定的风扇组对象
GroupId	数字	指定的具体风扇组
ExpectedSpeedPercent	数字	指定的风扇组内风扇转速
PumpGroups	数组	指定的泵组对象
GroupId	数字	指定的具体泵组
ExpectedSpeedPercent	数字	指定的泵组内泵转速，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

请求头：

text


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

请求消息体：

json

"Oem": {
"{{OemIdentifier}}": {
"ThermalControlUnitGroup":{
"FanGroups":
[
{
"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

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

PATCH ​

POST (ACTION) ​

SetExpectedSpeedPercent ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

PATCH

POST (ACTION)

SetExpectedSpeedPercent