Power
更新时间: 2026/06/26
在Gitcode上查看源码

ResourceDefinition

uris

  • /redfish/v1/Chassis/chassis_id/Power

properties

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-电源资源模型的OData描述信息
@odata.idstringtrue-电源资源的访问路径
@odata.typestringtrue-电源资源的类型
Idstringtrue-电源资源ID
Namestringtrue-电源资源名称
@odata.idstringtrue-电源控制属性的访问路径
MemberIdstringtrue-电源控制属性的ID,为其在电源资源中的唯一标识。
Namestringtrue-电源控制属性的名称
PowerConsumedWattsnumbertrue-设备的当前功率 说明 已屏蔽该属性值频繁变化导致的事件上报
PowerMetricsobjecttrue-设备功率参数,包括:
● MinConsumedWatts: 最小功率
● MaxConsumedWatts:最大功率
● AverageConsumedWatts:平均功率 说明 已屏蔽该属性及其子属性频繁变化导致的事件上报
PowerLimitobjectfalse-功率封顶参数,包括:
● LimitInWatts:封顶功率,null(不支持)
● LimitException:功率封顶失效后的动作,可以是 "HardPowerOff"、 "NoAction"、 "Reset"、 "LogEventOnly(默认)" 或"null(不支持)" 说明 x86平台不支持设置Reset操作搭载了BBU模块的机型不支持设置HardPowerOff、Reset操作A900_A5_SuperPoD机型不支持设置HardPowerOff、Reset操作默认为LogEventOnly
PowerMetricsExtendedobjectfalse-设备功率参数扩展信息 说明 已屏蔽该属性及其子属性频繁变化导致的事件上报
StatisticsCollectedstringtrue-开始统计时间
MaxConsumedOccurredstringtrue-最大功率产生时间
CurrentCPUPowerWattsnumbertrue-当前CPU功率
CurrentMemoryPowerWattsnumbertrue-当前内存功率
TotalConsumedPowerKWhstringtrue-总使用功率 说明 已屏蔽该属性值频繁变化导致的事件上报
MinPowerLimitInWattsnumbertrue-功率封顶下限,null(不支持)
MaxPowerLimitInWattsnumbertrue-功率封顶上限,null(不支持)
PowerLimitWhenSteadybooleanfalse-功率封顶是否受限于BMC初始化完成,包括
● true:BMC初始化完成后功率封顶功能才能生效
● false:功率封顶不受BMC初始化完成的限制
● null:不支持 说明 BMC300 5.1.0.1及以上版本支持
PowerLimitActivatedbooleantrue-功率封顶状态,包括:
● true:封顶策略已触发
● false:封顶策略未触发
● null:不支持
PowerLimitFailedbooleantrue-功率封顶失败状态,包括:
● true:功率封顶状态失败
● false:功率封顶状态成功
● null:不支持
PowerLimitModestringfalse-仅支持HPC机型设置封顶模式信息,包括:
● Equal:均分模式
● Proportion:比例模式
● null:不支持
HeatKcalnumbertrue-电源热量 说明 已屏蔽该属性值频繁变化导致的事件上报
ExpectedRedundancyobjectfalse-期望的电源冗余模式,包括:
● @odata.id:指定电源冗余组的访问路径
@odata.typestringtrue-指定电源冗余组的资源类型
ExpectedActivePSUobjectfalse-期望的主用电源列表,包括:
● @odata.id:指定电源模块的访问路径
WorkModeConfigurablebooleantrue-是否支持设置电源工作模式
DeepSleepstringfalse-电源深度休眠使能状态包括:
● Enabled
● Disabled
NormalAndRedundancystringtrue-电源的N+R使能状态包括:
● Enabled
● Disabled
● null(不支持)
MSPPEnabledbooleantrue-紧急功率封顶模式包括:
● true(多节点服务器电源保护模式)
● false(用户配置模式)
● null(不支持)
HighPowerThresholdWattsnumberfalse-功耗过高告警阈值
PowerLimitExceptionSupportedbooleantrue-是否支持设置功率封顶失败下电动作,null(不支持)
PresetLimitInWattsnumberfalse-封顶功率预设值,iRM和BMC通讯丢失后在BMC上生效。 说明 此参数仅FusionPoD节点服务器支持设置
@odata.idstringtrue-指定电压传感器的访问路径
MemberIdnumbertrue-指定电压传感器的ID,为其在电压传感器列表中的唯一标识。
Namestringtrue-指定电压传感器的名称
SensorNumbernumbertrue-指定电压传感器的序号
Statusobjecttrue-指定电压传感器的状态, 包括:
● Health:电压传感器健康状态
● State:电压传感器使能状态
● Severity:电压传感器的自定义健康状态
ReadingVoltsnumbertrue-指定电压传感器的当前读数 说明 已屏蔽该属性值频繁变化导致的事件上报
UpperThresholdNonCriticalnumbertrue-指定电压传感器的高压轻微告警阈值
UpperThresholdCriticalnumbertrue-指定电压传感器的高压严重告警阈值
UpperThresholdFatalnumbertrue-指定电压传感器的高压紧急告警阈值
LowerThresholdNonCriticalnumbertrue-指定电压传感器的低压轻微告警阈值
LowerThresholdCriticalnumbertrue-指定电压传感器的低压严重告警阈值
LowerThresholdFatalnumbertrue-指定电压传感器的低压紧急告警阈值
MinReadingRangenumbertrue-指定电压传感器可读取的最低电压
MaxReadingRangenumbertrue-指定电压传感器可读取的最高电压
@odata.idstringtrue-指定电源模块的访问路径
MemberIdstringtrue-指定电源模块的ID,为其在电源模块列表中的唯一标识。
Namestringtrue-指定电源模块的名称
Statusobjecttrue-指定电源模块的状态,包括:
● State:电源模块是否使能,其中包括Enabled:主用电源、 StandbySpare:备用电源
● Health:电源模块健康状态
● Severity:电源模块的自定义健康状态
PowerSupplyTypestringtrue-指定电源模块的供电类型
● Unknown
● AC
● DC
● ACorDC
LineInputVoltagenumbertrue-指定电源模块的输入电压 说明 已屏蔽该属性值频繁变化导致的事件上报
PowerCapacityWattsnumbertrue-指定电源模块的额定功率
Modelstringtrue-指定电源模块的型号
FirmwareVersionstringtrue-指定电源模块的固件版本
SerialNumberstringtrue-指定电源模块的序列号
Redundancyobjectfalse-指定电源模块实际所属的电源冗余组列表,包括:
● @odata.id:指定电源冗余组的访问路径
Manufacturerstringtrue-指定电源模块制造商
PartNumberstringtrue-指定电源模块的部件号
Protocolstringtrue-指定电源模块所使用的协议包括:
● PSMI
● PMBUS
● CANBUS
ActiveStandbystringtrue-指定电源模块的主备模式包括:
● Active
● Standby
PowerInputWattsnumbertrue-指定电源模块的输入功率 说明 已屏蔽该属性值频繁变化导致的事件上报
InputAmperagenumbertrue-指定电源模块的输入电流 说明 已屏蔽该属性值频繁变化导致的事件上报
PowerOutputWattsnumbertrue-指定电源模块的输出功率 说明 已屏蔽该属性值频繁变化导致的事件上报
OutputAmperagenumbertrue-指定电源模块的输出电流 说明 已屏蔽该属性值频繁变化导致的事件上报
InletTemperatureCelsiusnumbertrue-指定电源模块的进风口温度 说明 已屏蔽该属性值频繁变化导致的事件上报
InnerTemperatureCelsiusnumbertrue-指定电源模块的出风口温度 说明 已屏蔽该属性值频繁变化导致的事件上报
OutputVoltagenumbertrue-指定电源模块的输出电压 说明 已屏蔽该属性值频繁变化导致的事件上报
DeviceLocatorstringtrue-指定电源模块的丝印
SlotNumbernumbertrue-指定电源的槽位号
ManufactureDatestringtrue-指定电源模块的制造日期
CurrentCapacityAmperagenumbertrue-指定电源模块的额定电流 说明 已屏蔽该属性值频繁变化导致的事件上报
TotalRunningHoursnumbertrue-指定电源模块的运行时间 说明 已屏蔽该属性值频繁变化导致的事件上报
InputFrequencyHznumbertrue-指定电源模块的输入频率 说明 已屏蔽该属性值频繁变化导致的事件上报
PowerSupplyChannelstringtrue-指定电源模块的供电的电路包括:
● MainCircuit
● BackupCircuit
VinChannelAVoltagenumbertrue-指定电源模块的A路输入电压 说明 已屏蔽该属性值频繁变化导致的事件上报
VinChannelBVoltagenumbertrue-指定电源模块的B路输入电压 说明 已屏蔽该属性值频繁变化导致的事件上报
Positionstringtrue-指定电源模块的容器
@odata.idstringtrue-指定电源冗余组的访问路径
@odata.typestringtrue-指定电源冗余组的资源类型
MemberIdnumbertrue-指定电源冗余组的ID,为其在电源冗余模式组中的唯一标识
Namestringtrue-指定电源冗余组的名称
Modestringfalse-指定电源冗余组的冗余模式,可以是" Sharing", 表示负载均衡;或 "Failover",表示主备模式
MaxNumSupportednumbertrue-指定电源冗余组所支持的最大电源模块个数
MinNumNeedednumbertrue-指定电源冗余组所支持的最小电源模块个数
RedundancySetobjectfalse-指定电源冗余组所包含的电源模块的列表,包括:
● @odata.id:指定电源模块的访问路径
Statusobjecttrue-指定电源冗余组的状态, 包括:
● State:电源冗余组是否使能
● Health:电源冗余组健康状态
● Severity:电源冗余组的自定义健康状态
Power.ResetHistoryDataobjecttrue-清空历史功率数据
targetstringtrue-清空历史功率数据的访问路径
@Redfish.ActionInfostringtrue-清空历史功率数据的查询路径
Power.ResetStatisticsobjecttrue-重新统计功率数据
targetstringtrue-重新统计功率数据的访问路径
@Redfish.ActionInfostringtrue-重新统计功率数据的查询路径
Power.CollectHistoryDataobjecttrue-收集历史功率数据
targetstringtrue-收集历史功率数据的访问路径
@Redfish.ActionInfostringtrue-收集历史功率数据的查询路径
PowerHistoryDataobjecttrue-历史功率资源节点的访问路径

supported_methods

  • GET
  • PATCH
  • POST

HTTP methods

GET

命令功能

查询指定机箱电源信息

命令格式

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

请求头:


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_valu执行该GET请求时,必须 在“Headers”中携带 “X-Auth-Token”值用于 鉴权可通过/redfish/v1/ SessionService/Sessions 创建会话时获得

使用指南

使用实例

请求样例:

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

请求头:


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

请求消息体:无

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#Power.Power",
  "@odata.id": "/redfish/v1/Chassis/1/Power",
  "@odata.type": "#Power.v1_1_0.Power",
  "Id": "Power",
  "Name": "Power",
  "PowerControl": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerControl/0",
      "MemberId": "0",
      "Name": "System Power Control 1",
      "PowerConsumedWatts": 192,
      "PowerMetrics": {
        "MinConsumedWatts": 42,
        "MaxConsumedWatts": 306,
        "AverageConsumedWatts": 189
      },
      "PowerLimit": {
        "LimitInWatts": 500,
        "LimitException": null
      },
      "Oem": {
        "Public": {
          "PowerMetricsExtended": {
            "StatisticsCollected": "2018-08-27T02:40:09+00:00",
            "MaxConsumedOccurred": "2019-02-23T11:50:26+00:00",
            "CurrentCPUPowerWatts": 94,
            "CurrentMemoryPowerWatts": 3,
            "TotalConsumedPowerkWh": 7.1813402777778,
            "MinPowerLimitInWatts": 2000,
            "MaxPowerLimitInWatts": 507,
            "PowerLimitWhenSteady": true,
            "PowerLimitActivated": false,
            "PowerLimitFailed": false,
            "PowerLimitMode": null
          },
          "HeatKcal": 6178,
          "ExpectedRedundancy": {
            "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0"
          },
          "ExpectedActivePSU": [
            {
              "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0"
            },
            {
              "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
            }
          ],
          "WorkModeConfigurable": true,
          "DeepSleep": "Disabled",
          "NormalAndRedundancy": null,
          "MSPPEnabled": null,
          "HighPowerThresholdWatts": 300,
          "PresetLimitInWatts": null,
          "PowerLimitExceptionSupported": null
        }
      }
    }
  ],
  "Voltages": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/0",
      "MemberId": "0",
      "Name": "SYS 3.3V",
      "SensorNumber": 11,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 3.28,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 3.62,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 2.98,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/1",
      "MemberId": "1",
      "Name": "SYS 5V",
      "SensorNumber": 12,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 5.19,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 5.49,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 4.5,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/2",
      "MemberId": "2",
      "Name": "SYS 12V_1",
      "SensorNumber": 18,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 12.18,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 13.2,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 10.8,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/3",
      "MemberId": "3",
      "Name": "SYS 12V_2",
      "SensorNumber": 13,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 12.24,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 13.2,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 10.8,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/4",
      "MemberId": "4",
      "Name": "CPU1 DDR VPP1",
      "SensorNumber": 16,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 2.56,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 2.74,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 2.24,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/5",
      "MemberId": "5",
      "Name": "CPU1 DDR VPP2",
      "SensorNumber": 17,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 2.56,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 2.74,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 2.24,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/6",
      "MemberId": "6",
      "Name": "CPU2 DDR VPP1",
      "SensorNumber": 19,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 2.56,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 2.74,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 2.24,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/7",
      "MemberId": "7",
      "Name": "CPU2 DDR VPP2",
      "SensorNumber": 20,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 2.56,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 2.74,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 2.24,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/8",
      "MemberId": "8",
      "Name": "PS1 VIN",
      "SensorNumber": 39,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 52,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": null,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": null,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/9",
      "MemberId": "9",
      "Name": "PS2 VIN",
      "SensorNumber": 41,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 52,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": null,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": null,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/10",
      "MemberId": "10",
      "Name": "CPU1 VCore",
      "SensorNumber": 43,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 1.78,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 2.04,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 1.23,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/11",
      "MemberId": "11",
      "Name": "CPU2 VCore",
      "SensorNumber": 44,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 1.78,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 2.04,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 1.23,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/12",
      "MemberId": "12",
      "Name": "CPU1 DDR VDDQ",
      "SensorNumber": 45,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 1.22,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.26,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 1.14,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/13",
      "MemberId": "13",
      "Name": "CPU1 DDR VDDQ2",
      "SensorNumber": 46,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 1.22,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.26,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 1.14,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/14",
      "MemberId": "14",
      "Name": "CPU2 DDR VDDQ",
      "SensorNumber": 47,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 1.22,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.26,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 1.14,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/15",
      "MemberId": "15",
      "Name": "CPU2 DDR VDDQ2",
      "SensorNumber": 48,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 1.22,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.26,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 1.14,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/16",
      "MemberId": "16",
      "Name": "CPU1 VSA",
      "SensorNumber": 53,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 0.88,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.21,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 0.45,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/17",
      "MemberId": "17",
      "Name": "CPU2 VSA",
      "SensorNumber": 54,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 0.86,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.21,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 0.45,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/18",
      "MemberId": "18",
      "Name": "CPU1 VCCIO",
      "SensorNumber": 55,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 0.99,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.16,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 0.84,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/19",
      "MemberId": "19",
      "Name": "CPU2 VCCIO",
      "SensorNumber": 56,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 0.99,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.16,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 0.84,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/20",
      "MemberId": "20",
      "Name": "PCH VPVNN",
      "SensorNumber": 57,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 0.99,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.15,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 0.73,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/21",
      "MemberId": "21",
      "Name": "PCH PRIM 1V05",
      "SensorNumber": 58,
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "ReadingVolts": 1.04,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 1.19,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 0.91,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    }
  ],
  "PowerSupplies": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0",
      "MemberId": "0",
      "Name": "PSU1",
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "PowerSupplyType": "DC",
      "LineInputVoltage": 53,
      "PowerCapacityWatts": 1200,
      "Model": "PDC1200S12-CE",
      "FirmwareVersion": "DC:108 PFC(QB):108 PFC(QB):108",
      "SerialNumber": "2102312BLL10J5000045",
      "Redundancy": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0"
        }
      ],
      "Manufacturer": "",
      "PartNumber": "02312BLL",
      "Oem": {
        "Public": {
          "Protocol": "PMBUS",
          "ActiveStandby": "Active",
          "PowerInputWatts": 120,
          "InputAmperage": 0.03125,
          "PowerOutputWatts": 103,
          "OutputAmperage": 0.125,
          "InletTemperatureCelsius": 37.5,
          "InnerTemperatureCelsius": 54.0,
          "OutputVoltage": 0.046875,
          "DeviceLocator": "PSU1",
          "SlotNumber": 1,
          "ManufactureDate": "2020-04-23",
          "CurrentCapacityAmperage": 20.25,
          "TotalRunningHours": 1500,
          "InputFrequencyHz": 60,
          "PowerSupplyChannel": "MainCircuit",
          "VinChannelAVoltage": 54.156,
          "VinChannelBVoltage": 51.078,
          "PSUInputAStatus": "Normal",
          "PSUInputBStatus": "Normal",
          "BatteryPresenceState": "Absent",
          "EODAlarmState": true,
          "Position": "chassis"
        }
      }
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1",
      "MemberId": "1",
      "Name": "PSU2",
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      },
      "PowerSupplyType": "DC",
      "LineInputVoltage": 53,
      "PowerCapacityWatts": 1200,
      "Model": "PDC1200S12-CE",
      "FirmwareVersion": "DC:108 PFC(QB):108 PFC(QB):108",
      "SerialNumber": "2102312BLL10J5000027",
      "Redundancy": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0"
        }
      ],
      "Manufacturer": "",
      "PartNumber": "02312BLL",
      "Oem": {
        "Public": {
          "Protocol": "PMBUS",
          "ActiveStandby": "Active",
          "PowerInputWatts": 72,
          "InputAmperage": 0.015625,
          "PowerOutputWatts": 52,
          "OutputAmperage": 0.0625,
          "InletTemperatureCelsius": 37.5,
          "InnerTemperatureCelsius": 54.0,
          "OutputVoltage": 0.046875,
          "DeviceLocator": "PSU2",
          "SlotNumber": 2,
          "ManufactureDate": "2020-04-23",
          "CurrentCapacityAmperage": 20.25,
          "TotalRunningHours": 1500,
          "InputFrequencyHz": 60,
          "PowerSupplyChannel": "MainCircuit",
          "VinChannelAVoltage": 54.156,
          "VinChannelBVoltage": 51.078,
          "PSUInputAStatus": "Normal",
          "PSUInputBStatus": "Normal",
          "BatteryPresenceState": "Absent",
          "EODAlarmState": true,
          "Position": "chassis"
        }
      }
    }
  ],
  "Redundancy": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0",
      "@odata.type": "#Redundancy.v1_2_1.Redundancy",
      "MemberId": "0",
      "Name": "PowerSupply Redundancy Group 1",
      "Mode": "Sharing",
      "MaxNumSupported": 2,
      "MinNumNeeded": 2,
      "RedundancySet": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0"
        },
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
        }
      ],
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": "OK"
      }
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/1",
      "@odata.type": "#Redundancy.v1_2_1.Redundancy",
      "MemberId": "1",
      "Name": "PowerSupply Redundancy Group 2",
      "Mode": "Failover",
      "MaxNumSupported": 2,
      "MinNumNeeded": 2,
      "RedundancySet": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0"
        },
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
        }
      ],
      "Status": {
        "State": "Enabled",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "Health": null
      }
    }
  ],
  "Oem": {
    "Public": {
      "Actions": {
        "#Power.ResetHistoryData": {
          "target": "/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.ResetHistoryData",
          "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Power/ResetHistoryDataActionInfo"
        },
        "#Power.ResetStatistics": {
          "target": "/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.ResetStatistics",
          "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Power/ResetStatisticsActionInfo"
        },
        "#Power.CollectHistoryData": {
          "target": "/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.CollectHistoryData",
          "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Power/CollectHistoryDataActionInfo"
        },
        "#Power.PowerHistoryData": {
          "target": "/redfish/v1/Chassis/${Uri/chassisid}/Power/Oem/Public/Actions/Power.PowerHistoryData",
          "@Redfish.ActionInfo": "/redfish/v1/Chassis/${Uri/chassisid}/Power/PowerHistoryDataActionInfo"
        }
      },
      "PowerHistoryData": {
        "@odata.id": "/redfish/v1/Chassis/${Uri/chassisid}/Power/PowerHistoryData"
      }
    }
  }
}

响应码:200

PATCH

命令功能

修改指定电源属性

说明

获取历史接口BMC300 device_ip及以上版本修改为POST接口

命令格式

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

请求头:


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

请求消息体: ● 设置功率封顶参数:

json
{
  "PowerControl": [
    {
      "PowerLimit": {
        "LimitInWatts": limit_value,
        "LimitException": limit_exception
      }
    }
  ]
}

● 设置期望电源冗余模式:

json
{
  "PowerControl": [
    {
      "Oem": {
        "Public": {
          "ExpectedRedundancy": {
            "@odata.id": redundancy
          },
          "ExpectedActivePSU": [
            {
              "@odata.id": powersupply
            }
          ]
        }
      }
    }
  ]
}

json
{
  "Redundancy": [
    {
      "Mode": mode_value,
      "RedundancySet": RedundancySet_value
    }
  ]
}

● 设置深度休眠使能状态只有V5非OSCA环境支持:

json
{
  "PowerControl": [
    {
      "Oem": {
        "Public": {
          "DeepSleep": sleep_value
        }
      }
    }
  ]
}

● 设置功耗过高告警阈值,只有V5支持:

json
{
  "PowerControl": [
    {
      "Oem": {
        "Public": {
          "HighPowerThresholdWatts": threshold_value
        }
      }
    }
  ]
}

● 设置封顶功率预设值,只有FusionPoD节点服务器支持,且只能通过机柜内部管 理网络设置:

json
{
  "PowerControl": [
    {
      "Oem": {
        "Public": {
          "PresetLimitInWatts": limit_value
        }
      }
    }
  ]
}

● 设置功率封顶依赖于BMC初始化完成:

json
{
  "PowerControl": [
    {
      "Oem": {
        "Public": {
          "PowerMetricsExtended": {
            "PowerLimitWhenSteady": powerlimitwhensteady_value
          }
        }
      }
    }
  ]
}

● 设置功率封顶模式信息,只有HPC支持:

json
{
  "PowerControl": [
    {
      "Oem": {
        "Public": {
          "PowerMetricsExtended": {
            "PowerLimitMode": powerlimitmode_value
          }
        }
      }
    }
  ]
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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
limit_value服务器封顶功率值整型数字,单位为W 说明 本资源内 MinPowerLimitInWatts为建 议下限值, MaxPowerLimitInWatts为 建议上限值
limit_exception功率封顶失效动作字符串
● NoAction,无动作
● HardPowerOff,下电
● Reset,重启
● LogEventOnly,仅记 录事件日志 说明 1. x86平台不支持设置 Reset操作 2. 搭载了BBU模块的机型 不支持设置 HardPowerOff、Reset 操作 3. A900_A5_SuperPoD机型 不支持设置 HardPowerOff、Reset 操作 4. 默认为LogEventOnly
redundancy冗余模式所在冗余组的路 径Redundancy列表中冗余组 的@odata.id属性值 说明 BMC300 5.10.0.1 及以上版 本支持
powersupply指定的主用电源模块的路 径PowerSupplies列表中电源 模块的@odata.id属性值 说明 BMC300 5.10.0.1 及以上版 本支持 如果设置冗余模式为 "Sharing",即上面 redundancy参数所指定的冗 余组中,"Mode"属性的值为 "Sharing"时,这里 powersupply参数不需要取 值,且其外层属性 "ExpectedActivePSU"也不 需要在请求体中指定
mode_value电源工作模式指定电源冗余组的冗余模 式,可以是" Sharing", 表示负载均衡;或 "Failover",表示主备供电 模式 说明 BMC300 5.10.0.1 及以上版 本支持
RedundancySet_value备用电源模块路径列表指定电源冗余组所包含的 冗余电源模块的列表 包括: @odata.id:指定 电源模块的访问路径。 " Sharing"模式此属性不 需传入,"Failover"模式此 属性需传入备用电源集合 的路径 说明 BMC300 5.10.0.1 及以上版 本支持
sleep_value深度休眠是否使能支持的取值包括:
● "Enabled"
● "Disabled"
threshold_value功耗过高告警阈值整数,单位为W 说明 1为建议下限值, MaxPowerLimitInWatts为 建议上限值
powerlimitwhensteady_v alue功率封顶是否受限于BMC 初始化完成● true:BMC初始化完成 后功率封顶功能才能生 效
● false:功率封顶不受 BMC初始化完成的限制
powerlimitmode_value功耗封顶模式仅支持HPC机型设置封顶 模式信息,包括:
● Equal:均分模式
● Proportion:比例模式

使用指南

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

使用实例

请求样例:

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

请求头:


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

请求消息体:

json
{
  "PowerControl": [
    {
      "PowerLimit": {
        "LimitInWatts": 700,
        "LimitException": "NoAction"
      },
      "Oem": {
        "Public": {
          "PowerMetricsExtended": {
            "PowerLimitWhenSteady": true
          }
        }
      }
    }
  ]
}

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#Power.Power",
  "@odata.id": "/redfish/v1/Chassis/1/Power",
  "@odata.type": "#Power.v1_1_0.Power",
  "Id": "Power",
  "Name": "Power",
  "PowerControl": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerControl/0",
      "MemberId": "0",
      "Name": "System Power Control 1",
      "PowerConsumedWatts": 36,
      "PowerMetrics": {
        "MinConsumedWatts": 6,
        "MaxConsumedWatts": 246,
        "AverageConsumedWatts": 37
      },
      "PowerLimit": {
        "LimitInWatts": 700,
        "LimitException": "NoAction"
      },
      "Oem": {
        "Public": {
          "PowerMetricsExtended": {
            "StatisticsCollected": "1970-01-01T00:10:00+00:00",
            "MaxConsumedOccurred": "2016-01-15T06:36:51+00:00",
            "CurrentCPUPowerWatts": 0,
            "CurrentMemoryPowerWatts": 0,
            "TotalConsumedPowerkWh": 6736.9780661111,
            "MinPowerLimitInWatts": 190,
            "MaxPowerLimitInWatts": 750,
            "PowerLimitWhenSteady": true,
            "PowerLimitActivated": false,
            "PowerLimitFailed": false,
            "PowerLimitStatus": null
          },
          "HeatKcal": 29328,
          "ExpectedRedundancy": {
            "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0"
          },
          "ExpectedActivePSU": [
            {
              "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0"
            },
            {
              "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
            }
          ],
          "WorkModeConfigurable": true,
          "DeepSleep": null,
          "NormalAndRedundancy": "Enabled",
          "MSPPEnabled": false,
          "HighPowerThresholdWatts": 300,
          "PresetLimitInWatts": 9999
        }
      }
    }
  ],
  "Voltages": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/0",
      "MemberId": "0",
      "Name": "SYS 3.3V",
      "SensorNumber": 12,
      "Status": {
        "Health": "OK",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "State": "Disabled"
      },
      "ReadingVolts": null,
      "UpperThresholdNonCritical": null,
      "UpperThresholdCritical": 3.62,
      "UpperThresholdFatal": null,
      "LowerThresholdNonCritical": null,
      "LowerThresholdCritical": 2.98,
      "LowerThresholdFatal": null,
      "MinReadingRange": null,
      "MaxReadingRange": null
    },
    ......
  ],
  "PowerSupplies": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0",
      "MemberId": "0",
      "Name": "PSU1",
      "Status": {
        "Health": "OK",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "State": "Enabled"
      },
      "PowerSupplyType": "ACorDC",
      "LineInputVoltage": 218,
      "PowerCapacityWatts": 750,
      "Model": "HUAWE 750W PLATINUM PS",
      "FirmwareVersion": "07",
      "SerialNumber": null,
      "Redundancy": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0"
        }
      ],
      "Manufacturer": "",
      "PartNumber": "02131042",
      "Oem": {
        "Public": {
          "Protocol": "PSMI",
          "ActiveStandby": "Active",
          "PowerInputWatts": 18,
          "InputAmperage": 0,
          "PowerOutputWatts": 0,
          "OutputAmperage": 0,
          "InletTemperatureCelsius": 37.500,
          "InnerTemperatureCelsius": 54.000,
          "OutputVoltage": 0,
          "DeviceLocator": "PSU1",
          "SlotNumber": 1,
          "ManufactureDate": "2020-04-23",
          "CurrentCapacityAmperage": 20.25,
          "TotalRunningHours": 1500,
          "InputFrequencyHz": 60,
          "PowerSupplyChannel": "MainCircuit",
          "VinChannelAVoltage": 54.156,
          "VinChannelBVoltage": 51.078,
          "Position": "chassis"
        }
      }
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1",
      "MemberId": "1",
      "Name": "PSU2",
      "Status": {
        "Health": "OK",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "State": "Enabled"
      },
      "PowerSupplyType": "ACorDC",
      "LineInputVoltage": 218,
      "PowerCapacityWatts": 750,
      "Model": "HUAWE 750W PLATINUM PS",
      "FirmwareVersion": "07",
      "SerialNumber": null,
      "Redundancy": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0"
        }
      ],
      "Manufacturer": "",
      "PartNumber": "02131042",
      "Oem": {
        "Public": {
          "Protocol": "PSMI",
          "ActiveStandby": "Active",
          "PowerInputWatts": 18,
          "InputAmperage": 0,
          "PowerOutputWatts": 0,
          "OutputAmperage": 0,
          "InletTemperatureCelsius": 37.500,
          "InnerTemperatureCelsius": 54.000,
          "OutputVoltage": 0,
          "DeviceLocator": "PSU2",
          "SlotNumber": 2,
          "ManufactureDate": "2020-04-23",
          "CurrentCapacityAmperage": 20.25,
          "TotalRunningHours": 1500,
          "InputFrequencyHz": 60,
          "PowerSupplyChannel": "MainCircuit",
          "VinChannelAVoltage": 54.156,
          "VinChannelBVoltage": 51.078,
          "Position": "chassis"
        }
      }
    }
  ],
  "Redundancy": [
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0",
      "@odata.type": "#Redundancy.v1_2_1.Redundancy",
      "MemberId": "0",
      "Name": "PowerSupply Redundancy Group 1",
      "Mode": "Sharing",
      "MaxNumSupported": 2,
      "MinNumNeeded": 2,
      "RedundancySet": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0"
        },
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
        }
      ],
      "Status": {
        "Health": "OK",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "State": "Enabled"
      }
    },
    {
      "@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/1",
      "@odata.type": "#Redundancy.v1_2_1.Redundancy",
      "MemberId": "1",
      "Name": "PowerSupply Redundancy Group 2",
      "Mode": "Failover",
      "MaxNumSupported": 2,
      "MinNumNeeded": 2,
      "RedundancySet": [
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0"
        },
        {
          "@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
        }
      ],
      "Status": {
        "Health": "OK",
        "Oem": {
          "Public": {
            "Severity": "Informational"
          }
        },
        "State": "Enabled"
      }
    }
  ],
  "Oem": {
    "Public": {
      "Actions": {
        "#Power.ResetHistoryData": {
          "target": "/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.ResetHistoryData",
          "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Power/ResetHistoryDataActionInfo"
        },
        "#Power.ResetStatistics": {
          "target": "/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.ResetStatistics",
          "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Power/ResetStatisticsActionInfo"
        },
        "#Power.CollectHistoryData": {
          "target": "/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.CollectHistoryData",
          "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Power/CollectHistoryDataActionInfo"
        },
        "#Power.PowerHistoryData": {
          "target": "/redfish/v1/Chassis/${Uri/chassisid}/Power/Oem/Public/Actions/Power.PowerHistoryData",
          "@Redfish.ActionInfo": "/redfish/v1/Chassis/${Uri/chassisid}/Power/PowerHistoryDataActionInfo"
        }
      }
    }
  }
}

响应码:200

POST (ACTION)

ClearHistoryPowerData

命令功能

清空历史功率数据

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Power/Oem/Public/Actions/Power.ResetHistoryData

请求头:


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

请求消息体:

json
{
  "DataType": data_type
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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
data_type查询数据类型 说明 BMC300 5.3.0.1及以上版本 支持支持查询整机、风扇、 Cpu、内存的历史功耗数 据(System、Fan、 Cpu、Memory)

使用指南

BMC300 5.3.0.1及以上版本支持。

使用实例

请求样例:

http
POST https://device_ip/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.ResetHistoryData

请求头:


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体:

json
{
  "DataType": "System"
}

响应样例:

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

POST (ACTION)

ResetPowerStatistics

命令功能

重新统计功率数据

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Power/Oem/Public/Actions/Power.ResetStatistics

请求头:


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

请求消息体:

json
{}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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

使用指南

使用实例

请求样例:

http
POST https://device_ip/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.ResetStatistics

请求头:


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体:

json
{}

响应样例:

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

POST (ACTION)

CollectPowerStatistics

命令功能

收集功率统计数据

说明

GA140C等机型为纯液冷散热,响应体以实际返回结果为准。

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Power/Oem/Public/Actions/Power.CollectHistoryData

请求头:


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

请求消息体:

json
{
  "Type": "type_value",
  "Content": "content_value",
  "DataType": "data_type"
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
manager_id管理资源ID● 针对机架服务器,取值 为1
● 针对高密服务器,取值 为BladeN(N表示节点 槽位号),例如 “Blade0”
● 针对刀片服务器,取值 可以为BladeN(N表示 计算节点槽位号)或 SwiN(N表示交换模块 槽位号),例如 “Swi1”
● 针对X6800 V5,X6000 V5,G5500,XA320 V2 服务器,取值还可以为 Enc,表示计算节点所在 的机框资源
● 针对设备U位信息,取值 可以为UN(N表示设备U 位号),例如"U1"
● 针对机柜资源,取值为 Rack
type_value收集SEL日志文件方法● URI
content_value收集SEL日志文件的路径操作路径
● 本地导出:“/tmp/文件 路径”
● 远程导出:“文件传输 协议://用户名:密码@ip 地址/目录/文件名” 文件传输协议包括五 种:sftp、https、nfs、 cifs、scp
data_type查询数据类型 说明 BMC300 5.3.0.1及以上版本支 持支持查询整机、风扇、 Cpu、内存的历史功耗数据 (System、Fan、Cpu、 Memory)

使用指南

使用实例

请求样例:

http
POST https://device_ip/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.CollectHistoryData

请求头:


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体:

json
{
  "Type": "URI",
  "Content": "/tmp/bbb.tar.gz",
  "datatype": "System"
}

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#Task.Task",
  "@odata.type": "#Task.v1_0_2.Task",
  "@odata.id": "/redfish/v1/TaskService/Tasks/1",
  "Id": "1",
  "Name": "1",
  "Description": "",
  "TaskState": "Running",
  "TaskStatus": "OK",
  "StartTime": "2017-05-09T16:57:14+00:00",
  "Messages": [],
  "PercentComplete": null,
  "Oem": {
    "Public": {
      "TaskPercentage": null
    }
  }
}

响应码:202

POST (ACTION)

PowerHistoryData

命令功能

查询历史功率资源信息

说明

GA140C等机型为纯液冷散热,响应体以实际返回结果为准。

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Power/Oem/Public/Actions/Power.PowerHistoryData 原URL:https://device_ip/redfish/v1/Chassis/chassis_id/Power/PowerHistoryData

请求头:


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

请求消息体:

json
{
  "DataType": data_type
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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
data_type查询数据类型 说明 BMC300 5.3.0.1及以上版本 支持支持查询整机、风扇、 Cpu、内存的历史功耗数 据(System、Fan、Cpu、 Memory)

使用指南

使用实例

请求样例:

http
POST https://device_ip/redfish/v1/Chassis/1/Power/Oem/Public/Actions/Power.PowerHistoryData

请求头:


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

请求消息体:

json
{
  "DataType": "System"
}

响应样例:

json
{
  "error": {
    "code": "Base.1.0.GeneralError",
    "message": "A general error has occurred. See ExtendedInfo for more information.",
    "@Message.ExtendedInfo": [
      {
        "@odata.context": "/redfish/v1/$metadata#HwPowerHistoryData.HwPowerHistoryData",
        "@odata.id": "/redfish/v1/Chassis/1/Power/PowerHistoryData",
        "@odata.type": "#HwPowerHistoryData.v1_0_0.HwPowerHistoryData",
        "Id": "PowerHistoryData",
        "Name": "Power History Data",
        "Description": "Power History Data",
        "Data": [
          {
            "Time": "2024/01/22 08:57:08",
            "PowerWatts": 163,
            "PowerAverageWatts": 153,
            "PowerPeakWatts": 163
          },
          {
            "Time": "2024/01/22 08:57:08",
            "PowerWatts": 163,
            "PowerAverageWatts": 153,
            "PowerPeakWatts": 163
          }
        ],
        "MessageId": "Base.1.0.Success",
        "RelatedProperties": [],
        "Message": "Successfully Completed Request",
        "MessageArgs": [],
        "Severity": "OK",
        "Resolution": "None"
      }
    ]
  }
}

响应码:200