White Papers

22 REST API Guide  OpenManage Essentials | Revision A02
Figure 1 Timestamps
The AddedOrUpdatedTimestamp and DeletedTimestamp denote the latest timestamps associated with the
device payload just returned. These timestamps can be used to retrieve delta information by a consumer.
2.2.2 Delete Device
The following URI allows user to delete device from OME until it is discovered next time. This will remove the
device from the device tree and it will not be shown under any group.
<BASE_URI>/Devices/{deviceid}
Operation: DELETE
Upon successful completion, the specified device will be deleted from OME. If the user provides devices ID
which are invalid, an error response will be returned.
Only OmeAdministrators, OmePowerUsers, and OmeSiteAdministrators will have the permission to delete
device from OME through REST, provided they also have local admin privilege. In case of insufficient
permissions, the operation will fail and returns an error message. Users not having local admin privilege will get

2.2.3 Changed device information
The changed device information can be obtained by the following REST API:
<BASE_URI>/Devices/{AddedOrUpdatedTimestamp}&{DeletedTimestamp}
The values of the AddedOrUpdatedTimestamp and DeletedTimestamp would have been obtained by a
previous call to the <BASE_URI>/Devices REST API.
This particular REST API will typically be used by a consumer that does its own device management and
tracking periodically based on a particular polling cycle. Instead of getting the whole list of devices to determine
the changes, the consumer will be able to retrieve only the changed device information based on the timestamps
obtained in a previous call.
For example, if the device listing was retrieved by an OpenManage Essentials REST consumer at time t1 and
the consumer needs to get information about the devices that were added or modified or deleted at time t2
where t2 > t1, then the consumer, using the AddedOrUpdatedTimestamp and DeletedTimestamp obtained
from the last call at t1, can get a list of only the changed and deleted devices.