Backup Service API

  • reference
    +
    The Backup Service API allows full and incremental data-backups to be planned and scheduled; allows the scheduling of merges of previously made backups; and allows existing backups to be archived.

    APIs in this Section

    The Backup Service API endpoints can be grouped into several categories:

    For an overview of the Backup Service, see Backup Service. For information on using Couchbase Server Web Console to configure and use the Backup Service, see Manage Backup and Restore.

    All calls require the Full Admin role, and use port 8097. Each URI, in Couchbase Server Enterprise Edition Version 7.0, must be prefixed with /api/v1. Note that for all cluster references, in Couchbase Server Enterprise Edition Version 7.0 and 7.1, only the host cluster is supported, and is referred to as self.

    For a list of the methods and URIs covered in these pages, see the tables below.

    Cluster

    HTTP Method URI Documented at

    GET

    /api/v1/cluster/self

    Get Information on the Cluster

    Configuration

    HTTP Method URI Description

    GET

    /api/v1/config

    Manage Backup Configuration

    POST

    /api/v1/config

    Manage Backup Configuration

    PUT

    /api/v1/config

    Manage Backup Configuration

    GET

    /api/v1/nodesThreadsMap

    Manage Backup Service Threads

    PATCH

    /api/v1/nodesThreadsMap

    Manage Backup Service Threads

    POST

    /api/v1/nodesThreadsMap

    Manage Backup Service Threads

    Repository

    HTTP Method URI Documented at

    GET

    /api/v1/cluster/self/repository/<'active'|'archived'|'imported'>

    Get Backup Repository Information

    GET

    /api/v1/cluster/self/repository/active/<repository-id>

    Get Backup Repository Information

    GET

    /api/v1/cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/info

    Get Backup Repository Information

    POST

    /api/v1/cluster/self/repository/active/<repository-id>

    Create a Repository

    POST

    /api/v1/cluster/self/repository/<'archived'|'imported'>/<repository-id>/restore

    Restore Data

    POST

    /api/v1/cluster/self/repository/import

    Import a Repository

    POST

    /api/v1/cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/examine

    Examine Backed-Up Data

    POST

    /api/v1/cluster/self/repository/active/<repository-id>/backup

    Perform an Immediate Backup

    POST

    /api/v1/cluster/self/repository/active/<repository-id>/merge

    Perform an Immediate Merge

    POST

    /api/v1/cluster/self/repository/active/<repository-id>/archive

    Archive a Repository

    POST

    /api/v1/cluster/self/repository/active/<repository-id>/pause

    Pause and Resume Tasks

    POST

    /api/v1/cluster/self/repository/active/<repository-id>/resume

    Pause and Resume Tasks

    DELETE

    /api/v1/cluster/self/repository/<'archived'|'imported'>/<repository-id>

    Delete a Repository

    DELETE

    /api/v1/cluster/self/repository/<'archived'|'imported'>/<repository-id>?remove_repository

    Delete a Repository

    DELETE

    /api/v1/cluster/self/repository/active/<repository-id>/backups/<backup-id>

    Delete a Backup

    Plan

    HTTP Method URI Documented at

    GET

    /api/v1/cluster/plan

    Get Backup Plan Information

    GET

    /api/v1/cluster/plan/<plan-id>

    Get Backup Plan Information

    POST

    /api/v1/cluster/plan/<plan-id>

    Create and Edit Plans

    PUT

    /api/v1/cluster/plan/<existing-plan-id>

    Create and Edit Plans

    DELETE

    /api/v1/plan/<plan-id>

    Delete a Plan

    Task

    HTTP Method URI Documented at

    GET

    /api/v1/cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/taskHistory

    Get Backup Task History

    GET

    /api/v1/cluster/self/repository/<'active'|'archived'|'imported'>/<repository-id>/taskHistory?<task-subset-specification-string>

    Get Backup Task History

    Data

    HTTP Method URI Documented at

    DELETE

    /api/v1/cluster/self/repository/active/<repository-id>/backups/<backup-id>

    Delete Backups