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

YugabyteDB Node instances API

The Node instances API from YugabyteDB — 10 operation(s) for node instances.

YugabyteDB Node instances API is one of 73 APIs that YugabyteDB publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Node instances. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

This API exposes 11 operations across 10 paths, and defines 19 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against a single base URL, https://cloud.yugabyte.com/api/public/v1.

11 operations 10 paths 19 schemas 1 DELETE5 GET3 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.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

YugabyteDB Node instances API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — API key obtained from the YugabyteDB Aeon UI under User Profile API Keys. Pass the key as a Bearer token in the Authorization header.

Paths & Operations 11

Across 10 paths, the API surfaces 11 operations — 1 DELETE, 5 GET, 3 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Node instances 11
GET
/api/v1/customers/{cUUID}/nodes
YugabyteDB Anywhere List All Node Instances of a Customer
List 2 params → 200
GET
/api/v1/customers/{cUUID}/nodes/{nodeUUID}/list
YugabyteDB Anywhere Get a Node Instance
getNodeInstance 2 params → 200
DELETE
/api/v1/customers/{cUUID}/providers/{pUUID}/instances/{instanceIP}
YugabyteDB Anywhere Delete a Node Instance
deleteInstance 4 params → 200
POST
/api/v1/customers/{cUUID}/providers/{pUUID}/instances/{instanceIP}
YugabyteDB Anywhere Detached Node Action
detachedNodeAction 4 params body → 200
PUT
/api/v1/customers/{cUUID}/providers/{pUUID}/instances/{instanceIP}/state
YugabyteDB Anywhere Update Node Instance State
updateState 4 params body → 200
GET
/api/v1/customers/{cUUID}/providers/{pUUID}/nodes/list
YugabyteDB Anywhere List All of a Provider's Node Instances
listByProvider 2 params → 200
PUT
/api/v1/customers/{cUUID}/universes/{universeUUID}/nodes/{nodeName}
YugabyteDB Anywhere Perform the Specified Action on the Universe Node
nodeAction 4 params body → 200
GET
/api/v1/customers/{cUUID}/universes/{universeUUID}/nodes/{nodeName}/details
YugabyteDB Anywhere Get Node Details
getNodeDetails 3 params → 200
POST
/api/v1/customers/{cUUID}/zones/{azUUID}/nodes
YugabyteDB Anywhere Create a Node Instance
createNodeInstance 3 params body → 200
GET
/api/v1/customers/{cUUID}/zones/{azUUID}/nodes/list
YugabyteDB Anywhere List All of a Zone's Node Instances
listByZone 2 params → 200
POST
/api/v1/customers/{cUUID}/zones/{azUUID}/nodes/validate
YugabyteDB Anywhere Validate a Node Instance
validateNodeInstance 3 params → 200

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are NodeDetailsResp_2 (39 properties), NodeDetailsResp (39 properties), CloudSpecificInfo_2 (18 properties), CloudSpecificInfo (18 properties). Each schema is shown below with its type and property counts.

NodeInstanceFormData
object
1 property 1 required
ValidationResult
object
Validation result of a node config
5 properties 5 required
NodeInstanceData
object
Details of a node instance. Used by the API to validate data against input constraints.
7 properties 5 required
NodeActionFormData
object
3 properties 1 required
CloudSpecificInfo
object
Node information reported by the cloud provider
18 properties
NodeDetailsResp
object
39 properties 1 required
YBPSuccess
object
2 properties
NodeInstanceStateFormData
object
1 property
NodeInstance
object
A single node instance, attached to a provider and availability zone
10 properties 1 required
YBPTask
object
2 properties
NodeInstanceFormData_2
object
1 property 1 required
ValidationResult_2
object
Validation result of a node config
5 properties 5 required
NodeActionFormData_2
object
3 properties 1 required
CloudSpecificInfo_2
object
Node information reported by the cloud provider
18 properties
NodeDetailsResp_2
object
39 properties 1 required
YBPSuccess_2
object
2 properties
NodeInstanceStateFormData_2
object
1 property
NodeInstance_2
object
A single node instance, attached to a provider and availability zone
10 properties 1 required
YBPTask_2
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yugabytedb-node-instances-api-openapi.yml Raw ↑

Other APIs YugabyteDB publishes across the network.

YugabyteDB Access Keys API
YugabyteDB Accounts API
YugabyteDB Alerts API
YugabyteDB AllowLists API
YugabyteDB Asynchronous Replication API
YugabyteDB Audit API
YugabyteDB Authentication API
YugabyteDB Availability Zones API
YugabyteDB Backup and Restore API
YugabyteDB Backups API
YugabyteDB Certificate Info API
YugabyteDB Cloud providers API