EKS Node Group

An EKS Node Group is a managed group of Amazon EC2 instances that run as worker nodes in an Amazon Elastic Kubernetes Service (EKS) cluster. It automates the provisioning and lifecycle management of nodes, including scaling, updates, and replacement. This allows you to run Kubernetes workloads on EC2 with less operational overhead while maintaining flexibility in instance types and configurations.

aws.eks_nodegroup

Fields

TitleIDTypeData TypeDescription
_keycorestring
account_idcorestring
ami_typecorestringIf the node group was deployed using a launch template with a custom AMI, then this is CUSTOM. For node groups that weren't deployed using a launch template, this is the AMI type that was specified in the node group configuration.
capacity_typecorestringThe capacity type of your managed node group.
cluster_namecorestringThe name of your cluster.
created_atcoretimestampThe Unix epoch timestamp at object creation.
disk_sizecoreint64If the node group wasn't deployed with a launch template, then this is the disk size in the node group configuration. If the node group was deployed with a launch template, then this is null.
healthcorejsonThe health status of the node group. If there are issues with your node group's health, they are listed here.
instance_typescorearray<string>If the node group wasn't deployed with a launch template, then this is the instance type that is associated with the node group. If the node group was deployed with a launch template, then this is null.
labelscorehstoreThe Kubernetes labels applied to the nodes in the node group. Only labels that are applied with the Amazon EKS API are shown here. There may be other Kubernetes labels applied to the nodes in this group.
launch_templatecorejsonIf a launch template was used to create the node group, then this is the launch template that was used.
modified_atcoretimestampThe Unix epoch timestamp for the last modification to the object.
node_repair_configcorejsonThe node auto repair configuration for the node group.
node_rolecorestringThe IAM role associated with your node group. The Amazon EKS node kubelet daemon makes calls to Amazon Web Services APIs on your behalf. Nodes receive permissions for these API calls through an IAM instance profile and associated policies.
nodegroup_arncorestringThe Amazon Resource Name (ARN) associated with the managed node group.
nodegroup_namecorestringThe name associated with an Amazon EKS managed node group.
release_versioncorestringIf the node group was deployed using a launch template with a custom AMI, then this is the AMI ID that was specified in the launch template. For node groups that weren't deployed using a launch template, this is the version of the Amazon EKS optimized AMI that the node group was deployed with.
remote_accesscorejsonIf the node group wasn't deployed with a launch template, then this is the remote access configuration that is associated with the node group. If the node group was deployed with a launch template, then this is null.
resourcescorejsonThe resources associated with the node group, such as Auto Scaling groups and security groups for remote access.
scaling_configcorejsonThe scaling configuration details for the Auto Scaling group that is associated with your node group.
statuscorestringThe current status of the managed node group.
subnetscorearray<string>The subnets that were specified for the Auto Scaling group that is associated with your node group.
tagscorehstore
taintscorejsonThe Kubernetes taints to be applied to the nodes in the node group when they are created. Effect is one of No_Schedule, Prefer_No_Schedule, or No_Execute. Kubernetes taints can be used together with tolerations to control how workloads are scheduled to your nodes. For more information, see Node taints on managed node groups.
update_configcorejsonThe node group update configuration.
versioncorestringThe Kubernetes version of the managed node group.