PATCH – Update power management properties
Use the PATCH method to update properties in Power resource for Redfish service.
Request URL
Note
This setting is not supported on following systems: Flex and high dense systems, AMD-based systems and systems with tier level less than 3.
PATCH https://<BMC_IPADDR>/redfish/v1/Chassis/1/Power
Request body
Properties to be updated are shown as below, all of these properties can be changed individually.
| Field | Type | Description | |||
|---|---|---|---|---|---|
PowerControl | Object | Expanded. | |||
PowerLimit | Object | Expanded. | |||
LimitInWatts | Number | The Power limit in watts. Null means power capping disabled | |||
Response
The response returns same content as GET operation with updated properties.
Status code
| HTTP Status Code | Error Message ID |
|---|---|
| 400 | PropertyValueTypeError, Conflict |
| 500 | InternalError |
Example
The following example is PATCH body.
{
"PowerControl": [
{
"PowerLimit": {
"LimitInWatts": 800
}
}
]
}
After the PATCH operation runs successfully, querying the Power resource returns below example JSON response:
{
"PowerControl@odata.count": 3,
"PowerSupplies": [
{
"SerialNumber": "D1DG94C006R",
"InputRanges": [
{
"InputType": "AC",
"OutputWattage": 1800,
"MaximumVoltage": 240,
"MinimumVoltage": 200
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0",
"PowerOutputWatts": 69,
"RelatedItem@odata.count": 1,
"MemberId": "0",
"PartNumber": "SP57A14705",
"Location": {
"PartLocation": {
"LocationType": "Slot",
"ServiceLabel": "PSU1",
"LocationOrdinalValue": 1
}
},
"LineInputVoltageType": "ACMidLine",
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"EfficiencyPercent": 80,
"Status": {
"State": "Enabled",
"Health": "OK"
},
"LineInputVoltage": 220,
"Name": "PSU1",
"LastPowerOutputWatts": 10,
"FirmwareVersion": "6.11",
"Oem": {
"Lenovo": {
"HistoryPowerSupplyMetric": {
"@odata.id": "/redfish/v1/Chassis/1/Power/PowerSupplies/0/Oem/Lenovo/HistoryPowerSupplyMetric"
},
"Location": {
"Info": "Slot 1",
"InfoFormat": "Slot X"
},
"Location@Redfish.Deprecated": "The property is deprecated. Please use Location instead.",
"FruPartNumber": "03T8714",
"@odata.type": "#LenovoPower.v1_0_0.PowerSupply"
}
},
"HotPluggable": false,
"PowerInputWatts": 86,
"Manufacturer": "DETA",
"PowerSupplyType": "AC",
"Model": "LENOVO-SP57A14705",
"PowerCapacityWatts": 1800
},
{
"SerialNumber": null,
"InputRanges": [
{
"InputType": null,
"OutputWattage": null,
"MaximumVoltage": null,
"MinimumVoltage": null
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1",
"PowerOutputWatts": null,
"RelatedItem@odata.count": 1,
"MemberId": "1",
"PartNumber": null,
"LineInputVoltageType": null,
"Location": {
"PartLocation": {
"LocationType": "Slot",
"ServiceLabel": "PSU2",
"LocationOrdinalValue": 2
}
},
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"EfficiencyPercent": null,
"Status": {
"State": "Absent",
"Health": null
},
"LineInputVoltage": null,
"Name": "PSU2",
"FirmwareVersion": null,
"LastPowerOutputWatts": null,
"Oem": {
"Lenovo": {
"HistoryPowerSupplyMetric": {
"@odata.id": "/redfish/v1/Chassis/1/Power/PowerSupplies/1/Oem/Lenovo/HistoryPowerSupplyMetric"
},
"Location": {
"Info": "Slot 2",
"InfoFormat": "Slot X"
},
"Location@Redfish.Deprecated": "The property is deprecated. Please use Location instead.",
"FruPartNumber": null,
"@odata.type": "#LenovoPower.v1_0_0.PowerSupply"
}
},
"HotPluggable": null,
"PowerCapacityWatts": null,
"Manufacturer": null,
"PowerSupplyType": null,
"Model": null,
"PowerInputWatts": null
},
{
"SerialNumber": null,
"InputRanges": [
{
"InputType": null,
"OutputWattage": null,
"MaximumVoltage": null,
"MinimumVoltage": null
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/2",
"PowerOutputWatts": null,
"RelatedItem@odata.count": 1,
"MemberId": "2",
"PartNumber": null,
"LineInputVoltageType": null,
"PowerInputWatts": null,
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"EfficiencyPercent": null,
"Status": {
"State": "Absent",
"Health": null
},
"LineInputVoltage": null,
"Name": "PSU3",
"FirmwareVersion": null,
"LastPowerOutputWatts": null,
"Oem": {
"Lenovo": {
"HistoryPowerSupplyMetric": {
"@odata.id": "/redfish/v1/Chassis/1/Power/PowerSupplies/2/Oem/Lenovo/HistoryPowerSupplyMetric"
},
"Location": {
"Info": "Slot 3",
"InfoFormat": "Slot X"
},
"Location@Redfish.Deprecated": "The property is deprecated. Please use Location instead.",
"FruPartNumber": null,
"@odata.type": "#LenovoPower.v1_0_0.PowerSupply"
}
},
"HotPluggable": null,
"Location": {
"PartLocation": {
"LocationType": "Slot",
"ServiceLabel": "PSU3",
"LocationOrdinalValue": 3
}
},
"Manufacturer": null,
"PowerSupplyType": null,
"Model": null,
"PowerCapacityWatts": null
},
{
"SerialNumber": null,
"InputRanges": [
{
"InputType": null,
"OutputWattage": null,
"MaximumVoltage": null,
"MinimumVoltage": null
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/3",
"PowerOutputWatts": null,
"RelatedItem@odata.count": 1,
"MemberId": "3",
"PartNumber": null,
"LineInputVoltageType": null,
"FirmwareVersion": null,
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"EfficiencyPercent": null,
"Status": {
"State": "Absent",
"Health": null
},
"LineInputVoltage": null,
"Name": "PSU4",
"LastPowerOutputWatts": null,
"PowerInputWatts": null,
"Oem": {
"Lenovo": {
"HistoryPowerSupplyMetric": {
"@odata.id": "/redfish/v1/Chassis/1/Power/PowerSupplies/3/Oem/Lenovo/HistoryPowerSupplyMetric"
},
"Location": {
"Info": "Slot 4",
"InfoFormat": "Slot X"
},
"Location@Redfish.Deprecated": "The property is deprecated. Please use Location instead.",
"FruPartNumber": null,
"@odata.type": "#LenovoPower.v1_0_0.PowerSupply"
}
},
"HotPluggable": null,
"Location": {
"PartLocation": {
"LocationType": "Slot",
"ServiceLabel": "PSU4",
"LocationOrdinalValue": 4
}
},
"Manufacturer": null,
"PowerSupplyType": null,
"Model": null,
"PowerCapacityWatts": null
}
],
"Id": "Power",
"Redundancy@odata.count": 1,
"Oem": {
"Lenovo": {
"@odata.type": "#LenovoPower.v1_0_0.Capabilities",
"LocalPowerControlEnabled": true,
"PowerOnPermissionEnabled": true,
"PowerRestorePolicy": "Restore",
"WakeOnLANEnabled": true
}
},
"Name": "Power",
"@odata.id": "/redfish/v1/Chassis/1/Power",
"PowerSupplies@odata.count": 4,
"PowerControl": [
{
"PowerLimit": {
"LimitException": "NoAction",
"LimitInWatts": 1000
},
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerControl/0",
"Status": {
"HealthRollup": "OK",
"Health": "OK",
"State": "Enabled"
},
"PowerAllocatedWatts": 1800,
"Name": "Server Power Control",
"PowerAvailableWatts": 0,
"PhysicalContext": "Chassis",
"PowerMetrics": {
"IntervalInMin": 1,
"MinConsumedWatts": 8,
"MaxConsumedWatts": 11,
"AverageConsumedWatts": 10
},
"RelatedItem@odata.count": 1,
"MemberId": "0",
"Oem": {
"Lenovo": {
"PowerUtilization": {
"MaxLimitInWatts": 1800,
"EnablePowerCapping": true,
"LimitMode": "AC",
"EnablePowerCapping@Redfish.Deprecated": "The property is deprecated. Please use LimitInWatts instead.",
"CapacityMinAC": 190,
"MinLimitInWatts": 0,
"GuaranteedInWatts": 190,
"CapacityMinDC": 172,
"CapacityMaxDC": 396,
"CapacityMaxAC": 426
},
"HistoryPowerMetric": {
"@odata.id": "/redfish/v1/Chassis/1/Power/PowerControl/0/Oem/Lenovo/HistoryPowerMetric"
},
"@odata.type": "#LenovoPower.v1_0_0.PowerControl"
}
},
"PowerRequestedWatts": 426,
"PowerConsumedWatts": 18,
"PowerCapacityWatts": 1800
},
{
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/1/Processors"
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerControl/1",
"Status": {
"HealthRollup": "OK",
"Health": "OK",
"State": "Enabled"
},
"Name": "CPU Sub-system Power",
"PhysicalContext": "CPUSubsystem",
"PowerMetrics": {
"IntervalInMin": 1,
"MinConsumedWatts": 0,
"MaxConsumedWatts": 0,
"AverageConsumedWatts": 0
},
"RelatedItem@odata.count": 1,
"MemberId": "1",
"PowerConsumedWatts": 0
},
{
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/1/Memory"
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerControl/2",
"Status": {
"HealthRollup": "OK",
"Health": "OK",
"State": "Enabled"
},
"Name": "Memory Sub-system Power",
"PhysicalContext": "MemorySubsystem",
"PowerMetrics": {
"IntervalInMin": 1,
"MinConsumedWatts": 0,
"MaxConsumedWatts": 0,
"AverageConsumedWatts": 0
},
"RelatedItem@odata.count": 1,
"MemberId": "2",
"PowerConsumedWatts": 0
}
],
"Voltages": [
{
"MaxReadingRange": 3.32,
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/1"
},
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/0",
"Status": {
"State": "Enabled"
},
"SensorNumber": 3,
"Name": "CMOS Battery",
"PhysicalContext": "VoltageRegulator",
"RelatedItem@odata.count": 2,
"MemberId": "0",
"MinReadingRange": null,
"LowerThresholdNonCritical": 2.39,
"ReadingVolts": 3.07,
"LowerThresholdCritical": 2.25
},
{
"MaxReadingRange": 3.98,
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/1"
},
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/1",
"Status": {
"State": "Enabled"
},
"SensorNumber": 160,
"Name": "SysBrd 3.3V",
"PhysicalContext": "VoltageRegulator",
"RelatedItem@odata.count": 2,
"LowerThresholdCritical": 2.96,
"MinReadingRange": null,
"UpperThresholdCritical": 3.63,
"ReadingVolts": 3.39,
"MemberId": "1"
},
{
"MaxReadingRange": 5.87,
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/1"
},
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/2",
"Status": {
"State": "Enabled"
},
"SensorNumber": 161,
"Name": "SysBrd 5V",
"PhysicalContext": "VoltageRegulator",
"RelatedItem@odata.count": 2,
"LowerThresholdCritical": 4.51,
"MinReadingRange": null,
"UpperThresholdCritical": 5.5,
"ReadingVolts": 4.99,
"MemberId": "2"
},
{
"MaxReadingRange": 14.03,
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/1"
},
{
"@odata.id": "/redfish/v1/Chassis/1"
}
],
"@odata.id": "/redfish/v1/Chassis/1/Power#/Voltages/3",
"Status": {
"State": "Enabled"
},
"SensorNumber": 162,
"Name": "SysBrd 12V",
"PhysicalContext": "VoltageRegulator",
"RelatedItem@odata.count": 2,
"MemberId": "3",
"MinReadingRange": null,
"UpperThresholdCritical": 13.2,
"ReadingVolts": 11.83,
"LowerThresholdCritical": 10.62
}
],
"@odata.type": "#Power.v1_6_0.Power",
"Voltages@odata.count": 4,
"@odata.etag": "\"ee6a4e2b17f6176e60f74867634ce2bb\"",
"Redundancy": [
{
"@odata.id": "/redfish/v1/Chassis/1/Power#/Redundancy/0",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Name": "PSU Redundancy",
"RedundancySet": [
{
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/0"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/1"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/2"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Power#/PowerSupplies/3"
}
],
"Oem": {
"Lenovo": {
"NonRedundantAvailablePower": 1800,
"PowerRedundancySettings": {
"EstimatedUsage": "21.17%",
"MaxPowerLimitWatts": 1800,
"PowerRedundancyPolicy": "RedundantWithThrottling",
"PowerFailureLimit": 0
},
"@odata.type": "#LenovoRedundancy.v1_0_0.LenovoRedundancyProperties"
}
},
"RedundancyEnabled": true,
"MemberId": "0",
"MinNumNeeded": 2,
"MaxNumSupported": 2,
"Mode": "N+m",
"RedundancySet@odata.count": 4
}
],
"Description": "Power Consumption and Power Limiting"
}
Give documentation feedback