Get Peer Info


Retrieves the list of peers in your environment and additional information such as the peer name, status, operating system, and the host name.

This topic includes the following sections:

Request

HTTP method: GET

Request URLhttps://<hostname>:<port>/baocdp/rest/info/peer

Note

Currently, you can only retrieve peer information for peers hosted on the CDP and HA-CDP.

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

Request body properties

This call does not require a request body.

Response

If successful, this method returns the following details about the CDP(s) and HA-CDP(s) on the grid.

Property

Description

name

Peer name

description

Peer description

osName

Name of the operating system

productVersion

Displays the platform version

hostName

Name of the host on which the peer is running

Example response JSON

{
   "peerInfoList": [
      {
           "name": "CDP",
           "status": "RUNNING",
           "osName": "Windows Server 2016",
           "productVersion": "8.2.00",
           "hostName": "hostname",
           "type": "Configuration Distribution Peer"
       },
       {
           "name": "AP1",
           "status": "RUNNING",
           "osName": "Windows Server 2012 R2",
           "productVersion": "8.2.00",
           "hostName": "hostname",
           "type": "Activity Peer"
       },
       {
           "name": "AP2",
           "status": "RUNNING",
           "osName": "Red Hat Enterprise Linux Server release 6.10 (Santiago)",
           "productVersion": "8.2.00",
           "hostName": "hostname",
           "type": "Activity Peer"
       },
       {
           "name": "LAP2",
           "status": "RUNNING",
           "osName": "SUSE Linux Enterprise Server 11 (x86_64)",
           "productVersion": "8.2.00",
           "hostName": "hostname",
           "type": "Lightweight Activity Peer"
       },
       {
           "name": "AP3",
           "status": "STOPPED",
           "osName": "",
           "hostName": "",
           "type": "Activity Peer"
       },
       {
           "name": "LAP1",
           "status": "STOPPED",
           "osName": "",
           "hostName": "",
           "type": "Lightweight Activity Peer"
       }
    ]
}

Status codes and error messages

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

HTTP code

Message

Description

200

OK


401


Unauthorized

User is not authorized to access this API.

403


Forbidden

Unable to get grid ID.

404


Not found

When information is not retrieved from the database or unable to parse retrieved data.

500


Internal server error

Related topics

HTTP request and response headers

Format of API examples

Peer management API

Managing peers

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*