White Papers

OpenManage Essentials-Specific Resource Model
34 REST API Guide–OpenManage Essentials
Attribute Name
Description
Id
The identifier of the relationship.
DeviceGroupId
The device group identifier of the child device group.
ParentDeviceGroupId
The device group identifier of the parent device group.
The attributes associated with the individual entries of the DeviceGroupToDevice section of the returned
payload are described in the following table:
Attribute Name
Description
Id
The identifier of the relationship.
DeviceId
The device identifier of the child device.
ParentGroupId
The device group identifier of the parent device group.
2.5.1 Retrieving Device Hierarchy Information That Has Changed
To retrieve device hierarchy information that has changed, the DeviceGroupHierarchy GET API is used by
providing the timestamps as part of the command construction:
<BASE_URI>/DeviceGroupHierarchy/{HierarchyAddedOrUpdatedTimestamp}&
{HierarchyDeletedTimestamp}&{ DeviceGroupAddedOrUpdatedTimestamp}&{
DeviceGroupDeletedTimestamp}&{ DeviceToGroupAddedOrUpdatedTimestamp}&{
DeviceToGroupDeletedTimestamp}
Operations Supported : GET
For example, to get the complete device hierarchy, the following API can be used:
https://<OME_SERVER>:2607/api/OME.svc/DeviceGroupHierarchy
To retrieve device hierarchy information that has changed use a command such as the following:
https://OME_SERVER>:2607/api/OME.svc/DeviceGroupHierarchy/0,0,0,0,0,2,32,205&0,0
,0,0,0,2,32,205&0,0,0,0,0,2,32,204&0,0,0,0,0,2,32,204&0,0,0,0,0,2,32,207&0,0,0,0
,0,2,32,207
2.6 Device Logs
The following resource URI can be used to retrieve the device logs:
<DEVICE_BASE_URI>/<DEVICE_ID>/HWLogs/SEL (to retrieve the SEL logs)
OpenManage Essentials may expose Lifecycle Controller logs in the future and that would require a separate
URI construct as the attributes exposed are slightly different (for example, recommended action and detailed
description).
Operations supported: GET
The attributes associated with each log entry are represented in the following table:
Attribute Name
Description
Severity
The severity of the log message.
Date
The date and time of the message.
Message
The message associated with the HW log entry.