GET /nodes/<UUID>/pfaConfigSettings

Use the GET method to retrieve 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:

Note: This API requires Lenovo XClarity Administrator v2.1.0 or later.

Authentication

Authentication with user name and password is required.

Request URL

GET https://<management_server_IP>/nodes/<UUID>/pfaConfigSettings

Query parameters

None

Request body

None

Request example

Response codes

Code Description
200 OK
403 Forbidden. The server could not authenticate this session
404 Not found. A specified user name could not be found.
500 Internal server error. An internal error occurred. A descriptive error message is returned in the response body.

Response body

Attributes Type Description
categoryBitMap Array of Objects Bits definition
  vmMoveCategoryBit Integer Bit number of the category
  vmMoveCategoryName String Name of the category
  vmMoveCategoryType String Type of the category
desiredCategories Integer Hardware event categories that are monitored. This value can be a bitmask value as per the category map.
supportedCategories Integer Hardware event categories that are supported by the platform. This value can be a bitmask value as per the category map.

Response example

{
   "categoryBitMap": [{
      "vmoveCategoryBit": 0,
      "vmMoveCategoryName": "RASeventVMmovementsupport",
      "vmMoveCategoryType": "VMEFlag"
   },
   {
      "vmMoveCategoryBit": 1,
      "vmMoveCategoryName": "Processorsubsystem",
      "vmMoveCategoryType": "EventCategory"
   },
   ...,
   {
      "vmMoveCategoryBit": 31,
      "vmMoveCategoryName": "partialcapacityloss",
      "vmMoveCategoryType": "Severity"
   }],
   "desiredCategoriesv": 2147483684,
   "supportedCategories": 3087007935
}