Skip to main content

nodegroup

Gets an individual nodegroup resource

Overview

Namenodegroup
TypeResource
Descriptionnodegroup
Idawscc.eks.nodegroup

Fields

NameDatatypeDescription
ami_typestringThe AMI type for your node group.
capacity_typestringThe capacity type of your managed node group.
cluster_namestringName of the cluster to create the node group in.
disk_sizeintegerThe root device disk size (in GiB) for your node group instances.
force_update_enabledbooleanForce the update if the existing node group's pods are unable to be drained due to a pod disruption budget issue.
instance_typesarraySpecify the instance types for a node group.
labelsobjectThe Kubernetes labels to be applied to the nodes in the node group when they are created.
launch_templateobjectAn object representing a node group's launch template specification.
nodegroup_namestringThe unique name to give your node group.
node_rolestringThe Amazon Resource Name (ARN) of the IAM role to associate with your node group.
release_versionstringThe AMI version of the Amazon EKS-optimized AMI to use with your node group.
remote_accessobjectThe remote access (SSH) configuration to use with your node group.
scaling_configobjectThe scaling configuration details for the Auto Scaling group that is created for your node group.
subnetsarrayThe subnets to use for the Auto Scaling group that is created for your node group.
tagsobjectThe metadata, as key-value pairs, to apply to the node group to assist with categorization and organization. Follows same schema as Labels for consistency.
taintsarrayThe Kubernetes taints to be applied to the nodes in the node group when they are created.
update_configobjectThe node group update configuration.
versionstringThe Kubernetes version to use for your managed nodes.
idstring
arnstring
regionstringAWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
ami_type,
capacity_type,
cluster_name,
disk_size,
force_update_enabled,
instance_types,
labels,
launch_template,
nodegroup_name,
node_role,
release_version,
remote_access,
scaling_config,
subnets,
tags,
taints,
update_config,
version,
id,
arn
FROM awscc.eks.nodegroup
WHERE data__Identifier = '<Id>';

Permissions

To operate on the nodegroup resource, the following permissions are required:

Read

eks:DescribeNodegroup

Delete

eks:DeleteNodegroup,
eks:DescribeNodegroup

Update

iam:GetRole,
iam:PassRole,
eks:DescribeNodegroup,
eks:DescribeUpdate,
eks:ListUpdates,
eks:TagResource,
eks:UntagResource,
eks:UpdateNodegroupConfig,
eks:UpdateNodegroupVersion