Skip to main content

Clusters

Kubernetes clusters provisioned on Hyperstack GPU infrastructure. These endpoints let you create and manage clusters, add and remove nodes, organize nodes into groups, and monitor cluster events.

Core


POST

Create Cluster

Creates a Kubernetes cluster with the specified configuration, including cluster name, node type, Kubernetes version, and hardware settings.

GET

List Clusters

Returns a list of your current clusters with their ID, status, environment, and hardware configuration.

GET

Get cluster details

Retrieves detailed information about a Kubernetes cluster by ID, including its name, environment, configuration, and operational status.

DEL

Delete a cluster

Permanently deletes a Kubernetes cluster by ID.

POST

Reconcile a cluster

Triggers reconciliation for a cluster in an ERROR state, restoring the desired configuration.

GET

List cluster versions

Returns a list of supported Kubernetes versions available for cluster deployment.

GET

Get cluster master flavors

Retrieves the list of CPU-only flavors supported for use as the Kubernetes master node.

GET

Fetch cluster name availability

Checks whether a name is available for use as a cluster.

Nodes


POST

Create Node

Creates one or more nodes and adds them to an existing Kubernetes cluster.

GET

Get cluster nodes

Retrieves detailed information about the nodes of a specified cluster, including each node's role, flavor, and status.

DEL

Delete cluster node

Removes a single node from a Kubernetes cluster by cluster ID and node ID.

POST

Delete multiple cluster nodes

Deletes one or more nodes from a Kubernetes cluster in a single request.

Node Groups


POST

Create a node group in a cluster

Creates a node group with a specified number of worker nodes of a chosen flavor and adds it to an existing cluster.

GET

List node groups for a cluster

Retrieves all node groups associated with a specified cluster.

GET

Retrieve a node group in a cluster

Retrieves the full configuration and metadata of a specific node group within a cluster.

PATCH

Update a node group in a cluster

Updates the minimum and maximum worker node limits for a node group, and optionally applies firewall rules to all nodes in the group.

DEL

Delete a node group

Deletes a node group and all its worker nodes from a cluster.

Monitoring


GET

Fetch all of a cluster events

Retrieves a list of events for a specified Kubernetes cluster, including event type, ID, timestamp, and message.