PATCH – Update GPU PowerLimit settings
Use the PATCH method to update properties in GPU power limit resource for a BMC.
Request URL
Note
Only Nvidia GPU supports this function in AMD-based systems.
PATCH https://<BMC_IPADDR>/redfish/v1/Chassis/1/Controls/GPU{N}_PowerLimit
Request body
Properties to be updated are shown as bellow, all of these properties can be changed individually.
| Field | Type | Error Message ID |
|---|---|---|
SetPoint | Number | “Disabled” or “Manual”. |
ControlMode | String | The desired set point of the control. If both SetPoint and ControlMode are given, if SetPoint is a number then ControlMode must be “Manual”, and if SetPoint is null then ControlMode must be “Disabled”, and vice versa, otherwise 400 Conflict is returned. |
Response body
The response returns same content as GET operation with updated properties.
Status code
| HTTP Status Code | Error Message ID |
|---|---|
| 400 | BadRequest |
| 500 | InternalError |
Example
The following example is PATCH body.
{
"SetPoint": 50,
"ControlMode": "Manual"
}
The following example JSON response is returned:
{
"Status": {
"Health": "OK",
"State": "Enabled"
},
"@odata.context": "/redfish/v1/$metadata#Control.Control",
"Id": "GPU1_PowerLimit",
"Name": "GPU Power Limit",
"@odata.type": "#Control.v1_1_0.Control",
"@odata.id": "/redfish/v1/Chassis/1/Controls/GPU1_PowerL{imit",
"SetPointType": "Single",
"SetPointUnits": "Watt",
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Chassis/1",
},
{
“@odata.id”: “/redfish/v1/System/1/Processor/GPU1”
}
],
"Increment": 1,
"PhysicalContext": "Controls",
"Sensor": {
"Reading": 20,
"DataSourceUri": "/redfish/v1/Chassis/1/Sensors/GPU1_Power"
},
"ControlType": "Power",
"Implementation": "Programmable",
"Description": "This resource shall represent gpu power limit of a chassis for a Redfish implementation.",
"@odata.etag": "\"79fb6c6b41bd242e8a2\"",
"ControlMode": "Manual",
"SetPoint": 50
}
Give documentation feedback