Clusters

List node groups for a cluster

Retrieves a list of all node groups associated with a specified cluster in Hyperstack. Each node group represents a collection of nodes within the cluster with a shared configuration (e.g., instance flavor, role, and count).

get/core/clusters/{cluster_id}/node-groups

Request

  • Base URL: https://infrahub-api.nexgencloud.com/v1
  • URL: https://infrahub-api.nexgencloud.com/v1/core/clusters/{cluster_id}/node-groups
  • 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": "Node groups retrieved successfully",
  "node_groups": [
    {
      "id": 4501,
      "name": "default",
      "role": "worker",
      "flavor": {
        "id": 4501,
        "name": "n1-cpu-small",
        "cpu": 4,
        "ram": 4,
        "disk": 100
      },
      "count": 1,
      "min_count": 1,
      "max_count": 1,
      "created_at": "2026-05-07T09:21:55Z",
      "updated_at": "2026-05-07T09:21:55Z"
    }
  ]
}

Changes

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