List ACL by Role

Overview

This operation returns all of the permissions for all named resources for the specified role. The response contains the named resources and respective permissions applied to them.

For named tables, the permissions can be EXECUTE, CREATE, MODIFY, or DELETE
For repository folders, the permissions can be READ or WRITE
For other named resources, the permissions can be EXECUTE

ACL Authorization Flow

The user making this request will only be able to list permissions on resources within the repository folders (or subfolders) on which they have WRITE permissions.

HTTP GET URL Format

The following format is used for HTTP GET requests to list ACL by user roles:

HTTP GET http://<server>:<port>/rest/Spatial/AccessControlService/acl/roles/roleName?resourceType=type

Parameters


Parameter	Type	Required	Description
roleName	String	Yes	Specifies name of the role.
type	String	No	Specifies the type of name resource to filter the response. This can be one or more of NamedTable, NamedFeatureLayer, NamedLabelLayer, NamedGroupLayer, NamedPieLayer, NamedBarLayer, NamedGraduatedSymbolLayer, NamedLineChartLayer, NamedLineLinkageLayer, NamedFeatureLabelSource, NamedMapAndView, NamedTile, NamedWMTSLayer, or RepositoryFolder. NamedGraduatedSymbolLayer, NamedLineChartLayer, NamedLineLinkageLayer, NamedFeatureLabelSource, NamedMapAndView, NamedTile, NamedWMTSLayer, or RepositoryFolder.

Returns

Returns permissions for all resources for the specified role.

Example for GET

Request URL

http://<server>:<port>/rest/Spatial/AccessControlService/acl/roles/role1

Response

{
   "usersRolesAclList":[
      {
         "usersACL":[

         ],
         "rolesACL":[
            {
               "name":"role1",
               "resources":[
                  {
                     "name":"/Samples/NamedTiles/",
                     "permissions":[
                        "READ",
                        "WRITE"
                     ],
                     "resourceType":"RepositoryFolder"
                  },
                  {
                     "name":"/Samples/",
                     "permissions":[
                        "READ",
                        "WRITE"
                     ],
                     "resourceType":"RepositoryFolder"
                  },
                  {
                     "name":"/Samples/NamedTiles/WorldTile",
                     "permissions":[
                        "EXECUTE"
                     ],
                     "resourceType":"NamedTile"
                  }
               ]
            }
         ]
      }
   ]
}