MarkLogic 12 EA 1 Product Documentation

sec.protectCollection

sec.protectCollection(
   uri as String,
   permissions as element(sec.permission)[]
) as (Number|String)

Summary

Protects a collection $uri with the given permissions ($permissions). Returns the unique id of the protected collection. If the protected collection at the specified URI does not exist, it is created.

Required Privileges

Usage Notes

If $uri is empty or can not be cast as an xs:AnyURI, an error is raised.

If a collection with the same uri is already protected, an error is raised.

This function must be executed against the security database.

Example

// execute this against the security database

declareUpdate(); 
const sec = require('/MarkLogic/security.xqy');

sec.protectCollection("http://marklogic.com/dev_modules", 
                       [xdmp.permission("Temporary", "read","element"), 
                        xdmp.permission("Temporary", "insert","element")]) 

// Users with the "Developer" role can read and insert files in "dev_modules."