aws Verified current stable Not installed? Kubernetes

Aws / Describe Eks Nodegroup

Describe Eks Nodegroup

Describe a specific node group within an EKS cluster.

$
Terminal
aws eks describe-nodegroup --cluster-name <cluster_name> --nodegroup-name <nodegroup_name>

When To Use

When debugging issues related to node configurations or deployments within a cluster.

Pro Tip

Use `--include-extended` to fetch detailed configuration data beyond the standard output.

Command Builder

Tune the command before you copy it

Back to syntax
$
Generated Command
aws eks describe-nodegroup --cluster-name <cluster_name> --nodegroup-name <nodegroup_name>

Terminal Output

Expected runtime feedback

Simulated preview
>
Output
{\n  "nodegroup": {\n    "nodegroupName": "example-nodegroup",\n    "clusterName": "example-cluster",\n    "status": "ACTIVE",\n    "scalingConfig": {\n      "minSize": 2,\n      "maxSize": 5,\n      "desiredSize": 3\n    },\n    "resources": {\n      "autoScalingGroups": [\n        {\n          "name": "example-asg"\n        }\n      ]\n    }\n  }\n}

Anatomy of Output

Understanding the result

NodeGroupName: my-node-group Node Group Name

The name of the described node group.

Status: ACTIVE Node Group Status

Indicates operational state of the node group.

ScalingConfig: 2 desired, 1 running, 0 pending Scaling Information

Shows current scaling states of the node group.

Power User Variants

Optimized versions

aws eks describe-nodegroup --cluster-name my-cluster --nodegroup-name my-node-group --include-extended

Request extended details about the node group.

aws eks describe-nodegroup --cluster-name my-cluster --nodegroup-name my-node-group --output json

Output details in JSON format for automation scripts.

Troubleshooting

Common pitfalls

An error occurred (ClusterNotFound) when calling the DescribeNodegroup operation: Cluster 'my-cluster' not found

Solution: Confirm cluster is created and accessible in the region.

An error occurred (NodegroupNotFound) when calling the DescribeNodegroup operation: Nodegroup 'my-node-group' not found

Solution: Check that the node group name is correct and exists in the specified cluster.

An error occurred (UnauthorizedOperation) when calling the DescribeNodegroup operation: You are not authorized to perform this operation

Solution: Review IAM permissions for the user attempting to retrieve the node group description.

Command Breakdown

What each part is doing

aws
Base Command
The executable that performs this operation. Here it runs Aws before the shell applies any redirect operators.
<cluster_name>
cluster name
The value supplied for cluster name.
<nodegroup_name>
nodegroup name
The value supplied for nodegroup name.
--cluster-name
Command Option
Tool-specific option used by this command invocation.
--nodegroup-name
Command Option
Tool-specific option used by this command invocation.

How To Run

Execution path

  1. Step 1

    Run the command: aws eks describe-nodegroup --cluster-name my-cluster --nodegroup-name my-nodegroup

  2. Step 2

    Verify the output for the expected nodegroup details, especially status and scalingConfig.

Alternative Approaches

Comparable commands in other tools

Alternative kubernetes tools for the same job.