Start peers

Starts the specified peer.

You can also use the Start peer REST call to start more than one peer. After the request for starting multiple peers is sent, the response is returned as success or failure. Peers will start in the background.

Note

After you add a peer, you must install it before performing any actions on the peer.

This topic includes the following sections:

Request for starting a single peer

HTTP method: PUT

Request URL: https://<hostname>:<port>/baocdp/rest/peer/<peer_name>/start
In this URL, <peer_name> represents the name of the peer to start.

Header: See HTTP-request-and-response-headers for header information, such as required authentication token.

Request for starting multiple peers

HTTP method: POST

Request URL: To start multiple peers: https://<hostname>:<port>/baocdp/rest/peer/start
Peers are specified in the request body and not in the URL.

Header: See HTTP-request-and-response-headers for header information, such as required authentication token.

Request body properties for starting a single peer

This call does not require a request body.

Request body properties for starting multiple peers

Property	Type	Required	Description	Values	Default value
peers	array string	Yes	Top level for starting multiple peers	NA	NA
name	string	Yes	name of the peer to be started	User-provided value	NA

Example request JSON for starting multiple peers

{
  "peers": [
     {
       "name": "LAP"
     },
     {
       "name": "AP1"
     },
{
   "name": "AP2"
}
   ]
}

Response

If successful, this method starts the specified peer.

Response body properties

Property	Description
response	Status of the request

Example response JSON

{
"response": "Success"
}

Status codes and messages

For more details about HTTP response codes, see HTTP response codes.

HTTP code	Message	Description
202	Accepted	Request succeeded
204		Request succeeded
400		Bad request An error occurred while enabling the adapter.
401		Unauthorized
403		Forbidden
404	Not Found	Peer not found
500		Internal Server Error