Owner's Manual

9 REST API Guide – OpenManage Essentials | Version 1.0
1.8 Data Pagination
Data pagination can be accomplished by providing additional information in the GET request
corresponding to a chunk of data. The response returns information on the total number of entries that
could be used to reset any page numbering if the data has changed since the last call.
<BASE_URI>/Alerts/$top=250
This query will return the first chunk of data corresponding to the top 250 records.
<BASE_URI>/Alerts/$skip=250&$top=250
This query will skip the first 250 records and return effectively the next 250 records.
Note: The pagination keywords ($top and $skip) are case sensitive.
Data pagination may be combined with data filtering. However, the data pagination key- value pairs must
appear first. For example, if you want to retrieve the top 100 devices with critical status, use the following
command:
<BASE_URI>/Devices/$top=100?GlobalStatus=16
As many devices with a health status identified by 16 (Critical) will be returned. The number of devices
returned could be less than the maximum of 100 that was requested.
1.9 Request Headers
The request header represents headers in the client HTTPS request that are used to communicate client
preferences to the service end- point. The service will indicate the supported preference in the response
header. The following table includes a few examples of request headers. For an extensive list of request
headers, see List of HTTP header fields
.
Request Header
Description
Example
Accept Format of the data that is requested by
the client. This could be one or more
values that are comma- separated.
Accept: application/xml, application/json
Accept- Encoding Encoding scheme. For example, to
compress data to save bandwidth.
Accept- Language Choice of language that can be
requested by the client.
Accept- Language: en
x- dell- api- version Version of the API that is requested by
the client.
x- dell- api- version:1.1