PUT /nodes/{uuid}/pfaConfigSettings
Use this method to modify the predicted failure alerts (PFA) configuration settings on the baseboard management controller.
A 64-bit category map is used to identify hardware event categories and severities:
Bit 0. RAS event VM movement support
Bit 1. Processor subsystem
Bit 2. Memory subsystem
Bit 3. I/O subsystem
Bit 4. Power
Bit 5. Cooling
Bit 6. Fans
Bit 7. Storage
Bit 8. CEC hardware (For System x servers, this bit is not supported and is set to 0.)
Bit 9. Platform firmware
Bit 10. Software
Bit 11. External environment
Bit 12 – 25. Reserved
Bit 26. Redundancy degrade
Bit 27. PFA
Bit 28. Redundancy loss
Bit 29. Info
Bit 30. Warning
Bit 31. Error
Authentication
Authentication with username and password is required.
Request URL
PUT https://{management_server_IP}/nodes/{uuid}/pfaConfigSettings
Query parameters
None
Request body
Attributes | Required / Optional | Type | Description | ||
---|---|---|---|---|---|
desiredCategories | Required | Long integer | Hardware event categories to be monitored. This can be a bitmask value as per the category map. |
The following example modifies PFA configuration settings.
{
"desiredCategories": 2147483684
}
Response codes
Code | Description | Comments |
---|---|---|
200 | OK | The request completed successfully. |
400 | Bad Request | A query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body. |
403 | Forbidden | The orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request. |
500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
Response body
None
Give documentation feedback