Linode Kubernetes Engine (LKE)
Node Pool View
https://api.linode.com/v4/lke/clusters/{clusterId}/pools/{poolId}
Get a specific Node Pool by ID.
Path Parameters
ID of the Kubernetes cluster to look up.
ID of the Pool to look up
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/lke/clusters/12345/pools/456
Response Samples
- 200
{
"id": 1234,
"type": "g6-standard-4",
"tags": [],
"disks": [
{
"size": 1024,
"type": "ext-4"
}
],
"autoscaler": {
"enabled": true,
"max": 12,
"min": 3
},
"count": 6,
"nodes": [
{
"id": "123456",
"instance_id": 123458,
"status": "ready"
}
]
}
Responses
200: Returns the requested Node Pool.
This Node Pool's unique ID.
The Linode Type for all of the nodes in the Node Pool.
An array of tags applied to this object. Tags are for organizational purposes only.
This Node Pool's custom disk layout.
The size of this custom disk partition in MB.
- The size of this disk partition must not exceed the capacity of the node's plan type.
This custom disk partition's filesystem type.
When enabled, the number of nodes autoscales within the defined minimum and maximum values.
Whether autoscaling is enabled for this Node Pool. Defaults to false
.
The maximum number of nodes to autoscale to. Defaults to the Node Pool's count
.
The minimum number of nodes to autoscale to. Defaults to the Node Pool's count
.
The number of nodes in the Node Pool.
Status information for the Nodes which are members of this Node Pool. If a Linode has not been provisioned for a given Node slot, the instance_id will be returned as null.
The Node's ID.
The Linode's ID. When no Linode is currently provisioned for this Node, this will be null.
The Node's status as it pertains to being a Kubernetes node.
Node Pool Update
https://api.linode.com/v4/lke/clusters/{clusterId}/pools/{poolId}
Updates a Node Pool's count and autoscaler configuration.
Linodes will be created or deleted to match changes to the Node Pool's count.
Any local storage on deleted Linodes (such as "hostPath" and "emptyDir" volumes, or "local" PersistentVolumes) will be erased.
Path Parameters
ID of the Kubernetes cluster to look up.
ID of the Pool to look up
Request Body Schema
When enabled, the number of nodes autoscales within the defined minimum and maximum values.
When making a request, max
and min
require each other.
Whether autoscaling is enabled for this Node Pool. Defaults to false
.
The maximum number of nodes to autoscale to. Defaults to the Node Pool's count
. Defaults to the value provided by the count
field.
The minimum number of nodes to autoscale to. Defaults to the Node Pool's count
.
The number of nodes in the Node Pool.
Request Samples
- Shell
- CLI
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X PUT -d '{
"count": 6,
"autoscaler": {
"enabled": true,
"max": 12,
"min": 3
}' \
https://api.linode.com/v4/lke/clusters/12345/pools/456
Response Samples
- 200
{
"id": 1234,
"type": "g6-standard-4",
"tags": [],
"autoscaler": {
"enabled": true,
"max": 12,
"min": 3
},
"count": 6,
"disks": [
{
"size": 1024,
"type": "ext-4"
}
],
"nodes": [
{
"id": "123456",
"instance_id": 123458,
"status": "ready"
}
]
}
Responses
200: Node Pool was successfully modified.
The number of nodes in the Node Pool.
When enabled, the number of nodes autoscales within the defined minimum and maximum values.
When making a request, max
and min
require each other.
Whether autoscaling is enabled for this Node Pool. Defaults to false
.
The maximum number of nodes to autoscale to. Defaults to the Node Pool's count
. Defaults to the value provided by the count
field.
The minimum number of nodes to autoscale to. Defaults to the Node Pool's count
.
Node Pool Delete
https://api.linode.com/v4/lke/clusters/{clusterId}/pools/{poolId}
Delete a specific Node Pool from a Kubernetes cluster.
Deleting a Node Pool is a destructive action and cannot be undone.
Deleting a Node Pool will delete all Linodes within that Pool.
Path Parameters
ID of the Kubernetes cluster to look up.
ID of the Pool to look up
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
-X DELETE \
https://api.linode.com/v4/lke/clusters/12345/pools/456
Response Samples
- 200
- default
{}
Responses
200: Delete successful
default: Error
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.
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.