/ /

`resume`

This documentation refers to an outdated version of mongosync. View the current documentation for up-to-date guidance on mongosync and instructions on how to upgrade to the latest version.

Description

Resumes a paused synchronization session based on data stored on the destination cluster.

Requirement

To use the resume endpoint, mongosync must be in the PAUSED state.

Note

When you configure multiple mongosync instances to sync between sharded clusters, you must send identical API endpoint commands to each mongosync instance.

For more information, see Resume Multiple Mongosyncs.

Request

POST /api/v1/resume

Request Body Parameters

This endpoint does not use HTTP request body parameters. However, you must specify the --data option with an empty object { }.

Response

Field	Type	Description
`success`	boolean	When the request is successful, this value is `true`.
`error`	string	If an error occurred, indicates the name of the error. This field is omitted from the response when `success` is `true`.
`errorDescription`	string	Detailed description of the error that occurred. This field is omitted from the response when `success` is `true`.

Example

The following example resumes a paused synchronization operation.

Request

curl localhost:27182/api/v1/resume -XPOST --data '{ }'

Response

{"success":true}

Behavior

When you send a resume request, mongosync might take at least two minutes before resuming the migration. To see if the migration resumed, you can call the progress endpoint.
If the resume request is successful, mongosync enters the RUNNING state.

Endpoint Protection

mongosync does not protect the resume endpoint. However, by default the API binds to localhost only and does not accept calls from other sources. Additionally, the resume call does not expose connection credentials or user data.

Back

pause

commit