代码仓
中
文档中心
AlgorithmsEngine
更新时间： 2026/09/24
在AtomGit上查看源码

ResourceDefinition ​

uris ​

  • /redfish/v1/Chassis/chassis_id/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine

properties ​

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-智能调速算法配置状态集合资源的OData描述信息
@odata.idstringtrue-智能调速算法配置状态集合资源的访问路径
@odata.typestringtrue-智能调速算法配置状态集合资源的类型
Idstringtrue-智能调速算法配置状态集合资源Id
Namestringtrue-智能调速算法配置状态集合资源名称
AlgorithmsList [ {arraytrue--
AlgorithmsList.AlgorithmTypestringtrue-● 枚举值，智能调速算法类型
● MPC：模型预测控制算法
AlgorithmsList.AlgorithmStatusstringtrue-● 枚举值，该字段需要根据AlgorithmType显示，表示对应算法的算法生效状态
● MPC算法状态取值范围：
● Disabled：功能已关闭
● Initialized：功能已完成初始化
● Training：模型正在训练
● Available：模型可用
● Unavailable：模型不可用
AlgorithmsList.CustomConfigurations {objecttrue--
AlgorithmsList.CustomConfigurations.TrainSetstringtrue-● 枚举值，该字段需要根据AlgorithmType显示，表示对应算法的训练集生效状态
● Default：未导入用户训练集，使用默认值
● Pending：用户训练集待生效
● Effective：用户训练集已生效
}
} ]
Actions {objecttrue--
Actions.#AlgorithmsEngine.Import {objecttrue--
Actions.#AlgorithmsEngine.Import.targetstringtrue--
Actions.#AlgorithmsEngine.Import.@Redfish.ActionInfostringtrue--
}
Actions.#AlgorithmsEngine.ResetToDefaults {objecttrue--
Actions.#AlgorithmsEngine.ResetToDefaults.targetstringtrue--
Actions.#AlgorithmsEngine.ResetToDefaults.@Redfish.ActionInfostringtrue--
}
}

supported_methods ​

  • GET
  • POST

HTTP methods ​

GET ​

命令功能

查询智能调速算法配置生效状态资源信息

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine

请求头:

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创建会话时获得

使用指南

BMC500 5.14.0及以上版本支持。

使用实例

请求样例：

http
GET https://device_ip/redfish/v1/Chassis/1/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine

请求头：

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

请求消息体：无

响应样例：

json
{ 
    "@odata.context": "/redfish/v1/$metadata#AlgorithmsEngine.AlgorithmsEngine", 
    "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine", 
    "@odata.type": "#AlgorithmsEngine.v1_0_0.AlgorithmsEngine", 
    "Id": "AlgorithmsEngine", 
    "Name": "Algorithms Engine", 
    "AlgorithmsList": [ 
        { 
            "AlgorithmType": "MPC", 
            "CustomConfigurations": { 
                "TrainSet": "Default" 
            }, 
            "AlgorithmStatus": "Available" 
        } 
    ], 
    "Actions": { 
        "#AlgorithmsEngine.Import": { 
            "target": "/redfish/v1/Chassis/1/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine/Actions/AlgorithmsEngine.Import", 
            "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine/ImportActionInfo" 
        }, 
        "#AlgorithmsEngine.ResetToDefaults": { 
            "target": "/redfish/v1/Chassis/1/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine/Actions/AlgorithmsEngine.ResetToDefaults", 
            "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine/ResetToDefaultsActionInfo" 
        } 
    } 
}

响应码：200

POST (ACTION) ​

Import ​

命令功能

导入智能调速算法相关配置。

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine/Actions/AlgorithmsEngine.Import

请求头:

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

请求消息体:

json
{ 
    "AlgorithmType": algorithm_type, 
    "ConfigType": config_type, 
    "ConfigURI": config_uri 
 }

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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创建会话时获得
algorithm_type枚举值，导入的算法类型MPC：模型控制预测算法
config_type枚举值，导入的配置类型TrainSet：模型训练数据
config_uri导入配置文件路径● 操作路径
● 本地导入："/tmp/web/文件名"
● 远程导入："文件传输协议://用户名:密码@ip地址/目录/文件名"
● 文件传输协议包括五种：sftp、https、nfs、cifs、scp
● 导入TrainSet 训练集， 导入文件必须为csv格式， 所有训练数据必须一次性导入，训练数据打包为 单个 ZIP 压缩包，示例：“data.zip”

使用指南

BMC500 5.14.0及以上版本支持。

使用实例

请求样例：

http
POST https://device_ip/redfish/v1/Chassis/chassis_id/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine/Actions/AlgorithmsEngine.Import

请求头：

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

请求消息体：

{ 
    "AlgorithmType": "MPC", 
    "ConfigType": "TrainSet", 
    "ConfigURI": "/tmp/web/data/zip" 
 }

响应样例：

json
{ 
    "@odata.context": "/redfish/v1/$metadata#Task.Task", 
    "@odata.type": "#Task.v1_7_4.Task", 
    "@odata.id": "/redfish/v1/TaskService/Tasks/1", 
    "Id": "1", 
    "Name": "ImportMPC", 
    "Description": "", 
    "TaskState": "Running", 
    "TaskStatus": "OK", 
    "StartTime": "2026-05-07T16:26:29+00:00", 
    "Messages": [], 
    "PercentComplete": null, 
    "Oem": { 
        "openUBMC": { 
            "TaskPercentage": null 
        } 
    } 
}

响应码：202

POST (ACTION) ​

ResetToDefaults ​

命令功能

恢复智能调速算法相关配置。

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine/Actions/AlgorithmsEngine.ResetToDefaults

请求头:

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

请求消息体:

json
{ 
    "AlgorithmType": algorithm_type, 
    "ResetType": reset_type 
 }

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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创建会话时获得
algorithm_type枚举值，恢复的算法类型MPC：模型控制预测算法
reset_type枚举值，恢复的配置类型ResetAll：恢复所有配置为默认值

使用指南

BMC500 5.14.0及以上版本支持。

使用实例

请求样例：

http
POST https://device_ip/redfish/v1/Chassis/chassis_id/ThermalSubsystem/Oem/openUBMC/AlgorithmsEngine/Actions/AlgorithmsEngine.ResetToDefaults

请求头：

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

请求消息体：

{ 
    "AlgorithmType": "MPC", 
    "ResetType": "ResetAll" 
 }

响应样例：

json
{ 
    "@odata.context": "/redfish/v1/$metadata#Task.Task", 
    "@odata.type": "#Task.v1_7_4.Task", 
    "@odata.id": "/redfish/v1/TaskService/Tasks/1", 
    "Id": "1", 
    "Name": "ResetToDefaults", 
    "Description": "", 
    "TaskState": "Running", 
    "TaskStatus": "OK", 
    "StartTime": "2026-05-07T13:05:23+00:00", 
    "Messages": [], 
    "PercentComplete": null, 
    "Oem": { 
        "openUBMC": { 
            "TaskPercentage": null 
        } 
    } 
}

响应码：202

下一篇探索openUBMC