getacl

Return Access Control information related to a Library Member.

This information depends on the Access Control implementation associated with a server. By default, a Qizx REST Server supports an ACL implementation.

 

HTTP Request: GET

Parameters:

Name Value Description
path Path of a Library member to get. Can be specified explicitly or as the remainder the HTTP URL.
scope [optional]

If value is "local" (the default), return AC information directly attached to the Library member.

If value is "inherit", return AC all information having an effect on the Library member.

library Name of Library used (can be empty if exactly one Library in server).

Response:

 mime-type: text/xml

Depends on the Access Control implementation.

For the default ACL implementation, the result is a list of entries of type "grant" or "deny", associated with a member path, concerning either a user or a role, whose value is a list of permissions:

<accesscontrol library="mylib" class='ACLAccessControl'>
 <member path='/'><deny role="user" permissions='All'/></member>
 <member path='/users/joe'><grant user="joe" permissions='All'/></member> 
</accesscontrol>

 

Error codes:

AccessControl
when there is no access-control, or the access-control does not support this functionality