Loading TOC...


   $config as element(configuration),
   $host-id as xs:unsignedLong,
   $value as xs:unsignedLong
) as element(configuration)


This function changes the group to which an existing host belongs to the newly specified value.

config A configuration specification, typically as returned from one of the Admin module functions.
host-id The host ID. Typically, the result of an admin:host-get-id call.
value The new group ID value (typically from a admin:group-get-id call.

Required Privileges

This operation requires at least one of the following privileges:



Usage Notes

Any group whose ID you pass into this function must exist when the transaction begins, otherwise an exception is thrown. If you need to create the group, do so in a separate transaction before using them in in this function.


  xquery version "1.0-ml";

  import module namespace admin = "http://marklogic.com/xdmp/admin"
		  at "/MarkLogic/admin.xqy";

  let $config := admin:get-configuration()
  let $hostid := admin:host-get-id($config, xdmp:host-name())
  admin:host-set-group($config, $hostid,
      admin:group-get-id($config, "Default"))

  (: returns the new configuration element -- use admin:save-configuration
     to save the changes to the configuration or pass the configuration
     to other Admin API functions to make other changes.  :)


Stack Overflow iconStack Overflow: Get the most useful answers to questions from the MarkLogic community, or ask your own question.