Clusters

Get cluster nodes

Retrieves detailed information about the nodes of a specified Kubernetes cluster. Each node entry includes its ID, role (worker or master), flavor, and current status.

get/core/clusters/{cluster_id}/nodes

Request

  • Base URL: https://infrahub-api.nexgencloud.com/v1
  • URL: https://infrahub-api.nexgencloud.com/v1/core/clusters/{cluster_id}/nodes
  • Auth: API key in header api_key

Path parameters

cluster_idinteger required

ID of the cluster.

Response

Success

statusboolean

Whether the request succeeded.

messagestring

Human-readable description of the result.

Example response

{
  "status": true,
  "message": "Cluster nodes retrieved successfully",
  "nodes": [
    {
      "id": 3287,
      "role": "bastion",
      "instance": {
        "id": 7613,
        "name": "example-c1-bastion-0",
        "status": "CREATING",
        "fixed_ip": "192.0.2.42",
        "floating_ip": "192.0.2.91",
        "floating_ip_status": "ATTACHING",
        "image_id": 7613
      },
      "status": "CREATING",
      "status_reason": "VM is creating",
      "is_bastion": true,
      "requires_public_ip": true,
      "created_at": "2026-05-06T16:04:09Z",
      "updated_at": "2026-05-06T16:04:09Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.