Skip to main content

GET /events/activeAlerts/{uuid}

Use this method to return information about active alerts that are associated with a specific managed device. If no query parameters are specified, all active alerts that are associated with the specified managed device are returned.

Authentication

Authentication with username and password is required.

Request URL

GET https://{management_server_IP}/events/activeAlerts/{uuid}

where {uuid} is the unique ID of the managed device to be retrieved. To obtain the device UUID, use the inventory GET methods (for example, GET /chassis, GET /nodes, GET /storage, and GET /switches).

Query parameters

ParametersRequired / OptionalDescription
escapeHTML={Boolean}OptionalIndicates whether to replace escape characters in the message with special characters (for example, "). This can be one of the following values.
  • true. Replaces escape characters with special characters in the returned message.

  • false. Does not replaces escape characters in the returned message.

Note
Escape characters must be included in arguments when there is HTML in messages.
filterWith={filter}OptionalReturns only the active alerts that apply to the specified filters (see Filtering events).
type={type}OptionalReturns only exclude active alerts. Returns only active alerts of the specific type. This can be one of the following values.
  • excluded. Returns only exclude active alerts.

  • acknowledge. Returns only acknowledged active alerts.

The following example returns a list of all active alerts for the specified device.
GET https://192.0.2.0/events/activeAlerts/EA35F98A144E11E2BA81864E72900ECC
The following example returns a list of all excluded active alerts for the specified device and replaces escape characters in the message with special characters.
GET https://192.0.2.0/events/activeAlerts/EA35F98A144E11E2BA81864E72900ECC?type=excluded&escapeHTML=true
The following example returns a list of all acknowledged active alerts for the specified device.
GET https://192.0.2.0/events/activeAlerts/EA35F98A144E11E2BA81864E72900ECC?type=acknowledge

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.
401UnauthorizedThe user cannot be authenticated. Authentication has not been provided or has failed. A descriptive error message is returned in the response body.
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

Table 1. Default information about all active alerts
AttributesTypeDescription
alertIDStringAlert identifier
argsArray of stringList of dynamic arguments in the event message string. If not available, an empty string is returned.

If not available, an empty string is returned.

bayTextString 
chassisTextString 
commonEventIDStringCommon event ID
componentIDStringID of the component associated with the active alert
componentIdentifierTextStringComponent description. This can be one of the following values.
  • Canister/Appliance

  • Client Data Storage Device

  • Cooling

  • Device Driver

  • Display

  • Hypervisor

  • I/O connectivity

  • Interconnect (Fabric)

  • Interconnect (Interfaces)

  • Interconnect (Networking)

  • Interconnect (PCI Manager)

  • Interconnect (PIE)

  • Interconnect (Utilities / Infrastructure)

  • Memory

  • OS

  • OS/Hypervisor Interface

  • Power

  • Processing

  • Storage RAID

  • System board

  • Systems Management

  • Time Reference

  • Unknown

  • Vendor Events

  • VPD

eventClassStringSource of the event. This can be one of the following values.
  • 50. Unknown
  • 200. Audit
  • 300. Cooling
  • 400. Power
  • 500. Disks (storage)
  • 600. Memory
  • 700. Processor
  • 800. Rack or tower server
  • 900. Test
  • 1000. Adapter card
  • 1100. Expansion board
  • 1200. Flex System switch
  • 1300. Flex System server
  • 1400. switch
eventDateStringTime and date that the event was created on source system. This is the time and date from the managed system and might be quite different from timeStamp, which is when the event was processed by the Lenovo XClarity Administrator.
The string is in ISO-8601 format:
yyyy-MM-dd'T'HH:mm:ss'Z'
eventIDStringEvent ID is a unique identifier for each event supported by a product
eventSourceTextString 
failFRUNamesArray of stringsFor hardware fault events, includes names of one or more FRUs that are associated with the fault

If not available, an empty string is returned.

failFRUPartNumbersArray of stringsFor hardware fault events, includes part numbers for one or more FRUs that are associated with the fault

If not available, an empty string is returned.

failFRUsArray of stringsFor hardware fault events, includes FRU numbers for one or more FRUs that are associated with the fault

If not available, an empty string is returned.

failFRUUUIDsArray of stringsFor hardware fault events, includes UUIDs for one or more FRUs that are associated with the fault

If not available, an empty string is returned.

failSNsArray of stringsFor hardware fault events, includes serial numbers for one or more FRUs that are associated with the fault

If not available, an empty string is returned.

flagsString 
fruSerialNumberTextString 
groupNameArray of stringsList of resource-groups, by name, to which the source of the alert belongs. If the source does not belong to a resource group, the value is Not Available.
groupUUIDArray of stringsList of resource-groups, by UUID, to which the source of the alert belongs.
isManagementBoolean 
locationStringLocation information for event association in the format of Slot#01
msgStringEvent message string. This is provided in the language requested if translation is supported. If translation is not supported, the message as received in the event will be provided, in whatever language the product provided at time of event (typically this is English).
msgIDString 
raisedDateStringDate/time active alert was raised by REST user in the ISO-8601 format.
yyyy-MM-dd'T'HH:mm:ss'Z
relatedAlertsStringOther alerts related to this alert, if applicable.
serviceStringIndicates how service is performed. This can be one of the following value.
  • 100 . Not serviceable.
  • 200. Serviceable by Lenovo (called home).
  • 300. Serviceable by the customer.
serviceabilityTextString 
severityIntegerSeverity. This can be one of the following values.
  • 100. Unknown. The severity is unknown.
  • 200. Informational. Informational
  • 300. Warning. User can decide if action is needed.
  • 400. Minor. Action is needed, but the situation is not serious at this time.
  • 500. Major. Action is needed now.
  • 600. Critical. Action is needed now and the scope is broad (perhaps an imminent outage to a critical resource will result).
  • 700. Fatal. A non-recoverable error has occurred.
severityTextStringSeverity text. This can be one of the following values.
  • Unknown. The severity is unknown.
  • Informational. Informational
  • Warning. User can decide if action is needed.
  • Minor. Action is needed, but the situation is not serious at this time.
  • Major. Action is needed now.
  • Critical. Action is needed now and the scope is broad (perhaps an imminent outage to a critical resource will result).
  • Fatal. A non-recoverable error has occurred.

If not available, an empty string is returned.

sourceIDStringSystem UUID for the system or device that is/was the event source (raiser/owner)
systemFruNumberTextString 
systemNameStringSystem identifier. It correlates to the display name used for the device on the CMM
systemSerialNumberTextString 
systemTextString 
systemTypeModelTextString 
systemTypeTextString 
typeTextStringEvent type. This can be one of the following values.
  • Unknown
  • Audit
  • Cooling
  • Power
  • Disks. Storage
  • Memory
  • Processor
  • System. Rack or tower server
  • Test
  • Adaptor. Adapter card
  • Expansion. Expansion board
  • IOModule. Flex System switch
  • Blade. Flex System server
  • Switch. switch
The following example is returned if the request is successful.
{
"alertID": "IAL:1:FFB657408BEB4161950704AB0ED3A84A",
"args": ["FFB657408BEB4161950704AB0ED3A84A",""],
"bayText": "Not Available",
"chassisText": "Not Available",
"commonEventID": "",
"componentID": "FFB657408BEB4161950704AB0ED3A84A",
"componentIdentifierText": "Unknown",
"eventClass": 800,
"eventDate": "2019-07-08T16:19:10Z",
"eventID": "FQXHMDM0163J",
"eventSourceText": "Hardware",
"failFRUNames": [],
"failFRUPartNumbers": [],
"failFRUs": [],
"failFRUUUIDs": [],
"failSNs": [],
"flags": "",
"fruSerialNumberText": "Not Available",
"groupName": ["Not Available"],
"groupUUID": [],
"isManagement": true,
"location": "",
"msg": "The connection between the management server and the management controller
FFB657408BEB4161950704AB0ED3A84A is offline.",
"msgID": "FQXHMDM0163J",
"raisedDate": "2019-07-08T16:19:10Z",
"relatedAlerts": "",
"service": 100,
"serviceabilityText": "Not Required",
"severity": 300,
"severityText": "Warning",
"sourceID": "FFB657408BEB4161950704AB0ED3A84A",
"systemFruNumberText": "Not Available",
"systemName": "",
"systemSerialNumberText": "Not Available",
"systemText": "Not Available",
"systemTypeModelText": "Not Available",
"systemTypeText": "Not Available",
"typeText": "System"
}