Linode Kubernetes Engine (LKE)

Node Recycle

post
https://api.linode.com/v4/lke/clusters/{clusterId}/nodes/{nodeId}/recycle

Recycles an individual Node in the designated Kubernetes Cluster. The Node will be deleted and replaced with a new Linode, which may take a few minutes. Replacement Nodes are installed with the latest available patch for the Cluster's Kubernetes Version.

Any local storage on deleted Linodes (such as "hostPath" and "emptyDir" volumes, or "local" PersistentVolumes) will be erased.

Path Parameters

clusterId
Required
integer

ID of the Kubernetes cluster containing the Node.

nodeId
Required
string

ID of the Node to be recycled.

Request Samples

curl -H "Content-Type: application/json" \
      -H "Authorization: Bearer $TOKEN" \
      -X POST \
      https://api.linode.com/v4/lke/clusters/12345/nodes/12345-6aa78910bc/recycle

Response Samples

{}

Responses

200: Recycle request succeeded and is in progress.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.