You are viewing the documentation for a prerelease version.

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.