Sign in
kubernetes

Drain a Kubernetes node

Drain a Kubernetes node by safely evicting all pods from the node, preparing it for maintenance or removal Access policy: authenticated

post/kubernetes/{id}/nodes/{name}/drain

Path parameters

idinteger required

Environment(Endpoint) identifier

namestring required

Name of the node to drain

Request body

DeleteEmptyDirDataboolean

DeleteEmptyDirData allows eviction of pods using emptyDir volumes, whose data is lost once the pod is deleted.

DisableEvictionboolean

DisableEviction forces the use of direct pod deletion instead of the eviction API, ignoring any configured PodDisruptionBudgets.

Forceboolean

Force allows deletion of standalone pods not managed by a controller.

GracePeriodSecondsinteger

GracePeriodSeconds overrides each pod's termination grace period. -1 uses the pod's own grace period.

IgnoreDaemonSetsboolean

IgnoreDaemonSets skips DaemonSet-managed pods, which would otherwise block the drain.

TimeoutSecondsinteger

TimeoutSeconds is the overall time to wait for the drain to complete. Defaults to 60 when omitted.

Example request

{
  "DeleteEmptyDirData": true,
  "GracePeriodSeconds": -1,
  "IgnoreDaemonSets": true,
  "TimeoutSeconds": 60
}

Response

Success

Changes

Changed in 1 of the 21 revisions of this API.1