Revert Policy Integration Point
This web service supports reverting a list of policies to their previous version. The list of policies to be reverted is retrieved either from an enrollment file or from a bulk update activity or from a policy in file request.
Reverting a list of policies to their previous version is a long ruinning operation that can be initiated by a HTTP POST request to http://[hostName]:[portNumber]/[api-context-root]/revertpolicies.
More information on the behavior of long running operations can be found in Long Running Operations Through REST.
Request
This request has the following structure:
{ "enrollmentFileName" : "...", "activityId" : "...", }
In the above request the enrollmentFileName refers to the enrollment file that contains a list of enrollment file policies.
The activiityId refers to a bulk update acitivity.
Only one of the two parameters can have a value.
This operation starts a Revert Policy to Previous Version for every policy listed in the enrollment file or handled by the activity.
Error Messages
The following error messages that are specific to this web service may be returned in the response messages:
Code | Sev | Text |
---|---|---|
POL-IP-PRPOL-001 |
Fatal |
Enrollment File with name {enrollmentFileName} is unknown |
POL-IP-RPOL-002 |
Fatal |
Activity with id {id} is unknown, not a bulk update activity or not completed. |
POL-IP-RPOL-003 |
Fatal |
Exactly one of the parameters Enrollment File Name and Activity Id must be specified |
The response can also contain generic error messages that are not specific to this web service. Please refer to them Response Messages section for more details.