...
| Excerpt |
|---|
| Description | Change the lock code on Android devices. |
|---|
| Resource Path | /change-lock-code |
|---|
| URL | /mdm-android-agent/operation/change-lock-code |
|---|
| HTTP Method | POST |
|---|
| Request/Response Format | application/json |
|---|
|
...
Sample request
...
For information on the property definitions, see Resource Definition to Change the Lock Code on Android Devices.
| Localtabgroup |
|---|
| Localtab |
|---|
|
| active | true |
|---|
title | cURLtitle | 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/change-lock-code |
- 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 and the corresponding lock code, as the
<JSON_PAYLOAD> value. For more information, see the Sample JSON Definition. - 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.
|
|---|
| Localtab |
|---|
Example: | Code Block |
|---|
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer f409r4c55924rt4af9a44tts15y9d6cd56h1047d" -d @'operation.json' -k -v https://localhost:9443/mdm-android-agent/operation/change-lock-code |
|
| Sample output | | Code Block |
|---|
> POST /mdm-android-agent/operation/change-lock-code HTTP/1.1
> 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
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer |
|
|---|
f409r4c55924rt4af9a44tts15y9d6cd56h1047d
> Content-Length: 86 |
|
< HTTP/1.1 201 Created
< Date: Wed, 10 Jun 2015 09:37:28 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server |
|
| Anchor |
|---|
| sampleChangeLock |
|---|
| sampleChangeLock |
|---|
|
Sample JSON Output
Definition | | Code Block |
|---|
{
"operation": {
"lockCode": "1234"
},
"deviceIDs": [
"d8:50:e6:2f:6a:8b",
"a5:60:e6:2g:6a:5b"
]
} |
Property Value | Description | Type |
|---|
operation
| This specifies the operation that is to be applied on the Android device. | Yes | lockCode
| The lock code that will replace the current lock code on Android devices. If a passcode policy has been set in EMM, the lock code should comply to the passcode policy. | Yes | deviceIDS
| 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 |
|
|---|