Versions Compared

Old Version 1

changes.mady.by.user Former user

Saved on

compared with

New Version 2

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

Excerpt
DescriptionAdd a screen lock on Android devices.
Resource Path/lock
URL/mdm-android-agent/operation/lock
HTTP MethodPOST
Request/Response Formatapplication/json

...

Sample request

...

cURL
Localtabgroup
Localtab
activetrue
title

For information on the property value definitions, see Resource Definition for Common Android Operations. 
 

HTTP
cURL command
Code Block
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -d @'<JSON_PAYLOAD>' -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-android-agent/operation/lock
  • For more information on how to generate the EMM API token, see Generating the OAuth 2.0 Access Token.
  • Define the path to the JSON file, which lists the devices that this operation is applied on, as the  <JSON_PAYLOAD>  value.
  • 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.
For example

Example:

Code Block
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer
Mkk2R0hVaFpGdUtnTlZhY3pZbWJjWmJ0Rlo0YTpQMEh1QmpscXc4dEJIZ2FNMUN5OEdGRmRzV29h		title
f409r4c55924rt4af9a44tts15y9d6cd56h1047d" -d @'test.json' -k -v https://localhost:9443/mdm-android-agent/operation/lock
Localtab
 Sample output
Code Block
> POST /mdm-android-agent/operation/lock HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.
24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0 OpenSSL/0.9.8| zlib/1.2.5 > Host: localhost:9443
43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer
Z3h4b1BMZ2ZndkluMjBNMlYyTnk0RF9YMjRVYTo2RkFuWXlMb0I0Q24wM3RtSWV4dVZacGY5c2Nh
f409r4c55924rt4af9a44tts15y9d6cd56h1047d
> Content-Length:
23 >
21
< HTTP/1.1 201 Created
< Date:
Wed
Fri,
03
18
Jun
Mar
2015
2016
11
08:
58
18:
41
20 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server
Anchor
sample
sample
Sample JSON Output
Definition 
Code Block
[
  "d8:50:e6:2f:6a:8b",
  "a5:60:e6:2g:6a:5b"
]

Property Value

Description

Type

device id

ID of the Android device. Multiple device IDs can be added by using comma separated values. 
For more information on retrieving the device ID, see Retrieving the ID of an Android device.

String