Skip to content

post_replication_source

Alberto Gonzalez edited this page Oct 29, 2015 · 1 revision

(POST)/replication/source

Description

This API, run on the target, is used to either accept or reject the pending replication request made by an incoming source.

The request resolution (accept/reject) is saved to a known location by the source, who is polling at a defined location on the target for the resolution. If the request has been accepted, the source's polling will then download the signed secure tunnel certificate request as well as the targets certificate and install it in the proper locations on the source. The replication configuration on the source will complete and replication of data will commence (once instances are set to replicate in a replication job).

If the request is accepted, the source system is added to or updated the systems table on the target and the role is set to "replicating source" if a managed source and "non-managed replication source" otherwise. If the target were already configured to manage the source, it would be in the systems table with a role of "managed system".

No other user interaction is required to configure replication.

Related APIs

POST /replication/target

GET /replication/pending

GET /replication/targets

GET /systems

Request

Syntax

POST /api/replication/source
Host: <server host name>
Accept: application/json
AuthToken: <authentication token returned from authenticate>

Parameters

Index Value Type Required
request_id id of the pending request that we are accepting or rejecting string required
accept the target is accepting (true) or rejecting (false) the request boolean required
message a message to send to the source, particularly useful when rejecting replication string if rejecting the request
storage_id id of storage on target to which source's backups should replicate long optional

Response

Parameters

Examples

Sample Request

POST /api/replication/source
Host: <server host name>
Accept: application/json
AuthToken: 8a00sjerhterqerjlqkjlk443l4j56869h4f_)(fjdkasHHHHHkdal324
{
      "request_id": 3,
      "accept": true

}

Sample Response

Successful creation of the target configuration, and in the background prepares the artifacts that for which the source is polling, to complete the replication configuration.

HTTP Status: 201 (Created)

Failed source configuration on the target will return HTTP Status 500 with a result object with an error message and KB link as defined here

Clone this wiki locally