Change a node group
Scale a node group, change its server type, labels, taints or zones, and restart a group that stopped after failed nodes.
Last updated 18 November 2026View as Markdown
Replace my-cluster with your cluster's name or id, and workers with the node group's name.
Prerequisites
- Permission for
eks:UpdateNodegroupConfigon the node group. - In the console, also
eks:DescribeClusterandeks:ListNodegroups. The console enables Edit only witheks:UpdateNodegroupConfigon every cluster (eks:*).
Change the node group
- Open Kubernetes, open the cluster, then choose Node groups.
- On the node group's row, choose Edit.
- Change the Server type, Minimum, Desired and Maximum, Autoscaling, the labels and the taints as needed.
- Choose Save.
dcloud eks nodegroups update my-cluster workers --desired-size 3PATCH /eks/api/clusters/my-cluster/nodegroups/workers
{ "desiredSize": 3 }Change desired_size (or min_size, max_size, instance_type, labels, taints, zones) on
the dcloud_eks_nodegroup and apply.
What each change does
- Sizes are checked together with the ones you do not send:
minSize ≤ desiredSize ≤ maxSize. Only a largermaxSizeis checked against the quotas; shrinking is always allowed. - Scaling down removes nodes that are not Ready first, then nodes on an older minor, then the newest. A Ready node is drained first: PodDisruptionBudgets are respected for up to five minutes per node, then the node goes anyway. A node that is not Ready is removed without a drain.
- Server type applies to nodes created from then on; nodes already running keep theirs until they are replaced.
- Labels and taints replace the lists as a whole (
{}and[]remove them all), and apply to nodes created from then on. - Zones apply to nodes created from then on; nothing moves.
- A group in status
failed(stopped after three failed nodes) goesupdatingon any change and tries again.
Each change is recorded in Activity.
Refusals
400"Sizes must satisfy minSize ≤ desiredSize ≤ maxSize (would be …)", "Nothing to change", or a type or zone that cannot be used.404when the node group does not exist.409"The node group is being deleted", or a largermaxSizepasses a quota ("Quota exceeded: …").
Related
Did this page help you?