Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Yugabyte cluster-info API

APIs for getting information about an existing cluster

Yugabyte cluster-info API is one of 10 APIs that Yugabyte publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include cluster-info. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 15 operations across 15 paths, and defines 45 schemas. It is described by OpenAPI 3.0.0, at version v1.

Requests are made against a single base URL, {protocol}://{host_port}/api.

15 operations 15 paths 45 schemas 15 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
v1
Base URL
https://cloud.yugabyte.com/api/public/v1
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Yugabyte cluster-info API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuthToken). By default, every request must be authenticated.

Paths & Operations 15

Across 15 paths, the API surfaces 15 operations — 15 GET. Each is listed below with its method, path, parameters, and response codes.

cluster-info 15

APIs for getting information about an existing cluster

GET
/live_queries
Get the live queries in a cluster
getLiveQueries 1 param → 200400500
GET
/slow_queries
Get the slow queries in a cluster
getSlowQueries → 200400500
GET
/nodes
Get the nodes for a cluster
getClusterNodes 1 param → 200400500
GET
/metrics
Get a metric for a cluster
getClusterMetric 7 params → 200400500
GET
/activities
Get a activities data for a cluster
getClusterActivities 3 params → 200400500
GET
/tables
Get list of DB tables per YB API (YCQL/YSQL)
getClusterTables 1 param → 200400500
GET
/table
Get info on a single table, given table uuid
getTableInfo 2 params → 200400500
GET
/health-check
Get health information about the cluster
getClusterHealthCheck → 200400500
GET
/tablets
Get list of tablets
getClusterTablets → 200400500
GET
/version
Get YugabyteDB version
getVersion → 200400500
GET
/is_load_balancer_idle
Check if cluster load balancer is idle
getIsLoadBalancerIdle → 200400500
GET
/gflags
Get gflags of master and tserver process
getGflags 1 param → 200400500
GET
/alerts
Get any alerts for the cluster
getClusterAlerts 1 param → 200400500
GET
/connections
Get YSQL connection manager stats for every node of the cluster
getClusterConnections → 200400500
GET
/node_address
Get the node address for the current node
getNodeAddress → 200400500

Schemas 45

The contract defines 45 schemas that model the data the API accepts and returns. The most detailed are NodeData_metrics (16 properties), SlowQueryResponseYSQLQueryItem (13 properties), NodeData (12 properties), LiveQueryResponseYSQLQueryItem (10 properties). Each schema is shown below with its type and property counts.

ColumnInfo
object
Column Info
3 properties
TableInfo
object
Table Info
10 properties 9 required
Gflag
object
Gflag
3 properties
Alerts_Response
object
1 property 1 required
SlowQueryResponseYSQLQueryItem
object
Schema for Slow Query Response YSQL Query Item
13 properties
ClusterTablet
object
Model representing a tablet
5 properties 5 required
SlowQueryResponseYSQLData
object
Schema for Slow Query Response YSQL Data
2 properties
Is_load_balancer_idle
object
Is load balancer idle
1 property 1 required
PlacementCloudInfo
object
Placement Cloud Info
3 properties
ConnectionStatsItem
object
10 properties 8 required
NodeData_cloud_info
object
3 properties 2 required
Metric_Response
object
3 properties 3 required
PlacementBlock
object
Placement Block
2 properties
NodeData_metrics_active_connections
object
2 properties 2 required
YbApiEnum
string
Type of DB API (YSQL/YCQL)
TabletInfo
object
Tablet Info
7 properties
SlowQueryResponseData
object
Slow Query Response Data
1 property
Cluster_table_list_response
object
2 properties 2 required
HealthCheckInfo
object
4 properties 4 required
ApiError_error
object
2 properties
LiveQueryResponseSchema
object
Live Query Response Schema
1 property
SlowQueryResponseSchema
object
Slow Query Response Schema
1 property
VersionInfo
object
YugabyteDB version info
1 property
Cluster_Nodes_Response
object
1 property 1 required
TableInfo_table_replication_info
object
2 properties
ClusterTable
object
Model representing a DB table
5 properties 5 required
LiveQueryResponseYSQLData
object
Schema for Live Query Response YSQL Data
2 properties
ConnectionsStats
object
YSQL connection manager stats
1 property
NodeData_metrics
object
16 properties 16 required
ConnectionStats
array
Activities_Response
object
1 property 1 required
TableReplicationInfo
object
TableReplicationInfo
3 properties
Cluster_tablet_list_response
object
1 property 1 required
AlertsInfo
object
Alerts Info
2 properties 2 required
GflagsInfo
object
Gflags Info
2 properties 2 required
Health_Check_Response
object
1 property
ApiError
object
1 property
LiveQueryResponseYCQLData
object
Schema for Live Query Response YCQL Data
2 properties
MetricData
object
Metric data
2 properties 2 required
LiveQueryResponseYCQLQueryItem
object
Schema for Live Query Response YCQL Query Item
8 properties
ActivityData
object
Activity Data
2 properties 2 required
LiveQueryResponseYSQLQueryItem
object
Schema for Live Query Response YSQL Query Item
10 properties
RaftConfig
object
Raft Config
3 properties
NodeData
object
Node data
12 properties 11 required
LiveQueryResponseData
object
Live Query Response Data
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yugabyte-cluster-info-api-openapi.yml Raw ↑

Other APIs Yugabyte publishes across the network.

YugabyteDB Aeon REST API
Yugabyte backup-info API
Yugabyte cluster API
Yugabyte pitr-info API
Yugabyte restore-info API
Yugabyte voyager-info API
Yugabyte voyager-metrics API
Yugabyte Xcluster Metrics API
Yugabyte Xcluster Namespace Details API