Skip to main content

Manage Node Pools

Node pools allow you to manage groups of worker nodes within a Kubernetes cluster. This guide provides an overview of how to list, create, get, and delete node pools.

List Node Pools​

To list all node pools via the API, send a GET request to the /kubernetes/clusters/{cluster_id}/node-pools endpoint:

GET /kubernetes/clusters/<cluster-id>/node-pools HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>

Create Node Pool​

To create a node pool via the API, send a POST request to the /kubernetes/clusters/{cluster_id}/node-pools endpoint:

POST /kubernetes/clusters/<cluster-id>/node-pools HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>
Content-Type: application/json

{
  "name": "<pool-name>",
  "type": "<instance-type>",
  "count": <count>
}

Get Node Pool Details​

To get details for a specific node pool via the API, send a GET request to the /kubernetes/clusters/{cluster_id}/node-pools/{node_pool_id} endpoint:

GET /kubernetes/clusters/<cluster-id>/node-pools/<node-pool-id> HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>

Delete Node Pool​

To delete a node pool via the API, send a DELETE request to the /kubernetes/clusters/{cluster_id}/node-pools/{node_pool_id} endpoint:

DELETE /kubernetes/clusters/<cluster-id>/node-pools/<node-pool-id> HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>