nodes
Creates, updates, deletes, gets or lists a nodes resource.
Overview​
| Name | nodes |
| Type | Resource |
| Id | linode.lke.nodes |
Fields​
The following fields are returned by SELECT queries:
- get
Returns the values of a node object in the form that it appears currently in the node pool array.
| Name | Datatype | Description |
|---|---|---|
id | string | The Node's ID. (example: 12345-6aa78910bc) |
instance_id | integer | The Linode's ID. When no Linode is currently provisioned for this Node, this will be null. |
status | string | The creation status of this Node. This status is distinct from this Node's readiness as a Kubernetes Node Object as determined by the command kubectl get nodes. not_ready indicates that the Linode is still being created. ready indicates that the Linode has successfully been created and is running Kubernetes software. (ready, not_ready) (example: ready) |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | clusterId, nodeId | Returns the values for a specified node object. Learn more... Learn more... | |
delete | delete | clusterId, nodeId | Deletes a specific Node from a Node Pool. Deleting a Node is a destructive action and cannot be undone. Deleting a Node will reduce the size of the Node Pool it belongs to. Learn more... Learn more... | |
recycle | exec | clusterId, nodeId | 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.Learn more... Learn more... |
Parameters​
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
clusterId | string | ID of the Kubernetes cluster containing the Node. (example: {{clusterId}}) |
nodeId | string | ID of the Node to be recycled. (example: {{nodeId}}) |
SELECT examples​
- get
Returns the values for a specified node object.
Learn more...
Learn more...
SELECT
id,
instance_id,
status
FROM linode.lke.nodes
WHERE clusterId = '{{ clusterId }}' -- required
AND nodeId = '{{ nodeId }}' -- required
;
DELETE examples​
- delete
Deletes a specific Node from a Node Pool.
Deleting a Node is a destructive action and cannot be undone.
Deleting a Node will reduce the size of the Node Pool it belongs to.
Learn more...
Learn more...
DELETE FROM linode.lke.nodes
WHERE clusterId = '{{ clusterId }}' --required
AND nodeId = '{{ nodeId }}' --required
;
Lifecycle Methods​
- 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.
Learn more...
Learn more...
EXEC linode.lke.nodes.recycle
@clusterId='{{ clusterId }}' --required,
@nodeId='{{ nodeId }}' --required
;