Apply Policy

This service is used to apply a policy on the device. This takes precedence over the policy applied using a device set configuration in EMM.

This service accepts a coma separated list of policy IDs defined in the EMM server.

URL

https://emmserver.com/emm/iemm/services/policy

Type

POST

Input

Input Parameters

deviceid

This is a mandatory parameter to authenticate a user.

query

This is a mandatory parameter. The possible values are:

• applypolicy

devicesetID

This is a optional parameter to verify whether a device is part of a device set.

policyid

This is a mandatory parameter and its comma-separated values of policy id should be applied on a device. Refer examples for more details.

Input Headers

Content-Type

This is a mandatory parameter, and allowed value is application/x-www-form-urlencoded.

Accept

This is an optional parameter. The default value is application/xml, and the possible values are application/xml or application/json

Cookie

This is a mandatory parameter. The value is output header parameter Set-Cookie value of the previous service.

Output

Output Parameters

responseCode

• 1000 = success
• 1003 = Error - Missing Device ID: Device ID should not be empty
• 2001 = Error: Authenticated Token is missing
• 2002 = Error: Device ID should not be empty
• 2003 = Session time out
• 3001 = Unexpected error occurred
• 3003 = Error - Improper Service Call: Please check URL and provide correct service call
• 3004 = IEmm Services are not available
• 3005 = Error - Device is not enrolled with EMM
• 3006 = Error - Invalid Policy passed

• 3007 = Error - Device does not belong to provided Device Set

• 4001 = Policy already exists on device
• 4002 = Error - Improper Policy: PolicyID not exist.
• 4003 = Error - Unpublished Policy provided

description

Please refer responseCode.

requestID

A unique identifier for requested applied policy.

policyApplied

This is a Boolean value to check if policy is applied successfully or not. The possible values are true and false.

Output Headers

Set-Cookie

Set-cookie helps to maintain sessions and passed in consecutive services as a value of the input header parameter Cookie

Examples

Input:

query=applypolicy&deviceid=fbf43e35aeb2fb9eaedf0dddf26250d4&policyid=7502395757865996819,7502560957311238180

Output:

{
   "description":"success",
   "responseCode":1000,
   "requestID":1041,
   " poicyApplied ":"true"
}

Copyright © 2018 Kony, Inc. All rights reserved.