MarkLogic 10 Product Documentation
admin:forest-get-replicas

admin:forest-get-replicas(
   $config as element(configuration),
   $forest-id as xs:unsignedLong
) as xs:unsignedLong*

Summary

This function returns the IDs of the forest replicas for the specified forest. If it returns the empty sequence, then no replicas are assigned to the specified forest.

Parameters
config	A configuration specification, typically as returned from one of the Admin module functions.
forest-id	The ID of the forest having the replica forests to be returned (for example, `xdmp:forest("myForest")` ).

Required Privileges

This operation requires at least one of the following privileges:

http://marklogic.com/xdmp/privileges/admin/forest

http://marklogic.com/xdmp/privileges/admin/forest/{id}

Example


  xquery version "1.0-ml";

  import module namespace admin = "http://marklogic.com/xdmp/admin"
      at "/MarkLogic/admin.xqy";

  let $config := admin:get-configuration()
  let $forest := xdmp:forest("Documents")

  return admin:forest-get-replicas($config, $forest)

  (: Returns the forest replicas associated with the Documents forest. :)

MarkLogic 10 Product Documentationadmin:forest-get-replicas

Summary

Required Privileges

Example

MarkLogic 10 Product Documentation
admin:forest-get-replicas