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	-	散热资源名称
LiquidSpeedAdjustmentMode	string	false	-	液冷设备调速模式，包括： ● Automatic ● Manual ● Mixed
LiquidCoolingUnitsLevel	number	false	-	液冷设备转速百分比
LiquidManualModeTimeoutSeconds	number	false	-	液冷设备手动模式持续时间说明已屏蔽该属性值频繁变化导致的事件上报
FanSpeedDeviationThresholdPercent	int	false	-	风扇转速偏差阈值
@odata.id	string	true	-	指定泵传感器的访问路径说明配置为标准泵资源时为泵集合资源的访问路径
@odata.type	string	true	-	指定泵传感器的类型说明配置为标准泵资源时不显示该属性
Id	number	true	-	指定泵传感器的ID 说明配置为标准泵资源时不显示该属性
Name	string	true	-	指定泵传感器的名称说明配置为标准泵资源时不显示该属性
CoolantConnectorRedundancy	array	true	-	本子系统中冷却器连接器的冗余信息。该属性应包含连接到此设备的冷却器连接器集合的冗余信息，冗余组数组内的值需引用冷却器连接器类型的资源。说明 BMC500 5.13.0及以上版本支持。
PartNumber	string	true	-	指定泵的部件号说明配置为标准泵资源时不显示该属性
Status	object	true	-	指定泵传感器的状态，包括： ● State：泵传感器是否使能 ● Health：泵传感器健康状态说明配置为标准泵资源时不显示该对象
PumpSpeedPercent	object	true	-	指定泵传感器的转速，包括： ● Reading：泵的速率比，单位Percent ● SpeedRPM：泵传感器的当前读数说明已屏蔽该属性及其子属性频繁变化导致的事件上报，配置为标准泵资源时不显示该对象
@odata.id	string	true	-	风扇集合资源的访问路径
ThermalControlUnitGroup	object	true	-	热控单元组
FanGroups	array	true	-	指定风扇组对象
GroupId	number	true	-	指定具体风扇组
Fans	array	true	-	风扇Id数组，关联具体风扇资源
ExpectedSpeedPercent	number	true	-	指定风扇组内风扇转速
PumpGroups	array	true	-	指定泵组对象
GroupId	number	true	-	指定具体泵组
Pumps	array	true	-	泵Id数组，关联具体泵资源
ExpectedSpeedPercent	number	true	-	指定泵组内泵转速
FanRedundancy	array	true	-	冗余风扇组
RedundancyType	string	true	-	冗余类型
MaxSupportedInGroup	int	true	-	组内最大支持数
MinNeededInGroup	int	true	-	组内最小需求数
RedundancyGroup	array	true	-	冗余风扇组的风扇资源链接的集合
@odata.id	string	true	-	风扇资源的访问路径
Status	string	true	-	冗余风扇组的状态，包括State:：冗余风扇组是否使能Health：冗余风扇组的健康状态
ThermalMetrics	object	true	-	热量指标的链接
@odata.id	string	true	-	热量指标资源的访问路径
Status	object	true	-	散热资源的状态，包括State：散热资源是否使能Health：散热资源的健康状态

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
    }
  }
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
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
liquid_model_value	液冷设备调速模式	液冷设备调速模式，包括： ● Automatic ● Manual
liquid_percent_value	液冷设备转速百分比	不支持小数
liquid_manual_sencon d	液冷设备手动模式持续时间	支持设置范围：0 ~ 100000000（不支持小数）
fan_speed_deviation_t hreshold_percent	风扇转速偏差阈值	支持设置范围：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

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

PATCH ​

POST (ACTION) ​

SetExpectedSpeedPercent ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

PATCH

POST (ACTION)

SetExpectedSpeedPercent