MarkLogic 12 EA 1 Product Documentation

sec.roleRemoveRoles

sec.roleRemoveRoles(
   role-name as String,
   role-names as String[]
) as null

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.

Required Privileges

Usage Notes

This function must be executed against the security database.

Example

// execute this against the security database

declareUpdate(); 
const sec = require('/MarkLogic/security.xqy');
   
sec.roleRemoveRoles("Contractor", ("Developer", "alert-internal"))

// Removes the "Developer" and "alert-internal" roles from the "Contractor" role.