Skip to main content

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.

FieldTypeDescription

PowerControl

ObjectExpanded.
 

PowerLimit

ObjectExpanded.
  

LimitInWatts

NumberThe 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 CodeError Message ID
400PropertyValueTypeError, Conflict
500InternalError

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