Endpoint

/v1/portal/ping

POST

Returns a connectivity report for each node to each provided remote host.

Parameters

This resource has no parameters.

Request

Schema

{
  "description": "v1_portal_ping_request",
  "type": "object",
  "properties": {
    "hosts": {
      "type": "array",
      "items": {
        "description": "IP addresses and TCP ports of nodes in the remote cluster",
        "type": "object",
        "properties": {
          "address": {
            "description": "address",
            "type": "string"
          },
          "port": {
            "description": "port",
            "type": "number"
          }
        }
      }
    },
    "peer_uuid": {
      "description": "Optional UUID of the peer cluster for verification",
      "type": "string"
    }
  }
}

Response

Codes

Code Description
200 Return value on success

Schema

{
  "description": "v1_portal_ping_result",
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "description": "results",
        "type": "object",
        "properties": {
          "node": {
            "description": "Node that attempted the connection",
            "type": "number"
          },
          "host": {
            "description": "Remote host that was tested",
            "type": "object",
            "properties": {
              "address": {
                "description": "address",
                "type": "string"
              },
              "port": {
                "description": "port",
                "type": "number"
              }
            }
          },
          "unreachable_reason": {
            "description": "Error message if connection failed, empty if successful",
            "type": "string"
          }
        }
      }
    }
  }
}