- URL:https://<roles-url>/assignPrivilege
(POST only)
- Required Capability:Default administrator role | All authorized privileges
- Version Introduced:10.1
Description
This operation assigns a privilege to a role.
Administrative access to ArcGIS Server is modeled as three broad tiers of privileges:
- ADMINISTER—A role that possesses this privilege has unrestricted administrative access to ArcGIS Server.
- PUBLISH—A role that possesses this privilege can only publish GIS services to ArcGIS Server.
- ACCESS—No administrative access. A role with this privilege can only be granted permission to access one or more GIS services.
By assigning these privileges to one or more roles in the role store, the ArcGIS Server security model supports role-based access control to its administrative functionality. These privilege assignments are stored independent of the ArcGIS Server role store. As a result, you don't need to update your enterprise identity stores (like Active Directory).
Note:
By default, a role in the role store does not have any administrative privileges (in other words, it has ACCESS level).
Request parameters
| Parameter | Details |
|---|---|
| rolename | The name of the role. Example |
| privilege | The capability to assign to the role. The default capability is ACCESS. Values: ADMINISTER | PUBLISH | ACCESS |
| f | The response format. The default response format is html. Values: html | json| pjson |
Example usage
Below is a sample POST request for assignPrivilege:
POST /webadaptor/admin/security/roles/assignPrivilege HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
rolename=editors&privilege=ADMINISTER&f=jsonJSON Response example
{"status": "success"}