List Folder Permissions - Latest

Overview

This operation returns the list of permissions on a folder for the user (or their roles). The list includes permissions which are inherited from the parent folders.

If a path of a folder is specified on which the user does not have permissions, the service returns empty permission for that folder.

The available permissions can be READ or WRITE.

ACL Authorization Flow

The user making this request will get permissions only on those resources on which user has at least READ permission.

HTTP GET URL Format

HTTP GET http://<server>:<port>/rest/Spatial/AccessControlService/permissions/folders

HTTP GET http://<server>:<port>/rest/Spatial/AccessControlService/permissions/folders/repositoryFolderPath

Parameters

HTTP POST URL Format

The following format is used for HTTP POST requests:

HTTP POST URL: /permissions/folders
POST BODY: {
   "resources":[
      "/Samples/NamedTables/",
      "/Samples/NamedMaps/"
   ]
} 
POST HEADER: Content-Type:application/json

Returns

Returns the list of folders a user (or their roles) has permissions on.

Example for GET

Request URL

http://<server>:<port>/rest/Spatial/AccessControlService/permissions/folders/Samples/NamedLayers/

Response

{
   "name":"/Samples/NamedLayers/",
   "permissions":[
      "READ",
      "WRITE"
   ]
}

Example for POST

Request URL

http://<server>:<port>/rest/Spatial/AccessControlService/permissions/folders/

Request Body

{
   "resources":[
      "/Samples/NamedTables/",
      "/Samples/NamedMaps/"
   ]
}

Response

{
   "resourcePermissions":[
      {
         "name":"/Samples/NamedTables/",
         "permissions":[
            "READ",
            "WRITE"
         ]
      },
      {
         "name":"/Samples/NamedMaps/",
         "permissions":[
            "READ",
            "WRITE"
         ]
      }
   ]
}