Linode Kubernetes Engine (LKE)

Node Pool Recycle

post
https://api.linode.com/v4/lke/clusters/{clusterId}/pools/{poolId}/recycle

Recycles a Node Pool for the designated Kubernetes Cluster. All Linodes within the Node Pool will be deleted and replaced with new Linodes on a rolling basis, which may take several 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 this Node Pool is attached to.

poolId
Required
integer

ID of the Node Pool 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/pools/456/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.