xdmp:forest-backup-status

xdmp:forest-backup-status(
   $forestid as xs:unsignedLong*
) as element()*

Summary

Checks the status of the specified forests for any outstanding backup jobs. Returns the specified forests portion a database backup status node defined in the job-status.xsd schema.

Required Privileges

http://marklogic.com/xdmp/privileges/xdmp-database-backup-status

Usage Notes

The structure of the data returned is as follows:

forest

The forest being backed up. There is one forest element for each forest in the backup.

This is a complex element with the following element children:

forest-name

The name of the forest.

forest-id

The forest ID.

status

The status of the forest backup. The status is one of: "queued", "in-progress", "failed", "canceled", completed", or "unknown".

restore-to-time

The date and time this backup was created.

journal-archiving

Is journal archiving enabled for a full backup?

journal-archive-path

Path to the associated journal archive location.

safe-restore-to-time

The date and time this backup was created.

journal-archive-lag-limit

Number of seconds the archived journal can lag the active journal.

host-name

Hostname where this forest is backup.

backup-path

Path to the backup location.

incremental-backup-path

Path to the backup location.

job-id

The job ID.

status

The status of the forest backup. The status is one of: "queued", "in-progress", "failed", "canceled", completed", or "unknown".

Example

xdmp:forest-backup-status(33030877979801813489, 16529920850295602277)
=>
<job:job-status xsi:schemaLocation="http://marklogic.com/xdmp/job-status
   job-status.xsd" xmlns:job="http://marklogic.com/xdmp/job-status"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <job:forest>
    <job:forest-name>Documents</job:forest-name>
    <job:forest-id>9157142760003704384</job:forest-id>
    <job:status>in-progress</job:status>
    <job:journal-archiving>true</job:journal-archiving>
    <job:journal-archive-path>/backup/JournalArchive</job:journal-archive-path>
    <job:journal-archive-lag-limit>15</job:journal-archive-lag-limit>
  </job:forest>
</job:job-status>