For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

client.kubernetes.delete_node(
    cluster_id="bd5f5959-5e1e-4205-a714-a914373942af",
    node_pool_id="cdda885e-7663-40c8-bc74-3a036c66545d",
    node_id="478247f8-b1bb-4f7a-8db9-2a5f8d4b8f8f",
    skip_drain=0,
    replace=0,
)

Description

To delete a single node in a pool, send a DELETE request to /v2/kubernetes/clusters/{cluster_id}/node_pools/{node_pool_id}/nodes/{node_id}.

Appending the skip_drain=1 query parameter to the request causes node draining to be skipped. Omitting the query parameter or setting its value to 0 carries out draining prior to deletion.

Appending the replace=1 query parameter to the request causes the node to be replaced by a new one after deletion. Omitting the query parameter or setting its value to 0 deletes without replacement.

Parameters

cluster_id string required

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

Min: 1

node_pool_id string required

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

Min: 1

node_id string required

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

Min: 1

skip_drain integer optional

Specifies whether or not to drain workloads from a node before it is deleted. Setting it to 1 causes node draining to be skipped. Omitting the query parameter or setting its value to 0 carries out draining prior to deletion.

Min: 0

Max: 1

Default: 0

replace integer optional

Specifies whether or not to replace a node after it has been deleted. Setting it to 1 causes the node to be replaced by a new one after deletion. Omitting the query parameter or setting its value to 0 deletes without replacement.

Min: 0

Max: 1

Default: 0

Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

resp = client.kubernetes.delete_node(cluster_id="da8fda8", node_pool_id="a8f3da", node_id="fa09daf")

More Information

See /v2/kubernetes/clusters/{cluster_id}/node_pools/{node_pool_id}/nodes/{node_id} in the API reference for additional detail on responses, headers, parameters, and more.