Getting Pagination Details for Operations on a Device

Description

You will carry out many operations on a device. In a situation where you wish to view the all the operations carried out on a device it is not feasible to show all the details on one page therefore the details are paginated.

Example: You carry out 21 operations via a given device. When you wish to see the operations carried out, the details of the 21 operations will be broken down into 3 pages with 10 operation details per page.

Resource Path pagination/{type}/{id}

URL /mdm-admin/operations/paginate/{type}/{id}

HTTP Method GET

Request/Response Format application/json

cURL command

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-admin/paginate/operation/{type}/{id}

For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.
Define the device type as the value for {type}. Example: ios, android or windows.
Define the device ID as the value for {id}.

Example:

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -k -v https://localhost:9443/mdm-admin/paginate/operations/ios/f409r4c55924rt4af9a44tts15y9d6cd56h1047d

Filter the device details using the query parameters given below:

start - Provide the starting pagination index. Example 10

You will have many devices registered with the EMM. In a situation where you wish to view the all the registered devices it is not feasible to show all the details on one page therefore the details are paginated.
length - Provide how many device details you require from the starting pagination index. For example if you require the device details from the 10^th pagination index to the 15^th, you must define 10 as the value for start and 5 as the value for length.

If you wish to get the device details within a predefined index range you need to define both the start and length fields.
Example: https://localhost:9443/mdm-admin/devices?start=10&length=5There will be situations were you will not have device details in the specified index range. In such situation all the details of the devices registered to EMM will be given.

Sample output

> GET /mdm-admin/operations/paginate/ios/f409r4c55924rt4af9a44tts15y9d6cd56h1047d HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a
< HTTP/1.1 200 OK
< Cache-Control: private
< Expires: Thu, 01 Jan 1970 05:30:00 IST
< Date: Tue, 23 Feb 2016 05:23:56 GMT
< Content-Type: application/json
< Content-Length: 3785
< Server: WSO2 Carbon Server
{"recordsTotal":6,"recordsFiltered":6,"draw":0,"data":[
{"code":"DEVICE_INFO","type":"COMMAND","id":38,"status":"PENDING","receivedTimeStamp":"","createdTimeStamp":"2016-02-23 10:51:22.06","isEnabled":false},{"code":"APPLICATION_LIST","type":"COMMAND","id":37,"status":"PENDING","receivedTimeStamp":"","createdTimeStamp":"2016-02-23 10:51:20.755","isEnabled":false}]}

Sample JSON Output
Definition

{  
   "code":"ALARM",
   "type":"COMMAND",
   "id":34,
   "status":"COMPLETED",
   "receivedTimeStamp":"2016-02-23 09:57:22.113",
   "createdTimeStamp":"2016-02-23 09:57:21.113",
   "isEnabled":false
},

Property Value	Description
`code`	The code of the operation that you carried out. For example the code of the operation carried out to ring the alarm is `ALARM`.
`type`	The operation type that was carried out on the device. The operations types can be one of the following: `COMMAND` `PROFILE`
`id`	The operations carried out on a device is recorded in a database table The ID of the operation as in this database table is given as the ID in the output.
`status`	The status of the operation that has been carried out on a device. The operation status can be any of the following: `IN-PROGRESS` - The operation is processing on the EMM server side and has not yet been delivered to the device. `PENDING` - The operation is delivered to the device but the response from the device is pending. `COMPLETED` - The operation is delivered to the device and the server has received a response back from the device. `ERROR` - An error has occurred while carrying out the operation.
`receivedTimeStamp`	The time WSO2 EMM received the response from the device.
`createdTimeStamp`	The time when the operation was requested to be carried out.
`isEnabled`	If the assigned value is true it indicates that a policy is enforced on the device. If the assigned value is false it indicates that a policy is not enforced on a device.