A newer version of this documentation is available.

View Latest

Pause and Resume Tasks

      +
      The Backup Service REST API allows the running of tasks for a specified, active repository to be paused, and then resumed.

      HTTP Method and URI

      POST /cluster/self/repository/active/<repository-id>/pause
      
      POST /cluster/self/repository/active/<repository-id>/resume

      Description

      The repository-id must be the name of an active repository on the cluster. The respective URIs pause and resume the running of all tasks for the repository.

      Curl Syntax

      curl -X POST http://<backup-node-ip-address-or-domain-name>:8097/\
        api/v1/cluster/self/repository/active/<repository-id>/pause \
        -u Administrator:password
      
      curl -X POST http://<backup-node-ip-address-or-domain-name>:8097/\
        api/v1/cluster/self/repository/active/<repository-id>/resume
        -u Administrator:password

      The username and password must identify an administrator with the Full Admin role. The repository-id argument must specify the name of an active repository defined on the cluster.

      Responses

      For both URIs, success returns 200 OK. Note that neither resuming already running tasks nor pausing already paused tasks has any effect: both return 200 OK.

      An incorrectly specified URI returns 404 Object Not Found, and a message such as the following: {"status":404,"msg":"could not find repository with id: testR3epo"}. Failure to authenticate returns 401 Unauthorized.

      Examples

      The following call pauses the running of tasks for the active repository testRepo:

      curl -v -X POST  http://127.0.0.1:8097/api/v1/cluster/self/\
      repository/active/testRepo/pause \
      -u Administrator:password

      Success returns 200 OK.

      The following call resumes the running of tasks for testRepo:

      curl -v -X POST  http://127.0.0.1:8097/api/v1/cluster/self/\
      repository/active/testRepo/resume \
      -u Administrator:password

      Again, success returns 200 OK.

      See Also

      An overview of the Backup Service is provided in Backup Service. A step-by-step guide to using Couchbase Web Console to configure and use the Backup Service is provided in Manage Backup and Restore. Information on using the Backup Service REST API to create a plan (and in so doing, define one or more tasks) is provided in Create and Edit Plans. To get information on currently defined tasks, see Get Information on Tasks.