API-initiated eviction [glossary]deterministic

API-initiated eviction is the process by which you use the Eviction API to create an Eviction object that triggers graceful pod termination.

operationapisecurity

API-initiated eviction is the process by which you use the [Eviction API](/docs/reference/generated/kubernetes-api//#create-eviction-pod-v1-core) to create an `Eviction` object that triggers graceful pod termination.

You can request eviction either by directly calling the Eviction API using a client of the kube-apiserver, like the `kubectl drain` command. When an `Eviction` object is created, the API server terminates the Pod.

API-initiated evictions respect your configured [`PodDisruptionBudgets`](/docs/tasks/run-application/configure-pdb/) and [`terminationGracePeriodSeconds`](/docs/concepts/workloads/pods/pod-lifecycle#pod-termination).

API-initiated eviction is not the same as [node-pressure eviction](/docs/concepts/scheduling-eviction/node-pressure-eviction/).

* See [API-initiated eviction](/docs/concepts/scheduling-eviction/api-eviction/) for more information.

Sources

reference/glossary/api-eviction.md · doc — “API-initiated eviction is the process by which you use the Eviction API to create an Eviction object that triggers graceful pod termination.”

Related (8)

references Handling retriable and non-retriable pod failures with Pod failure policy — API-initiated eviction conf=1

defines API-initiated Eviction conf=1

references Pod Conditions — eviction using the Kubernetes API conf=1

references Disruptions — eviction using the Kubernetes API conf=1

references Jobs — API-initiated eviction conf=1

prerequisite_of Label — ai-suggested prerequisite conf=0.7

prerequisite_of Probe — ai-suggested prerequisite conf=0.7

prerequisite_of LimitRange — ai-suggested prerequisite conf=0.7

← all Docs