Loading TOC...

admin.forestBackupSetEnabled

admin.forestBackupSetEnabled(
   $config as element(configuration),
   $forest-id as (Number|String),
   $backup-id as (Number|String),
   $enabled as Boolean
) as element(configuration)

Summary

This function enables forest backup for 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. For example, xdmp:forest("myForest") specifies the ID for a forest named "myForest".
$backup-id The ID of the backup, found by XPath to the backup location (for example, //fa:backup-id/).
$enabled Enables forest backup. The default is true, which means the forest backup will occur.

Required Privileges

This operation requires at least one of the following privileges:

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

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

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

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

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

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

Example



xquery version "1.0-ml";

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

  let $config := admin:get-configuration()
  let $forest-id xdmp:forest("Documents")
  let $backup-ids := admin:forest-get-backups(
  admin:get-configuration(), xdmp:forest("Documents"))//fa:backup-id/fn:data()
  return
  admin:forest-backup-set-enabled($config, $forest-id, backup-ids, fn:true())

 (: 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.