Skip to main content

GET /nodes/{uuid}/pfaConfigSettings

Use this method to return information about the predicted failure alerts (PFA) configuration settings from 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​

GET https://{management_server_IP}/nodes/{uuid}/pfaConfigSettings

Query parameters​

None

Request body​

None

Response codes​

CodeDescriptionComments
200OKThe request completed successfully.
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.
404Not foundA specified resource cannot be found. A descriptive error message is returned in the response body.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body​

AttributesTypeDescription
categoryBitMapArray of ObjectsBits definition
 vmMoveCategoryBitIntegerBit number of the category
 vmMoveCategoryNameStringName of the category
 vmMoveCategoryTypeStringType of the category
desiredCategoriesIntegerHardware event categories that are monitored. This value can be a bitmask value as per the category map.
supportedCategoriesIntegerHardware event categories that are supported by the platform. This value can be a bitmask value as per the category map.
The following example is returned if the request is successful.
{
   "categoryBitMap": [{
      "vmoveCategoryBit": 0,
      "vmMoveCategoryName": "RASeventVMmovementsupport",
      "vmMoveCategoryType": "VMEFlag"
   },
   {
      "vmMoveCategoryBit": 1,
      "vmMoveCategoryName": "Processorsubsystem",
      "vmMoveCategoryType": "EventCategory"
   },
   ...,
   {
      "vmMoveCategoryBit": 31,
      "vmMoveCategoryName": "partialcapacityloss",
      "vmMoveCategoryType": "Severity"
   }],
   "desiredCategoriesv": 2147483684,
   "supportedCategories": 3087007935
}