MarkLogic 12 Product Documentationsec:role-remove-roles
sec:role-remove-roles( $role-name as xs:string, $role-names as xs:string* ) as empty-sequence()
Summary
Removes the roles ($role-names) from the set of roles included by the
role ($role-name).
If a role with name equal to $role-name is not found, an error is
returned.
If one of $role-names does not correspond to an existing role, an error is
returned.
If the current user is limited to granting only his/her roles,
and $old-role is not a subset of the current user's roles, then an error is
returned.
| Parameters | |
|---|---|
| role-name | The name of a role. |
| role-names | The name of the roles to remove from the role. |
Required Privileges
http://marklogic.com/xdmp/privileges/role-remove-rolesand for role removal:
http://marklogic.com/xdmp/privileges/grant-all-roles orhttp://marklogic.com/xdmp/privileges/grant-my-roles
Usage Notes
This function must be executed against the security database.
Example
(: execute this against the security database :)
xquery version "1.0-ml";
import module namespace sec="http://marklogic.com/xdmp/security" at
"/MarkLogic/security.xqy";
sec:role-remove-roles("Contractor", ("Developer", "alert-internal"))
(: Removes the "Developer" and "alert-internal" roles from the "Contractor" role. :)