v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Kubernetes

List All Node Pools in a Kubernetes Clusters

To list all of the node pools in a Kubernetes clusters, send a GET request to /v2/kubernetes/clusters/$K8S_CLUSTER_ID/node_pools.

get/v2/kubernetes/clusters/{cluster_id}/node_pools

Path parameters

cluster_idstring uuid required

A unique ID that can be used to reference a Kubernetes cluster.

Response

The response will be a JSON object with a key called node_pools. This will be set to an array of objects, each of which will contain the standard node pool attributes.

Example response

{
  "node_pools": [
    {
      "size": "s-1vcpu-2gb",
      "id": "cdda885e-7663-40c8-bc74-3a036c66545d",
      "name": "frontend-pool",
      "count": 3,
      "tags": [
        "k8s",
        "k8s:bd5f5959-5e1e-4205-a714-a914373942af",
        "k8s-worker",
        "production",
        "web-team"
      ],
      "taints": [
        {
          "key": "priority",
          "value": "high",
          "effect": "NoSchedule"
        }
      ],
      "auto_scale": true,
      "min_nodes": 3,
      "max_nodes": 6,
      "nodes": [
        {
          "id": "e78247f8-b1bb-4f7a-8db9-2a5f8d4b8f8f",
          "name": "adoring-newton-3niq",
          "status": {
            "state": "provisioning"
          },
          "droplet_id": "205545370",
          "created_at": "2018-11-15T16:00:11Z",
          "updated_at": "2018-11-15T16:00:11Z"
        }
      ]
    }
  ]
}