KubernetesNodeGroupV2

vkcs 0.17.0, Jun 25 26

Viewing docs for vkcs 0.17.0
published on Thursday, Jun 25, 2026 by vk-cs

import * as pulumi from "@pulumi/pulumi";
import * as vkcs from "@pulumi/vkcs";

const k8sNodeGroup = new vkcs.KubernetesNodeGroupV2("k8s_node_group", {
    clusterId: k8sCluster.id,
    name: "k8s-node-group",
    nodeFlavor: basic.id,
    availabilityZone: "MS1",
    scaleType: "fixed_scale",
    fixedScaleNodeCount: 3,
    parallelUpgradeChunk: 40,
    diskType: "high-iops",
    diskSize: 20,
}, {
    dependsOn: [k8sCluster],
});

import pulumi
import pulumi_vkcs as vkcs

k8s_node_group = vkcs.KubernetesNodeGroupV2("k8s_node_group",
    cluster_id=k8s_cluster["id"],
    name="k8s-node-group",
    node_flavor=basic["id"],
    availability_zone="MS1",
    scale_type="fixed_scale",
    fixed_scale_node_count=3,
    parallel_upgrade_chunk=40,
    disk_type="high-iops",
    disk_size=20,
    opts = pulumi.ResourceOptions(depends_on=[k8s_cluster]))

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/vkcs/vkcs"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vkcs.NewKubernetesNodeGroupV2(ctx, "k8s_node_group", &vkcs.KubernetesNodeGroupV2Args{
			ClusterId:            pulumi.Any(k8sCluster.Id),
			Name:                 pulumi.String("k8s-node-group"),
			NodeFlavor:           pulumi.Any(basic.Id),
			AvailabilityZone:     pulumi.String("MS1"),
			ScaleType:            pulumi.String("fixed_scale"),
			FixedScaleNodeCount:  pulumi.Float64(3),
			ParallelUpgradeChunk: pulumi.Float64(40),
			DiskType:             pulumi.String("high-iops"),
			DiskSize:             pulumi.Float64(20),
		}, pulumi.DependsOn([]pulumi.Resource{
			k8sCluster,
		}))
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Vkcs = Pulumi.Vkcs;

return await Deployment.RunAsync(() => 
{
    var k8sNodeGroup = new Vkcs.KubernetesNodeGroupV2("k8s_node_group", new()
    {
        ClusterId = k8sCluster.Id,
        Name = "k8s-node-group",
        NodeFlavor = basic.Id,
        AvailabilityZone = "MS1",
        ScaleType = "fixed_scale",
        FixedScaleNodeCount = 3,
        ParallelUpgradeChunk = 40,
        DiskType = "high-iops",
        DiskSize = 20,
    }, new CustomResourceOptions
    {
        DependsOn =
        {
            k8sCluster,
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.vkcs.KubernetesNodeGroupV2;
import com.pulumi.vkcs.KubernetesNodeGroupV2Args;
import com.pulumi.resources.CustomResourceOptions;
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) {
        var k8sNodeGroup = new KubernetesNodeGroupV2("k8sNodeGroup", KubernetesNodeGroupV2Args.builder()
            .clusterId(k8sCluster.id())
            .name("k8s-node-group")
            .nodeFlavor(basic.id())
            .availabilityZone("MS1")
            .scaleType("fixed_scale")
            .fixedScaleNodeCount(3.0)
            .parallelUpgradeChunk(40.0)
            .diskType("high-iops")
            .diskSize(20.0)
            .build(), CustomResourceOptions.builder()
                .dependsOn(k8sCluster)
                .build());

    }
}

resources:
  k8sNodeGroup:
    type: vkcs:KubernetesNodeGroupV2
    name: k8s_node_group
    properties:
      clusterId: ${k8sCluster.id}
      name: k8s-node-group
      nodeFlavor: ${basic.id}
      availabilityZone: MS1
      scaleType: fixed_scale
      fixedScaleNodeCount: 3
      parallelUpgradeChunk: 40
      diskType: high-iops
      diskSize: 20
    options:
      dependsOn:
        - ${k8sCluster}

Example coming soon!

Create KubernetesNodeGroupV2 Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new KubernetesNodeGroupV2(name: string, args: KubernetesNodeGroupV2Args, opts?: CustomResourceOptions);

@overload
def KubernetesNodeGroupV2(resource_name: str,
                          args: KubernetesNodeGroupV2Args,
                          opts: Optional[ResourceOptions] = None)

@overload
def KubernetesNodeGroupV2(resource_name: str,
                          opts: Optional[ResourceOptions] = None,
                          node_flavor: Optional[str] = None,
                          parallel_upgrade_chunk: Optional[float] = None,
                          availability_zone: Optional[str] = None,
                          cluster_id: Optional[str] = None,
                          disk_size: Optional[float] = None,
                          disk_type: Optional[str] = None,
                          scale_type: Optional[str] = None,
                          name: Optional[str] = None,
                          fixed_scale_node_count: Optional[float] = None,
                          auto_scale_max_size: Optional[float] = None,
                          labels: Optional[Mapping[str, str]] = None,
                          region: Optional[str] = None,
                          auto_scale_min_size: Optional[float] = None,
                          taints: Optional[Sequence[KubernetesNodeGroupV2TaintArgs]] = None,
                          timeouts: Optional[KubernetesNodeGroupV2TimeoutsArgs] = None)

func NewKubernetesNodeGroupV2(ctx *Context, name string, args KubernetesNodeGroupV2Args, opts ...ResourceOption) (*KubernetesNodeGroupV2, error)

public KubernetesNodeGroupV2(string name, KubernetesNodeGroupV2Args args, CustomResourceOptions? opts = null)

public KubernetesNodeGroupV2(String name, KubernetesNodeGroupV2Args args)
public KubernetesNodeGroupV2(String name, KubernetesNodeGroupV2Args args, CustomResourceOptions options)

type: vkcs:KubernetesNodeGroupV2
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

resource "vkcs_kubernetesnodegroupv2" "name" {
    # resource properties
}

Parameters

name string: The unique name of the resource.
args KubernetesNodeGroupV2Args: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args KubernetesNodeGroupV2Args: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args KubernetesNodeGroupV2Args: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args KubernetesNodeGroupV2Args: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args KubernetesNodeGroupV2Args: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

Constructor example

The following reference example uses placeholder values for all input properties.

var kubernetesNodeGroupV2Resource = new Vkcs.KubernetesNodeGroupV2("kubernetesNodeGroupV2Resource", new()
{
    NodeFlavor = "string",
    ParallelUpgradeChunk = 0,
    AvailabilityZone = "string",
    ClusterId = "string",
    DiskSize = 0,
    DiskType = "string",
    ScaleType = "string",
    Name = "string",
    FixedScaleNodeCount = 0,
    AutoScaleMaxSize = 0,
    Labels = 
    {
        { "string", "string" },
    },
    Region = "string",
    AutoScaleMinSize = 0,
    Taints = new[]
    {
        new Vkcs.Inputs.KubernetesNodeGroupV2TaintArgs
        {
            Effect = "string",
            Key = "string",
            Value = "string",
        },
    },
    Timeouts = new Vkcs.Inputs.KubernetesNodeGroupV2TimeoutsArgs
    {
        Create = "string",
        Delete = "string",
        Update = "string",
    },
});

example, err := vkcs.NewKubernetesNodeGroupV2(ctx, "kubernetesNodeGroupV2Resource", &vkcs.KubernetesNodeGroupV2Args{
	NodeFlavor:           pulumi.String("string"),
	ParallelUpgradeChunk: pulumi.Float64(0),
	AvailabilityZone:     pulumi.String("string"),
	ClusterId:            pulumi.String("string"),
	DiskSize:             pulumi.Float64(0),
	DiskType:             pulumi.String("string"),
	ScaleType:            pulumi.String("string"),
	Name:                 pulumi.String("string"),
	FixedScaleNodeCount:  pulumi.Float64(0),
	AutoScaleMaxSize:     pulumi.Float64(0),
	Labels: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Region:           pulumi.String("string"),
	AutoScaleMinSize: pulumi.Float64(0),
	Taints: vkcs.KubernetesNodeGroupV2TaintArray{
		&vkcs.KubernetesNodeGroupV2TaintArgs{
			Effect: pulumi.String("string"),
			Key:    pulumi.String("string"),
			Value:  pulumi.String("string"),
		},
	},
	Timeouts: &vkcs.KubernetesNodeGroupV2TimeoutsArgs{
		Create: pulumi.String("string"),
		Delete: pulumi.String("string"),
		Update: pulumi.String("string"),
	},
})

resource "vkcs_kubernetesnodegroupv2" "kubernetesNodeGroupV2Resource" {
  node_flavor            = "string"
  parallel_upgrade_chunk = 0
  availability_zone      = "string"
  cluster_id             = "string"
  disk_size              = 0
  disk_type              = "string"
  scale_type             = "string"
  name                   = "string"
  fixed_scale_node_count = 0
  auto_scale_max_size    = 0
  labels = {
    "string" = "string"
  }
  region              = "string"
  auto_scale_min_size = 0
  taints {
    effect = "string"
    key    = "string"
    value  = "string"
  }
  timeouts = {
    create = "string"
    delete = "string"
    update = "string"
  }
}

var kubernetesNodeGroupV2Resource = new KubernetesNodeGroupV2("kubernetesNodeGroupV2Resource", KubernetesNodeGroupV2Args.builder()
    .nodeFlavor("string")
    .parallelUpgradeChunk(0.0)
    .availabilityZone("string")
    .clusterId("string")
    .diskSize(0.0)
    .diskType("string")
    .scaleType("string")
    .name("string")
    .fixedScaleNodeCount(0.0)
    .autoScaleMaxSize(0.0)
    .labels(Map.of("string", "string"))
    .region("string")
    .autoScaleMinSize(0.0)
    .taints(KubernetesNodeGroupV2TaintArgs.builder()
        .effect("string")
        .key("string")
        .value("string")
        .build())
    .timeouts(KubernetesNodeGroupV2TimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .update("string")
        .build())
    .build());

kubernetes_node_group_v2_resource = vkcs.KubernetesNodeGroupV2("kubernetesNodeGroupV2Resource",
    node_flavor="string",
    parallel_upgrade_chunk=float(0),
    availability_zone="string",
    cluster_id="string",
    disk_size=float(0),
    disk_type="string",
    scale_type="string",
    name="string",
    fixed_scale_node_count=float(0),
    auto_scale_max_size=float(0),
    labels={
        "string": "string",
    },
    region="string",
    auto_scale_min_size=float(0),
    taints=[{
        "effect": "string",
        "key": "string",
        "value": "string",
    }],
    timeouts={
        "create": "string",
        "delete": "string",
        "update": "string",
    })

const kubernetesNodeGroupV2Resource = new vkcs.KubernetesNodeGroupV2("kubernetesNodeGroupV2Resource", {
    nodeFlavor: "string",
    parallelUpgradeChunk: 0,
    availabilityZone: "string",
    clusterId: "string",
    diskSize: 0,
    diskType: "string",
    scaleType: "string",
    name: "string",
    fixedScaleNodeCount: 0,
    autoScaleMaxSize: 0,
    labels: {
        string: "string",
    },
    region: "string",
    autoScaleMinSize: 0,
    taints: [{
        effect: "string",
        key: "string",
        value: "string",
    }],
    timeouts: {
        create: "string",
        "delete": "string",
        update: "string",
    },
});

type: vkcs:KubernetesNodeGroupV2
properties:
    autoScaleMaxSize: 0
    autoScaleMinSize: 0
    availabilityZone: string
    clusterId: string
    diskSize: 0
    diskType: string
    fixedScaleNodeCount: 0
    labels:
        string: string
    name: string
    nodeFlavor: string
    parallelUpgradeChunk: 0
    region: string
    scaleType: string
    taints:
        - effect: string
          key: string
          value: string
    timeouts:
        create: string
        delete: string
        update: string

KubernetesNodeGroupV2 Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The KubernetesNodeGroupV2 resource accepts the following input properties:

AvailabilityZone string: required string → The availability zone where the nodes will be placed. Forces replacement on change.
ClusterId string: required string → The ID of the parent cluster. Forces replacement on change.
DiskSize double: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
DiskType string: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
NodeFlavor string: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
ParallelUpgradeChunk double: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
ScaleType string: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
AutoScaleMaxSize double: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
AutoScaleMinSize double: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
FixedScaleNodeCount double: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
Labels Dictionary<string, string>: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
Name string: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
Region string: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
Taints List<KubernetesNodeGroupV2Taint>: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
Timeouts KubernetesNodeGroupV2Timeouts: Timeout configuration for create, update and delete operations.

AvailabilityZone string: required string → The availability zone where the nodes will be placed. Forces replacement on change.
ClusterId string: required string → The ID of the parent cluster. Forces replacement on change.
DiskSize float64: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
DiskType string: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
NodeFlavor string: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
ParallelUpgradeChunk float64: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
ScaleType string: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
AutoScaleMaxSize float64: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
AutoScaleMinSize float64: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
FixedScaleNodeCount float64: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
Labels map[string]string: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
Name string: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
Region string: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
Taints []KubernetesNodeGroupV2TaintArgs: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
Timeouts KubernetesNodeGroupV2TimeoutsArgs: Timeout configuration for create, update and delete operations.

availability_zone string: required string → The availability zone where the nodes will be placed. Forces replacement on change.
cluster_id string: required string → The ID of the parent cluster. Forces replacement on change.
disk_size number: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
disk_type string: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
node_flavor string: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallel_upgrade_chunk number: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
scale_type string: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
auto_scale_max_size number: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
auto_scale_min_size number: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
fixed_scale_node_count number: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels map(string): optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name string: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
region string: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
taints list(object): set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts object: Timeout configuration for create, update and delete operations.

availabilityZone String: required string → The availability zone where the nodes will be placed. Forces replacement on change.
clusterId String: required string → The ID of the parent cluster. Forces replacement on change.
diskSize Double: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
diskType String: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
nodeFlavor String: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallelUpgradeChunk Double: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
scaleType String: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
autoScaleMaxSize Double: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
autoScaleMinSize Double: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
fixedScaleNodeCount Double: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels Map<String,String>: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name String: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
region String: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
taints List<KubernetesNodeGroupV2Taint>: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts KubernetesNodeGroupV2Timeouts: Timeout configuration for create, update and delete operations.

availabilityZone string: required string → The availability zone where the nodes will be placed. Forces replacement on change.
clusterId string: required string → The ID of the parent cluster. Forces replacement on change.
diskSize number: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
diskType string: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
nodeFlavor string: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallelUpgradeChunk number: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
scaleType string: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
autoScaleMaxSize number: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
autoScaleMinSize number: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
fixedScaleNodeCount number: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels {[key: string]: string}: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name string: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
region string: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
taints KubernetesNodeGroupV2Taint[]: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts KubernetesNodeGroupV2Timeouts: Timeout configuration for create, update and delete operations.

availability_zone str: required string → The availability zone where the nodes will be placed. Forces replacement on change.
cluster_id str: required string → The ID of the parent cluster. Forces replacement on change.
disk_size float: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
disk_type str: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
node_flavor str: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallel_upgrade_chunk float: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
scale_type str: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
auto_scale_max_size float: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
auto_scale_min_size float: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
fixed_scale_node_count float: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels Mapping[str, str]: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name str: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
region str: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
taints Sequence[KubernetesNodeGroupV2TaintArgs]: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts KubernetesNodeGroupV2TimeoutsArgs: Timeout configuration for create, update and delete operations.

availabilityZone String: required string → The availability zone where the nodes will be placed. Forces replacement on change.
clusterId String: required string → The ID of the parent cluster. Forces replacement on change.
diskSize Number: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
diskType String: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
nodeFlavor String: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallelUpgradeChunk Number: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
scaleType String: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
autoScaleMaxSize Number: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
autoScaleMinSize Number: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
fixedScaleNodeCount Number: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels Map<String>: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name String: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
region String: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
taints List<Property Map>: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts Property Map: Timeout configuration for create, update and delete operations.

Outputs

All input properties are implicitly available as output properties. Additionally, the KubernetesNodeGroupV2 resource produces the following output properties:

AutoScaleNodeCount double: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
CreatedAt string: string → The timestamp when the node group was created, in ISO 8601 format.
Id string: The provider-assigned unique ID for this managed resource.
Uuid string: string → The UUID of the node group. It is generated automatically.

AutoScaleNodeCount float64: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
CreatedAt string: string → The timestamp when the node group was created, in ISO 8601 format.
Id string: The provider-assigned unique ID for this managed resource.
Uuid string: string → The UUID of the node group. It is generated automatically.

auto_scale_node_count number: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
created_at string: string → The timestamp when the node group was created, in ISO 8601 format.
id string: The provider-assigned unique ID for this managed resource.
uuid string: string → The UUID of the node group. It is generated automatically.

autoScaleNodeCount Double: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
createdAt String: string → The timestamp when the node group was created, in ISO 8601 format.
id String: The provider-assigned unique ID for this managed resource.
uuid String: string → The UUID of the node group. It is generated automatically.

autoScaleNodeCount number: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
createdAt string: string → The timestamp when the node group was created, in ISO 8601 format.
id string: The provider-assigned unique ID for this managed resource.
uuid string: string → The UUID of the node group. It is generated automatically.

auto_scale_node_count float: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
created_at str: string → The timestamp when the node group was created, in ISO 8601 format.
id str: The provider-assigned unique ID for this managed resource.
uuid str: string → The UUID of the node group. It is generated automatically.

autoScaleNodeCount Number: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
createdAt String: string → The timestamp when the node group was created, in ISO 8601 format.
id String: The provider-assigned unique ID for this managed resource.
uuid String: string → The UUID of the node group. It is generated automatically.

Look up Existing KubernetesNodeGroupV2 Resource

Get an existing KubernetesNodeGroupV2 resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: KubernetesNodeGroupV2State, opts?: CustomResourceOptions): KubernetesNodeGroupV2

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        auto_scale_max_size: Optional[float] = None,
        auto_scale_min_size: Optional[float] = None,
        auto_scale_node_count: Optional[float] = None,
        availability_zone: Optional[str] = None,
        cluster_id: Optional[str] = None,
        created_at: Optional[str] = None,
        disk_size: Optional[float] = None,
        disk_type: Optional[str] = None,
        fixed_scale_node_count: Optional[float] = None,
        labels: Optional[Mapping[str, str]] = None,
        name: Optional[str] = None,
        node_flavor: Optional[str] = None,
        parallel_upgrade_chunk: Optional[float] = None,
        region: Optional[str] = None,
        scale_type: Optional[str] = None,
        taints: Optional[Sequence[KubernetesNodeGroupV2TaintArgs]] = None,
        timeouts: Optional[KubernetesNodeGroupV2TimeoutsArgs] = None,
        uuid: Optional[str] = None) -> KubernetesNodeGroupV2

func GetKubernetesNodeGroupV2(ctx *Context, name string, id IDInput, state *KubernetesNodeGroupV2State, opts ...ResourceOption) (*KubernetesNodeGroupV2, error)

public static KubernetesNodeGroupV2 Get(string name, Input<string> id, KubernetesNodeGroupV2State? state, CustomResourceOptions? opts = null)

public static KubernetesNodeGroupV2 get(String name, Output<String> id, KubernetesNodeGroupV2State state, CustomResourceOptions options)

resources:  _:    type: vkcs:KubernetesNodeGroupV2    get:      id: ${id}

import {
  to = vkcs_kubernetesnodegroupv2.example
  id = "${id}"
}

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

resource_name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

The following state arguments are supported:

AutoScaleMaxSize double: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
AutoScaleMinSize double: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
AutoScaleNodeCount double: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
AvailabilityZone string: required string → The availability zone where the nodes will be placed. Forces replacement on change.
ClusterId string: required string → The ID of the parent cluster. Forces replacement on change.
CreatedAt string: string → The timestamp when the node group was created, in ISO 8601 format.
DiskSize double: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
DiskType string: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
FixedScaleNodeCount double: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
Labels Dictionary<string, string>: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
Name string: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
NodeFlavor string: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
ParallelUpgradeChunk double: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
Region string: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
ScaleType string: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
Taints List<KubernetesNodeGroupV2Taint>: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
Timeouts KubernetesNodeGroupV2Timeouts: Timeout configuration for create, update and delete operations.
Uuid string: string → The UUID of the node group. It is generated automatically.

AutoScaleMaxSize float64: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
AutoScaleMinSize float64: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
AutoScaleNodeCount float64: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
AvailabilityZone string: required string → The availability zone where the nodes will be placed. Forces replacement on change.
ClusterId string: required string → The ID of the parent cluster. Forces replacement on change.
CreatedAt string: string → The timestamp when the node group was created, in ISO 8601 format.
DiskSize float64: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
DiskType string: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
FixedScaleNodeCount float64: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
Labels map[string]string: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
Name string: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
NodeFlavor string: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
ParallelUpgradeChunk float64: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
Region string: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
ScaleType string: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
Taints []KubernetesNodeGroupV2TaintArgs: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
Timeouts KubernetesNodeGroupV2TimeoutsArgs: Timeout configuration for create, update and delete operations.
Uuid string: string → The UUID of the node group. It is generated automatically.

auto_scale_max_size number: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
auto_scale_min_size number: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
auto_scale_node_count number: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
availability_zone string: required string → The availability zone where the nodes will be placed. Forces replacement on change.
cluster_id string: required string → The ID of the parent cluster. Forces replacement on change.
created_at string: string → The timestamp when the node group was created, in ISO 8601 format.
disk_size number: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
disk_type string: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
fixed_scale_node_count number: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels map(string): optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name string: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
node_flavor string: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallel_upgrade_chunk number: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
region string: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
scale_type string: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
taints list(object): set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts object: Timeout configuration for create, update and delete operations.
uuid string: string → The UUID of the node group. It is generated automatically.

autoScaleMaxSize Double: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
autoScaleMinSize Double: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
autoScaleNodeCount Double: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
availabilityZone String: required string → The availability zone where the nodes will be placed. Forces replacement on change.
clusterId String: required string → The ID of the parent cluster. Forces replacement on change.
createdAt String: string → The timestamp when the node group was created, in ISO 8601 format.
diskSize Double: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
diskType String: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
fixedScaleNodeCount Double: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels Map<String,String>: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name String: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
nodeFlavor String: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallelUpgradeChunk Double: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
region String: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
scaleType String: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
taints List<KubernetesNodeGroupV2Taint>: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts KubernetesNodeGroupV2Timeouts: Timeout configuration for create, update and delete operations.
uuid String: string → The UUID of the node group. It is generated automatically.

autoScaleMaxSize number: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
autoScaleMinSize number: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
autoScaleNodeCount number: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
availabilityZone string: required string → The availability zone where the nodes will be placed. Forces replacement on change.
clusterId string: required string → The ID of the parent cluster. Forces replacement on change.
createdAt string: string → The timestamp when the node group was created, in ISO 8601 format.
diskSize number: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
diskType string: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
fixedScaleNodeCount number: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels {[key: string]: string}: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name string: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
nodeFlavor string: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallelUpgradeChunk number: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
region string: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
scaleType string: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
taints KubernetesNodeGroupV2Taint[]: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts KubernetesNodeGroupV2Timeouts: Timeout configuration for create, update and delete operations.
uuid string: string → The UUID of the node group. It is generated automatically.

auto_scale_max_size float: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
auto_scale_min_size float: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
auto_scale_node_count float: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
availability_zone str: required string → The availability zone where the nodes will be placed. Forces replacement on change.
cluster_id str: required string → The ID of the parent cluster. Forces replacement on change.
created_at str: string → The timestamp when the node group was created, in ISO 8601 format.
disk_size float: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
disk_type str: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
fixed_scale_node_count float: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels Mapping[str, str]: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name str: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
node_flavor str: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallel_upgrade_chunk float: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
region str: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
scale_type str: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
taints Sequence[KubernetesNodeGroupV2TaintArgs]: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts KubernetesNodeGroupV2TimeoutsArgs: Timeout configuration for create, update and delete operations.
uuid str: string → The UUID of the node group. It is generated automatically.

autoScaleMaxSize Number: optional number → The maximum number of nodes the autoscaler may scale out to. Must be greater than or equal to 0 and also greater than or equal to auto_scale_min_size. Required if scale_type is auto_scale.
autoScaleMinSize Number: optional number → The minimum number of nodes the autoscaler can scale down to. Must be at least 0. Required when scale_type is auto_scale.
autoScaleNodeCount Number: number → The current number of nodes in the node group. Only applicable when scale_type is auto_scale. This value is computed by the provider and cannot be set by the user.
availabilityZone String: required string → The availability zone where the nodes will be placed. Forces replacement on change.
clusterId String: required string → The ID of the parent cluster. Forces replacement on change.
createdAt String: string → The timestamp when the node group was created, in ISO 8601 format.
diskSize Number: required number → The size of the root volume, in gigabytes (GB). Must be at least 1. Forces replacement on change.
diskType String: required string → The root volume type. For example: ceph-ssd. Use the vkcs.getKubernetesVolumeTypesV2 data source to list available types for the selected availability zone. Forces replacement on change.
fixedScaleNodeCount Number: optional number → The desired number of nodes. Minimum value is 0. This argument is required when scale_type is fixed_scale.
labels Map<String>: optional map of string → Kubernetes labels to apply to the nodes in this node group. Both keys and values must conform to Kubernetes label syntax.
name String: required string → A unique name for the node group within the cluster. Must be 3-25 characters, lowercase alphanumeric and hyphens only. Forces replacement on change.
nodeFlavor String: required string → The flavor ID used for worker nodes. Use STD3-* flavor for clusters in PA2 availability zone. Changing this triggers a rolling upgrade of the nodes.
parallelUpgradeChunk Number: required number → The maximum percentage of nodes (1-100) that can be upgraded simultaneously during a rolling upgrade.
region String: optional string → The region where the node group will be created. If omitted, the provider's region is used. Forces replacement on change.
scaleType String: required string → Type of scaling for the node group. Must be either fixed_scale or auto_scale. If scale_type is auto_scale, the condition auto_scale_min_size <= auto_scale_max_size must be met.
taints List<Property Map>: set → Kubernetes taints to apply to the nodes in this node group. Each taint must specify key, value, and effect — where effect is one of: NoSchedule, PreferNoSchedule, NoExecute.
timeouts Property Map: Timeout configuration for create, update and delete operations.
uuid String: string → The UUID of the node group. It is generated automatically.

Supporting Types

KubernetesNodeGroupV2Taint, KubernetesNodeGroupV2TaintArgs

Effect string: required string → The effect of the taint. Must be one of: NoSchedule, PreferNoSchedule, NoExecute.
Key string: required string → The key of the taint. Must conform to Kubernetes label key syntax.
Value string: required string → The value of the taint. Must conform to Kubernetes label value syntax.

Effect string: required string → The effect of the taint. Must be one of: NoSchedule, PreferNoSchedule, NoExecute.
Key string: required string → The key of the taint. Must conform to Kubernetes label key syntax.
Value string: required string → The value of the taint. Must conform to Kubernetes label value syntax.

effect string: required string → The effect of the taint. Must be one of: NoSchedule, PreferNoSchedule, NoExecute.
key string: required string → The key of the taint. Must conform to Kubernetes label key syntax.
value string: required string → The value of the taint. Must conform to Kubernetes label value syntax.

effect String: required string → The effect of the taint. Must be one of: NoSchedule, PreferNoSchedule, NoExecute.
key String: required string → The key of the taint. Must conform to Kubernetes label key syntax.
value String: required string → The value of the taint. Must conform to Kubernetes label value syntax.

effect string: required string → The effect of the taint. Must be one of: NoSchedule, PreferNoSchedule, NoExecute.
key string: required string → The key of the taint. Must conform to Kubernetes label key syntax.
value string: required string → The value of the taint. Must conform to Kubernetes label value syntax.

effect str: required string → The effect of the taint. Must be one of: NoSchedule, PreferNoSchedule, NoExecute.
key str: required string → The key of the taint. Must conform to Kubernetes label key syntax.
value str: required string → The value of the taint. Must conform to Kubernetes label value syntax.

effect String: required string → The effect of the taint. Must be one of: NoSchedule, PreferNoSchedule, NoExecute.
key String: required string → The key of the taint. Must conform to Kubernetes label key syntax.
value String: required string → The value of the taint. Must conform to Kubernetes label value syntax.

KubernetesNodeGroupV2Timeouts, KubernetesNodeGroupV2TimeoutsArgs

Create string: Timeout for create operation (e.g., 60m, 2h). Default is 30m.
Delete string: Timeout for delete operation (e.g., 120m, 3h). Default is 30m.
Update string: Timeout for update operation (e.g., 120m, 3h). Default is 30m.

Create string: Timeout for create operation (e.g., 60m, 2h). Default is 30m.
Delete string: Timeout for delete operation (e.g., 120m, 3h). Default is 30m.
Update string: Timeout for update operation (e.g., 120m, 3h). Default is 30m.

create string: Timeout for create operation (e.g., 60m, 2h). Default is 30m.
delete string: Timeout for delete operation (e.g., 120m, 3h). Default is 30m.
update string: Timeout for update operation (e.g., 120m, 3h). Default is 30m.

create String: Timeout for create operation (e.g., 60m, 2h). Default is 30m.
delete String: Timeout for delete operation (e.g., 120m, 3h). Default is 30m.
update String: Timeout for update operation (e.g., 120m, 3h). Default is 30m.

create string: Timeout for create operation (e.g., 60m, 2h). Default is 30m.
delete string: Timeout for delete operation (e.g., 120m, 3h). Default is 30m.
update string: Timeout for update operation (e.g., 120m, 3h). Default is 30m.

create str: Timeout for create operation (e.g., 60m, 2h). Default is 30m.
delete str: Timeout for delete operation (e.g., 120m, 3h). Default is 30m.
update str: Timeout for update operation (e.g., 120m, 3h). Default is 30m.

create String: Timeout for create operation (e.g., 60m, 2h). Default is 30m.
delete String: Timeout for delete operation (e.g., 120m, 3h). Default is 30m.
update String: Timeout for update operation (e.g., 120m, 3h). Default is 30m.

Import

Node groups can be imported using the id, e.g.

$ pulumi import vkcs:index/kubernetesNodeGroupV2:KubernetesNodeGroupV2 k8s_node_group 39WHkEHwtXy1YWqka4D5xuBJxw4

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository: vkcs vk-cs/terraform-provider-vkcs
License
Notes: This Pulumi package is based on the vkcs Terraform Provider.

Viewing docs for vkcs 0.17.0
published on Thursday, Jun 25, 2026 by vk-cs

Schema (JSON)

vk-cs/terraform-provider-vkcs

vkcs.KubernetesNodeGroupV2

On this page

On this page

Create KubernetesNodeGroupV2 Resource

Constructor syntax

Parameters

Constructor example

KubernetesNodeGroupV2 Resource Properties

Inputs

Outputs

Look up Existing KubernetesNodeGroupV2 Resource

Supporting Types

KubernetesNodeGroupV2Taint, KubernetesNodeGroupV2TaintArgs

KubernetesNodeGroupV2Timeouts, KubernetesNodeGroupV2TimeoutsArgs

Import

Package Details

On this page

On this page

Try Pulumi Cloud free.
Your team will thank you.

vkcs.KubernetesNodeGroupV2

On this page

On this page

Create KubernetesNodeGroupV2 Resource

Constructor syntax

Parameters

Constructor example

KubernetesNodeGroupV2 Resource Properties

Inputs

Outputs

Look up Existing KubernetesNodeGroupV2 Resource

Supporting Types

KubernetesNodeGroupV2Taint, KubernetesNodeGroupV2TaintArgs

KubernetesNodeGroupV2Timeouts, KubernetesNodeGroupV2TimeoutsArgs

Import

Package Details

On this page

On this page

Try Pulumi Cloud free.Your team will thank you.

Try Pulumi Cloud free.
Your team will thank you.