- URL:https://<permissions-url>/add
(POST only)
- Required Capability:Default administrator role | All authorized privileges
- Version Introduced:10.1
Description
Assigns a new permission to a role (principal). The permission on a parent resource is automatically inherited by all child resources. For more information on the permissions model, see the section on the Continuous Inheritance Model. Permissions are represented in JSON format as described in the parameters section. At 10.1 is it only possible to allow or deny access to a resource.
Caution:
If a child resource has pre-existing permissions that oppose the permissions being assigned, its permissions are overwritten with the parent's permission. The permissions on the child become those of its parents. To check if a resource has a child resource with conflicting permissions, use the Has Child Permissions Conflict operation.Request parameters
| Parameters | Details |
|---|---|
| principal | The name of the role for whom the permission is being assigned. Example |
| isAllowed | Tells if access to a resource is allowed or denied. Values: true | false |
| f | The response format. The default response format is html. Value: html | json | pjson |
Example usage
Below is a sample POST request for add:
POST /webadaptor/admin/services/Maps/permissions/add HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
principal=Analysts&isAllowed=true&f=jsonJSON Response example
{"status": "success"}