Skip to main content

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

AttributesRequired / OptionalTypeDescription
desiredCategoriesRequiredLong integerHardware 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

CodeDescriptionComments
200OKThe request completed successfully.
400Bad RequestA 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.
403ForbiddenThe 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.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

None