White Papers
18 REST API Guide OpenManage Essentials | Revision A02
This operation deletes the specified custom group if it exists in OME. If the specified group is not present in
OME, a corresponding error is returned. Any groups other than custom groups cannot be deleted.
Only OmeAdministrators, OmePowerUsers, and OmeSiteAdministrators will have the permission to delete a
custom device group, provided they also have the 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 Devices
The URI for accessing devices in OpenManage Essentials could be either based on the parent group resource
or by directly accessing the devices. For example:
Devices by group (immediate child devices): <BASE_URI>/DeviceGroups/<ID>/ChildDevices
Devices by group (all devices): <BASE_URI>/DeviceGroups/<ID>/Devices
Devices by direct access :< BASE_URI>/Devices
Any of the URIs specified earlier will be referenced as the <DEVICE_BASE_URI> in the subsequent sections
of this document.
Devices (sorted): <BASE_URI>/Devices/$sort(column=<attribute name(s)>;direction=<sort direction(s)>)
Operations supported: GET
Attributes (filtering): Id, Type, Name, DNSName, and GlobalStatus
Attributes (sorting): Name Asc (by default), Id, and GlobalStatus
The attributes associated with each device are described in the following table.
Attribute Name
Description
Id
The unique identifier for the device.
Type
The type enumeration for the device.
Name
The name of the device.
DNSName
The DNS name of the device.
iDRACName
The name of the iDRAC on the device.
SystemId
The system identifier of the device.
GlobalStatus
The global HW status of the device.
PowerStatus
The power status of the device.
ServiceTag
The Service Tag of the device.