API Guide

Table Of Contents
Table 6. HTTP methods (continued)
HTTP method Description Example
DELETE Used for removing a specific resource. If
the resource does not exist, a Success
response is returned.
Delete a specific user account.
DELETE
<BASE_URI>/AccountService/
Accounts('1414')
When you perform tasks using these methods, they return an HTTP response code. For more information about the response
codes, see Status Code Definitions on the W3.org website. If a method fails, you may also see an Error and Event Message
code. You can search for more details about this code using the Dell QRL app on your mobile device.
Security considerations
For performing update and delete operations, you must be authorized to perform the operations on the resource. If you do not
have the required permission, an Unauthorized error is returned.
Data filtering
The console software provides filtering options on certain URIs that return a collection of entities. Using this feature, the clients
can extract a selected set of records using comparison operators on attributes of the model entity behind the collection. The
relevant URI sections contain the information about the attributes and the operators that support filtering.
<Collection API>?$filter=<attribute> <operator> <value>&<attribute> <operator> <value>
Examples:
Filter devices by
system ID
/api/DeviceService/Devices?$filter=SystemId eq 123
Filter devices by
model
/api/DeviceService/Devices?$filter=Model eq 'PowerEdge MX740c'
Filter devices by
device type
/api/DeviceService/Devices?$filter=Type eq 3000 or Type eq 5000
NOTE: For enumeration of Type, see /api/DeviceService/DeviceType.
For more information about $filter, see OData Version 4.0 Part 1: Protocol at docs.oasis-open.org.
Data sorting
The console software provides sorting options on certain URIs that return a collection of entities. The sorting options enable the
clients to get sorted results using the Sort operators on certain attributes of the model entity behind the collection. The relevant
URI section contain information about the attributes that support sorting.
<Collection API>?$orderby=<attribute> <asc/desc>
Examples: Get devices sorted in ascending order by Status
/api/DeviceService/Devices?$orderby=Status asc
NOTE: For enumeration of Status, see /api/DeviceService/DeviceStatuses.
NOTE: For more information about $orderby, see OData Version 4.0 Part 1: Protocol at docs.oasis-open.org.
28 Key integration concepts