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 running 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" : "...",
"descr"="..."
}
In the above request the enrollmentFileName refers to the enrollment file that contains a list of enrollment file policies.
The activityId refers to a bulk update activity.
If the activity id refers to an activity that is not a bulk update activity, the service completes successfully but has no results.
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-RPOL-001 |
Fatal |
Enrollment File with name {enrollmentFileName} is unknown |
POL-IP-RPOL-002 |
Fatal |
Activity with id {id} is unknown 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.