文档中心
PowerSubsystem
更新时间： 2026/06/26
在Gitcode上查看源码

ResourceDefinition ​

uris ​

  • /redfish/v1/Chassis/chassis_id/PowerSubsystem

properties ​

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-电源子系统模型的OData描述信息
@odata.idstringtrue-电源子系统的访问路径
@odata.typestringtrue-电源子系统的类型
Idstringtrue-电源子系统ID
Namestringtrue-电源子系统名称
PowerConvertersobjecttrue-电源转换器集合资源信息，包括：
● @odata.id：电源转换器集合资源访问路径
CapacityWattsnumbertrue-额定功率
PowerSupplyRedundancyarraytrue-冗余电源组
RedundancyTypestringtrue-冗余类型Failover：一台设备的故障会自动使冗余集中的备用或脱机单元接管其功能NotRedundant：子系统未配置为冗余模式，或者由于配置原因，或者功能已被用户禁用NPlusM：多个单元可用且处于活动状态，当一个或多个单元出现故障时，正常运行将继续Sharing：多个单元贡献或共享，这样，如果一个或多个单元发生故障，运行将继续，但容量降低Sparing：有一个或多个备用设备来接管故障设备的功能，但接管不是自动的
MaxSupportedInGroupnumbertrue-支持最大的冗余设备数量
MinNeededInGroupnumbertrue-支持最小的冗余设备数量
RedundancyGrouparraytrue-冗余设备资源数组
PowerSuppliesobjecttrue-电源资源
Statusobjecttrue-状态State：是否使能Health：健康状态
Allocationobjecttrue-系统分配功率 "AllocatedWatts": 已分配或预算给此子系统的功率总量 "RequestedWatts": 子系统请求的潜在功率（以瓦为单位）可能高于当前消耗水平 说明 BMC500 5.13.0及以上版本支持。

supported_methods ​

  • GET

HTTP methods ​

GET ​

命令功能

查询指定机箱电源子系统信息

命令格式

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

请求头:


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

使用指南

OSCA产品电源信息由HMM软件管理，刀片服务器和交换板BMC不支持该信息的查 询。 BMC300 5.6.3.13及以上版本支持

使用实例

请求样例：

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

请求头：


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

请求消息体：无

响应样例：

json
{
  "@odata.context": "/redfish/v1/$metadata#PowerSubsystem.PowerSubsystem",
  "@odata.id": "/redfish/v1/Chassis/1/PowerSubsystem",
  "@odata.type": "#PowerSubsystem.v1_1_2.PowerSubsystem",
  "Id": "PowerSubsystem",
  "Name": "Power Subsystem for Chassis",
  "Oem": {
    "Public": {
      "PowerConverters": {
        "@odata.id": "/redfish/v1/Chassis/1/PowerSubsystem/Oem/Public/PowerConverters"
      }
    }
  },
  "CapacityWatts": 1800,
  "PowerSupplyRedundancy": [
    {
      "RedundancyType": "Sharing",
      "MaxSupportedInGroup": 2,
      "MinNeededInGroup": 1,
      "RedundancyGroup": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
        },
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/2"
        }
      ],
      "Status": {
        "State": "Enabled",
        "Health": "OK"
      }
    }
  ],
  "PowerSupplies": {
    "@odata.id": "/redfish/v1/Chassis/1/PowerSubsystem/PowerSupplies"
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Allocation": {
    "AllocatedWatts": null,
    "RequestedWatts": null
  }
}

响应码：200