Loading TOC...
XQuery admin:host-get-id

admin.hostGetId

admin.hostGetId(
   config as element(configuration),
   host-name as String
) as (Number|String)

Summary

This function return the ID for the specified host from the configuration. The difference between this function and xdmp:host() is that the ID from this function can come from a host that has not yet been saved (that is, from a host that has been created in the same query with the Admin library but has not yet been saved to the cluster configuration files). This ID enables you to completely configure a newly created host without the need to first save the configuration.

Parameters
config A configuration specification, typically as returned from one of the Admin module functions.
host-name The name of the host. If the host is the current host, xdmp:host-name() returns the name.

Required Privileges

This operation requires at least one of the following privileges:

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

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

Example

  
  const admin = require('/MarkLogic/admin.xqy');
  const config = admin.getConfiguration()
  admin.hostGetId(config, xdmp.hostName())

   //returns the host ID

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