Liste ACL par ressource

Présentation

Cette opération renvoie les autorisations sur les ressources nommées spécifiées pour tous les utilisateurs et rôles. La liste de ressources peut inclure des dossiers ou des chemins d'accès à des ressources nommées. Pour chacune des ressources, la réponse contient les utilisateurs ou les rôles qui disposent d'autorisations sur la ressource.

  • Pour les tables nommées, les autorisations peuvent être EXECUTE, CREATE, MODIFY ou DELETE.
  • Pour les dossiers du référentiel, les autorisations peuvent être READ ou WRITE.
  • Pour les autres ressources nommées, les autorisations peuvent être EXECUTE.
Remarque : Les points suivants doivent être pris en compte lors de la requête :
  • Le dossier du référentiel doit comporter une barre oblique finale dans la requête POST, sinon une erreur est renvoyée.
  • Le chemin d'accès à la ressource nommée ne doit pas comporter de barre oblique finale, sinon une erreur est renvoyée.

Flux d'autorisation ACL

L'utilisateur effectuant cette requête ne pourra répertorier que les autorisations sur les ressources dans les dossiers (ou sous-dossiers) du référentiel sur lesquels il dispose de l'autorisation WRITE.

Format d'URL GET HTTP

Le format suivant est utilisé pour les requêtes HTTP GET demandant de répertorier les ACL par ressource :

HTTP GET http://<server>:<port>/rest/Spatial/AccessControlService/acl/resources/resourceName

Paramètres

Paramètre Type Obligatoire Description
resourceName Chaîne Oui Spécifie le chemin d'accès complet à une ou plusieurs ressources nommées. La ressource peut être un chemin d'accès à un dossier ou une ressource.

Format d'URL POST HTTP

Les requêtes POST HTTP se présentent au format suivant :

HTTP POST URL: /acl/resources
POST BODY: {
   "resources":[
      "/Samples/NamedTiles/WorldTile",
      "/Samples/NamedMaps/WorldMap"
   ]
}
POST HEADER: Content-Type:application/json

Résultat

Renvoie les autorisations de tous les utilisateurs et rôles sur la liste de ressources spécifiée.

Exemple pour GET

URL de requête

http://<server>:<port>/rest/Spatial/AccessControlService/acl/resources/Samples/NamedTiles/WorldTile

Réponse

{
   "resourceAclList":[
      {
         "name":"/Samples/NamedTiles/WorldTile",
         "resourceType":"NamedTile",
         "users":[
            {
               "name":"user1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ],
         "roles":[
            {
               "name":"role1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ]
      }
   ]
}

Exemple pour POST

URL de requête

http://<server>:<port>/rest/Spatial/AccessControlService/acl/resources

Corps de la requête

{
   "resources":[
      "/Samples/NamedTiles/WorldTile",
      "/Samples/NamedMaps/WorldMap"
   ]
}

Réponse

{
   "resourceAclList":[
      {
         "name":"/Samples/NamedTiles/WorldTile",
         "resourceType":"NamedTile",
         "users":[
            {
               "name":"user1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ],
         "roles":[
            {
               "name":"role1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ]
      },
      {
         "name":"/Samples/NamedMaps/WorldMap",
         "resourceType":"NamedMapAndView",
         "users":[
            {
               "name":"user1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ],
         "roles":[
            {
               "name":"role1",
               "permissions":[
                  "EXECUTE"
               ]
            }
         ]
      }
   ]
}