Reject Enrollment File

This operation sets the status of an enrollment file to REJECTED and reverts all policies that are linked to the enrollment file. It also sets all related policy update requests to the status REJECTED.

This operation is available on any enrollment file that has the status IN REVIEW.

Rejecting an enrollment file is a long running operation, initiated by a HTTP POST request to api-context-root/enrollmentfiles/<id>/reject.

Long-Running Operations Through REST are described in the development guide.

Resource Representation

Resource representation of an enrollment file that can be rejected:

{
  ... enrollment file properties ...
  "links": [
    {
      "href": "http://<host>:<port>/[api-context-root]/generic/enrollmentfiles/<id>",
      "rel": "self"
    },
    {
      "href": "http://<host>:<port>/[api-context-root]/enrollmentfiles/<id>/reject",
      "rel": "enrollmentfile:reject"
      "httpMethod": "POST"
    }
  ]
}

Reject Operation

If the enrollment file already has the status ACCEPTED or REJECTED, this operation has no effect. Otherwise:

  • The enrollment file status is set to REJECTED.

  • All policies that are linked to the enrollment file regardless of their status are reverted.

  • All policy update requests that are linked to the enrollment file are set to status REJECTED.

  • All the other policy update requests linked to the above policies with the status LOADED are set to status QUEUED (Update requests from other enrollment files or individual update requests)

    • No change for the other policy update requests with FAILED, QUEUED, PROCESSED, PROCESSED NO UPDATE and INITIAL status

  • If no update request with status FAILED exist for the policy, attachedpolicydata.disableUpdateFromQueue is set to false i.e. allow auto processing of new policy update requests

  • If the first version of the policy is reverted, Policy GID is removed form all the matched policy update requests

Response Messages

This operation provides HTTP status codes as defined in Response Messages. If an error occurs, the appropriate HTTP status code is returned and a notification is sent containing the details of the error.

The following operation specific error can occur:

Code Severity Message Text

POL-HTTP-024

Fatal

This enrollment file has already been accepted or rejected.

Authorization

The above described operation is protected by access restriction reject enrollment file IP.