v8

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

Retrieve a Node Pool for a Kubernetes Cluster

To show information about a specific node pool in a Kubernetes cluster, send a GET request to /v2/kubernetes/clusters/$K8S_CLUSTER_ID/node_pools/$NODE_POOL_ID.

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

Path parameters

cluster_idstring uuid required

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

node_pool_idstring uuid required

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

Response

The response will be a JSON object with a key called node_pool. The value of this will be an object containing the standard attributes of a node pool.

Example response

{
  "node_pool": {
    "id": "cdda885e-7663-40c8-bc74-3a036c66545d",
    "name": "frontend-pool",
    "size": "s-1vcpu-2gb",
    "count": 3,
    "tags": [
      "production",
      "web-team",
      "k8s",
      "k8s:bd5f5959-5e1e-4205-a714-a914373942af",
      "k8s:worker"
    ],
    "labels": {
      "service": "backend",
      "priority": "high"
    },
    "taints": [
      {
        "key": "priority",
        "value": "high",
        "effect": "NoSchedule"
      }
    ],
    "auto_scale": false,
    "min_nodes": 0,
    "max_nodes": 0,
    "nodes": [
      {
        "id": "478247f8-b1bb-4f7a-8db9-2a5f8d4b8f8f",
        "name": "adoring-newton-3niq",
        "status": {
          "state": "running"
        },
        "droplet_id": "205545370",
        "created_at": "2018-11-15T16:00:11Z",
        "updated_at": "2018-11-15T16:00:11Z"
      },
      {
        "id": "ad12e744-c2a9-473d-8aa9-be5680500eb1",
        "name": "adoring-newton-3nim",
        "status": {
          "state": "running"
        },
        "droplet_id": "205545371",
        "created_at": "2018-11-15T16:00:11Z",
        "updated_at": "2018-11-15T16:00:11Z"
      },
      {
        "id": "e46e8d07-f58f-4ff1-9737-97246364400e",
        "name": "adoring-newton-3ni7",
        "status": {
          "state": "running"
        },
        "droplet_id": "205545372",
        "created_at": "2018-11-15T16:00:11Z",
        "updated_at": "2018-11-15T16:00:11Z"
      }
    ]
  }
}