AWS Classic

Pulumi Official
Package maintained by Pulumi
v5.11.0 published on Wednesday, Aug 17, 2022 by Pulumi

getNodeGroup

Retrieve information about an EKS Node Group.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.Eks.GetNodeGroup.Invoke(new()
    {
        ClusterName = "example",
        NodeGroupName = "example",
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/eks"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := eks.LookupNodeGroup(ctx, &eks.LookupNodeGroupArgs{
			ClusterName:   "example",
			NodeGroupName: "example",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.eks.EksFunctions;
import com.pulumi.aws.eks.inputs.GetNodeGroupArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = EksFunctions.getNodeGroup(GetNodeGroupArgs.builder()
            .clusterName("example")
            .nodeGroupName("example")
            .build());

    }
}
import pulumi
import pulumi_aws as aws

example = aws.eks.get_node_group(cluster_name="example",
    node_group_name="example")
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = pulumi.output(aws.eks.getNodeGroup({
    clusterName: "example",
    nodeGroupName: "example",
}));
variables:
  example:
    Fn::Invoke:
      Function: aws:eks:getNodeGroup
      Arguments:
        clusterName: example
        nodeGroupName: example

Using getNodeGroup

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getNodeGroup(args: GetNodeGroupArgs, opts?: InvokeOptions): Promise<GetNodeGroupResult>
function getNodeGroupOutput(args: GetNodeGroupOutputArgs, opts?: InvokeOptions): Output<GetNodeGroupResult>
def get_node_group(cluster_name: Optional[str] = None,
                   node_group_name: Optional[str] = None,
                   tags: Optional[Mapping[str, str]] = None,
                   opts: Optional[InvokeOptions] = None) -> GetNodeGroupResult
def get_node_group_output(cluster_name: Optional[pulumi.Input[str]] = None,
                   node_group_name: Optional[pulumi.Input[str]] = None,
                   tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                   opts: Optional[InvokeOptions] = None) -> Output[GetNodeGroupResult]
func LookupNodeGroup(ctx *Context, args *LookupNodeGroupArgs, opts ...InvokeOption) (*LookupNodeGroupResult, error)
func LookupNodeGroupOutput(ctx *Context, args *LookupNodeGroupOutputArgs, opts ...InvokeOption) LookupNodeGroupResultOutput

> Note: This function is named LookupNodeGroup in the Go SDK.

public static class GetNodeGroup 
{
    public static Task<GetNodeGroupResult> InvokeAsync(GetNodeGroupArgs args, InvokeOptions? opts = null)
    public static Output<GetNodeGroupResult> Invoke(GetNodeGroupInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetNodeGroupResult> getNodeGroup(GetNodeGroupArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
Fn::Invoke:
  Function: aws:eks/getNodeGroup:getNodeGroup
  Arguments:
    # Arguments dictionary

The following arguments are supported:

ClusterName string

The name of the cluster.

NodeGroupName string

The name of the node group.

Tags Dictionary<string, string>

Key-value map of resource tags.

ClusterName string

The name of the cluster.

NodeGroupName string

The name of the node group.

Tags map[string]string

Key-value map of resource tags.

clusterName String

The name of the cluster.

nodeGroupName String

The name of the node group.

tags Map<String,String>

Key-value map of resource tags.

clusterName string

The name of the cluster.

nodeGroupName string

The name of the node group.

tags {[key: string]: string}

Key-value map of resource tags.

cluster_name str

The name of the cluster.

node_group_name str

The name of the node group.

tags Mapping[str, str]

Key-value map of resource tags.

clusterName String

The name of the cluster.

nodeGroupName String

The name of the node group.

tags Map<String>

Key-value map of resource tags.

getNodeGroup Result

The following output properties are available:

AmiType string

Type of Amazon Machine Image (AMI) associated with the EKS Node Group.

Arn string

Amazon Resource Name (ARN) of the EKS Node Group.

ClusterName string
DiskSize int

Disk size in GiB for worker nodes.

Id string

The provider-assigned unique ID for this managed resource.

InstanceTypes List<string>

Set of instance types associated with the EKS Node Group.

Labels Dictionary<string, string>

Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.

NodeGroupName string
NodeRoleArn string

Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.

ReleaseVersion string

AMI version of the EKS Node Group.

RemoteAccesses List<Pulumi.Aws.Eks.Outputs.GetNodeGroupRemoteAccess>

Configuration block with remote access settings.

Resources List<Pulumi.Aws.Eks.Outputs.GetNodeGroupResource>

List of objects containing information about underlying resources.

ScalingConfigs List<Pulumi.Aws.Eks.Outputs.GetNodeGroupScalingConfig>

Configuration block with scaling settings.

Status string

Status of the EKS Node Group.

SubnetIds List<string>

Identifiers of EC2 Subnets to associate with the EKS Node Group.

Tags Dictionary<string, string>

Key-value map of resource tags.

Taints List<Pulumi.Aws.Eks.Outputs.GetNodeGroupTaint>

List of objects containing information about taints applied to the nodes in the EKS Node Group.

Version string

Kubernetes version.

AmiType string

Type of Amazon Machine Image (AMI) associated with the EKS Node Group.

Arn string

Amazon Resource Name (ARN) of the EKS Node Group.

ClusterName string
DiskSize int

Disk size in GiB for worker nodes.

Id string

The provider-assigned unique ID for this managed resource.

InstanceTypes []string

Set of instance types associated with the EKS Node Group.

Labels map[string]string

Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.

NodeGroupName string
NodeRoleArn string

Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.

ReleaseVersion string

AMI version of the EKS Node Group.

RemoteAccesses []GetNodeGroupRemoteAccess

Configuration block with remote access settings.

Resources []GetNodeGroupResource

List of objects containing information about underlying resources.

ScalingConfigs []GetNodeGroupScalingConfig

Configuration block with scaling settings.

Status string

Status of the EKS Node Group.

SubnetIds []string

Identifiers of EC2 Subnets to associate with the EKS Node Group.

Tags map[string]string

Key-value map of resource tags.

Taints []GetNodeGroupTaint

List of objects containing information about taints applied to the nodes in the EKS Node Group.

Version string

Kubernetes version.

amiType String

Type of Amazon Machine Image (AMI) associated with the EKS Node Group.

arn String

Amazon Resource Name (ARN) of the EKS Node Group.

clusterName String
diskSize Integer

Disk size in GiB for worker nodes.

id String

The provider-assigned unique ID for this managed resource.

instanceTypes List<String>

Set of instance types associated with the EKS Node Group.

labels Map<String,String>

Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.

nodeGroupName String
nodeRoleArn String

Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.

releaseVersion String

AMI version of the EKS Node Group.

remoteAccesses List<GetNodeGroupRemoteAccess>

Configuration block with remote access settings.

resources List<GetNodeGroupResource>

List of objects containing information about underlying resources.

scalingConfigs List<GetNodeGroupScalingConfig>

Configuration block with scaling settings.

status String

Status of the EKS Node Group.

subnetIds List<String>

Identifiers of EC2 Subnets to associate with the EKS Node Group.

tags Map<String,String>

Key-value map of resource tags.

taints List<GetNodeGroupTaint>

List of objects containing information about taints applied to the nodes in the EKS Node Group.

version String

Kubernetes version.

amiType string

Type of Amazon Machine Image (AMI) associated with the EKS Node Group.

arn string

Amazon Resource Name (ARN) of the EKS Node Group.

clusterName string
diskSize number

Disk size in GiB for worker nodes.

id string

The provider-assigned unique ID for this managed resource.

instanceTypes string[]

Set of instance types associated with the EKS Node Group.

labels {[key: string]: string}

Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.

nodeGroupName string
nodeRoleArn string

Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.

releaseVersion string

AMI version of the EKS Node Group.

remoteAccesses GetNodeGroupRemoteAccess[]

Configuration block with remote access settings.

resources GetNodeGroupResource[]

List of objects containing information about underlying resources.

scalingConfigs GetNodeGroupScalingConfig[]

Configuration block with scaling settings.

status string

Status of the EKS Node Group.

subnetIds string[]

Identifiers of EC2 Subnets to associate with the EKS Node Group.

tags {[key: string]: string}

Key-value map of resource tags.

taints GetNodeGroupTaint[]

List of objects containing information about taints applied to the nodes in the EKS Node Group.

version string

Kubernetes version.

ami_type str

Type of Amazon Machine Image (AMI) associated with the EKS Node Group.

arn str

Amazon Resource Name (ARN) of the EKS Node Group.

cluster_name str
disk_size int

Disk size in GiB for worker nodes.

id str

The provider-assigned unique ID for this managed resource.

instance_types Sequence[str]

Set of instance types associated with the EKS Node Group.

labels Mapping[str, str]

Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.

node_group_name str
node_role_arn str

Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.

release_version str

AMI version of the EKS Node Group.

remote_accesses Sequence[GetNodeGroupRemoteAccess]

Configuration block with remote access settings.

resources Sequence[GetNodeGroupResource]

List of objects containing information about underlying resources.

scaling_configs Sequence[GetNodeGroupScalingConfig]

Configuration block with scaling settings.

status str

Status of the EKS Node Group.

subnet_ids Sequence[str]

Identifiers of EC2 Subnets to associate with the EKS Node Group.

tags Mapping[str, str]

Key-value map of resource tags.

taints Sequence[GetNodeGroupTaint]

List of objects containing information about taints applied to the nodes in the EKS Node Group.

version str

Kubernetes version.

amiType String

Type of Amazon Machine Image (AMI) associated with the EKS Node Group.

arn String

Amazon Resource Name (ARN) of the EKS Node Group.

clusterName String
diskSize Number

Disk size in GiB for worker nodes.

id String

The provider-assigned unique ID for this managed resource.

instanceTypes List<String>

Set of instance types associated with the EKS Node Group.

labels Map<String>

Key-value map of Kubernetes labels. Only labels that are applied with the EKS API are managed by this argument. Other Kubernetes labels applied to the EKS Node Group will not be managed.

nodeGroupName String
nodeRoleArn String

Amazon Resource Name (ARN) of the IAM Role that provides permissions for the EKS Node Group.

releaseVersion String

AMI version of the EKS Node Group.

remoteAccesses List<Property Map>

Configuration block with remote access settings.

resources List<Property Map>

List of objects containing information about underlying resources.

scalingConfigs List<Property Map>

Configuration block with scaling settings.

status String

Status of the EKS Node Group.

subnetIds List<String>

Identifiers of EC2 Subnets to associate with the EKS Node Group.

tags Map<String>

Key-value map of resource tags.

taints List<Property Map>

List of objects containing information about taints applied to the nodes in the EKS Node Group.

version String

Kubernetes version.

Supporting Types

GetNodeGroupRemoteAccess

Ec2SshKey string

EC2 Key Pair name that provides access for SSH communication with the worker nodes in the EKS Node Group.

SourceSecurityGroupIds List<string>

Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes.

Ec2SshKey string

EC2 Key Pair name that provides access for SSH communication with the worker nodes in the EKS Node Group.

SourceSecurityGroupIds []string

Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes.

ec2SshKey String

EC2 Key Pair name that provides access for SSH communication with the worker nodes in the EKS Node Group.

sourceSecurityGroupIds List<String>

Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes.

ec2SshKey string

EC2 Key Pair name that provides access for SSH communication with the worker nodes in the EKS Node Group.

sourceSecurityGroupIds string[]

Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes.

ec2_ssh_key str

EC2 Key Pair name that provides access for SSH communication with the worker nodes in the EKS Node Group.

source_security_group_ids Sequence[str]

Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes.

ec2SshKey String

EC2 Key Pair name that provides access for SSH communication with the worker nodes in the EKS Node Group.

sourceSecurityGroupIds List<String>

Set of EC2 Security Group IDs to allow SSH access (port 22) from on the worker nodes.

GetNodeGroupResource

AutoscalingGroups List<Pulumi.Aws.Eks.Inputs.GetNodeGroupResourceAutoscalingGroup>

List of objects containing information about AutoScaling Groups.

RemoteAccessSecurityGroupId string

Identifier of the remote access EC2 Security Group.

AutoscalingGroups []GetNodeGroupResourceAutoscalingGroup

List of objects containing information about AutoScaling Groups.

RemoteAccessSecurityGroupId string

Identifier of the remote access EC2 Security Group.

autoscalingGroups List<GetNodeGroupResourceAutoscalingGroup>

List of objects containing information about AutoScaling Groups.

remoteAccessSecurityGroupId String

Identifier of the remote access EC2 Security Group.

autoscalingGroups GetNodeGroupResourceAutoscalingGroup[]

List of objects containing information about AutoScaling Groups.

remoteAccessSecurityGroupId string

Identifier of the remote access EC2 Security Group.

autoscaling_groups Sequence[GetNodeGroupResourceAutoscalingGroup]

List of objects containing information about AutoScaling Groups.

remote_access_security_group_id str

Identifier of the remote access EC2 Security Group.

autoscalingGroups List<Property Map>

List of objects containing information about AutoScaling Groups.

remoteAccessSecurityGroupId String

Identifier of the remote access EC2 Security Group.

GetNodeGroupResourceAutoscalingGroup

Name string

Name of the AutoScaling Group.

Name string

Name of the AutoScaling Group.

name String

Name of the AutoScaling Group.

name string

Name of the AutoScaling Group.

name str

Name of the AutoScaling Group.

name String

Name of the AutoScaling Group.

GetNodeGroupScalingConfig

DesiredSize int

Desired number of worker nodes.

MaxSize int

Maximum number of worker nodes.

MinSize int

Minimum number of worker nodes.

DesiredSize int

Desired number of worker nodes.

MaxSize int

Maximum number of worker nodes.

MinSize int

Minimum number of worker nodes.

desiredSize Integer

Desired number of worker nodes.

maxSize Integer

Maximum number of worker nodes.

minSize Integer

Minimum number of worker nodes.

desiredSize number

Desired number of worker nodes.

maxSize number

Maximum number of worker nodes.

minSize number

Minimum number of worker nodes.

desired_size int

Desired number of worker nodes.

max_size int

Maximum number of worker nodes.

min_size int

Minimum number of worker nodes.

desiredSize Number

Desired number of worker nodes.

maxSize Number

Maximum number of worker nodes.

minSize Number

Minimum number of worker nodes.

GetNodeGroupTaint

Effect string

The effect of the taint.

Key string

The key of the taint.

Value string

The value of the taint.

Effect string

The effect of the taint.

Key string

The key of the taint.

Value string

The value of the taint.

effect String

The effect of the taint.

key String

The key of the taint.

value String

The value of the taint.

effect string

The effect of the taint.

key string

The key of the taint.

value string

The value of the taint.

effect str

The effect of the taint.

key str

The key of the taint.

value str

The value of the taint.

effect String

The effect of the taint.

key String

The key of the taint.

value String

The value of the taint.

Package Details

Repository
https://github.com/pulumi/pulumi-aws
License
Apache-2.0
Notes

This Pulumi package is based on the aws Terraform Provider.