1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. ContainerEngine
  5. VirtualNodePool
Oracle Cloud Infrastructure v2.32.0 published on Thursday, Apr 24, 2025 by Pulumi

oci.ContainerEngine.VirtualNodePool

Explore with Pulumi AI

This resource provides the Virtual Node Pool resource in Oracle Cloud Infrastructure Container Engine service.

Create a new virtual node pool.

Example Usage

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

const testVirtualNodePool = new oci.containerengine.VirtualNodePool("test_virtual_node_pool", {
    clusterId: testCluster.id,
    compartmentId: compartmentId,
    displayName: virtualNodePoolDisplayName,
    placementConfigurations: [{
        availabilityDomain: virtualNodePoolPlacementConfigurationsAvailabilityDomain,
        faultDomains: virtualNodePoolPlacementConfigurationsFaultDomain,
        subnetId: testSubnet.id,
    }],
    definedTags: {
        "Operations.CostCenter": "42",
    },
    freeformTags: {
        Department: "Finance",
    },
    initialVirtualNodeLabels: [{
        key: virtualNodePoolInitialVirtualNodeLabelsKey,
        value: virtualNodePoolInitialVirtualNodeLabelsValue,
    }],
    nsgIds: virtualNodePoolNsgIds,
    podConfiguration: {
        shape: virtualNodePoolPodConfigurationShape,
        subnetId: testSubnet.id,
        nsgIds: virtualNodePoolPodConfigurationNsgIds,
    },
    size: virtualNodePoolSize,
    taints: [{
        effect: virtualNodePoolTaintsEffect,
        key: virtualNodePoolTaintsKey,
        value: virtualNodePoolTaintsValue,
    }],
    virtualNodeTags: {
        definedTags: {
            "Operations.CostCenter": "42",
        },
        freeformTags: {
            Department: "Finance",
        },
    },
});
Copy
import pulumi
import pulumi_oci as oci

test_virtual_node_pool = oci.container_engine.VirtualNodePool("test_virtual_node_pool",
    cluster_id=test_cluster["id"],
    compartment_id=compartment_id,
    display_name=virtual_node_pool_display_name,
    placement_configurations=[{
        "availability_domain": virtual_node_pool_placement_configurations_availability_domain,
        "fault_domains": virtual_node_pool_placement_configurations_fault_domain,
        "subnet_id": test_subnet["id"],
    }],
    defined_tags={
        "Operations.CostCenter": "42",
    },
    freeform_tags={
        "Department": "Finance",
    },
    initial_virtual_node_labels=[{
        "key": virtual_node_pool_initial_virtual_node_labels_key,
        "value": virtual_node_pool_initial_virtual_node_labels_value,
    }],
    nsg_ids=virtual_node_pool_nsg_ids,
    pod_configuration={
        "shape": virtual_node_pool_pod_configuration_shape,
        "subnet_id": test_subnet["id"],
        "nsg_ids": virtual_node_pool_pod_configuration_nsg_ids,
    },
    size=virtual_node_pool_size,
    taints=[{
        "effect": virtual_node_pool_taints_effect,
        "key": virtual_node_pool_taints_key,
        "value": virtual_node_pool_taints_value,
    }],
    virtual_node_tags={
        "defined_tags": {
            "Operations.CostCenter": "42",
        },
        "freeform_tags": {
            "Department": "Finance",
        },
    })
Copy
package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/containerengine"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := containerengine.NewVirtualNodePool(ctx, "test_virtual_node_pool", &containerengine.VirtualNodePoolArgs{
			ClusterId:     pulumi.Any(testCluster.Id),
			CompartmentId: pulumi.Any(compartmentId),
			DisplayName:   pulumi.Any(virtualNodePoolDisplayName),
			PlacementConfigurations: containerengine.VirtualNodePoolPlacementConfigurationArray{
				&containerengine.VirtualNodePoolPlacementConfigurationArgs{
					AvailabilityDomain: pulumi.Any(virtualNodePoolPlacementConfigurationsAvailabilityDomain),
					FaultDomains:       pulumi.Any(virtualNodePoolPlacementConfigurationsFaultDomain),
					SubnetId:           pulumi.Any(testSubnet.Id),
				},
			},
			DefinedTags: pulumi.StringMap{
				"Operations.CostCenter": pulumi.String("42"),
			},
			FreeformTags: pulumi.StringMap{
				"Department": pulumi.String("Finance"),
			},
			InitialVirtualNodeLabels: containerengine.VirtualNodePoolInitialVirtualNodeLabelArray{
				&containerengine.VirtualNodePoolInitialVirtualNodeLabelArgs{
					Key:   pulumi.Any(virtualNodePoolInitialVirtualNodeLabelsKey),
					Value: pulumi.Any(virtualNodePoolInitialVirtualNodeLabelsValue),
				},
			},
			NsgIds: pulumi.Any(virtualNodePoolNsgIds),
			PodConfiguration: &containerengine.VirtualNodePoolPodConfigurationArgs{
				Shape:    pulumi.Any(virtualNodePoolPodConfigurationShape),
				SubnetId: pulumi.Any(testSubnet.Id),
				NsgIds:   pulumi.Any(virtualNodePoolPodConfigurationNsgIds),
			},
			Size: pulumi.Any(virtualNodePoolSize),
			Taints: containerengine.VirtualNodePoolTaintArray{
				&containerengine.VirtualNodePoolTaintArgs{
					Effect: pulumi.Any(virtualNodePoolTaintsEffect),
					Key:    pulumi.Any(virtualNodePoolTaintsKey),
					Value:  pulumi.Any(virtualNodePoolTaintsValue),
				},
			},
			VirtualNodeTags: &containerengine.VirtualNodePoolVirtualNodeTagsArgs{
				DefinedTags: pulumi.StringMap{
					"Operations.CostCenter": pulumi.String("42"),
				},
				FreeformTags: pulumi.StringMap{
					"Department": pulumi.String("Finance"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testVirtualNodePool = new Oci.ContainerEngine.VirtualNodePool("test_virtual_node_pool", new()
    {
        ClusterId = testCluster.Id,
        CompartmentId = compartmentId,
        DisplayName = virtualNodePoolDisplayName,
        PlacementConfigurations = new[]
        {
            new Oci.ContainerEngine.Inputs.VirtualNodePoolPlacementConfigurationArgs
            {
                AvailabilityDomain = virtualNodePoolPlacementConfigurationsAvailabilityDomain,
                FaultDomains = virtualNodePoolPlacementConfigurationsFaultDomain,
                SubnetId = testSubnet.Id,
            },
        },
        DefinedTags = 
        {
            { "Operations.CostCenter", "42" },
        },
        FreeformTags = 
        {
            { "Department", "Finance" },
        },
        InitialVirtualNodeLabels = new[]
        {
            new Oci.ContainerEngine.Inputs.VirtualNodePoolInitialVirtualNodeLabelArgs
            {
                Key = virtualNodePoolInitialVirtualNodeLabelsKey,
                Value = virtualNodePoolInitialVirtualNodeLabelsValue,
            },
        },
        NsgIds = virtualNodePoolNsgIds,
        PodConfiguration = new Oci.ContainerEngine.Inputs.VirtualNodePoolPodConfigurationArgs
        {
            Shape = virtualNodePoolPodConfigurationShape,
            SubnetId = testSubnet.Id,
            NsgIds = virtualNodePoolPodConfigurationNsgIds,
        },
        Size = virtualNodePoolSize,
        Taints = new[]
        {
            new Oci.ContainerEngine.Inputs.VirtualNodePoolTaintArgs
            {
                Effect = virtualNodePoolTaintsEffect,
                Key = virtualNodePoolTaintsKey,
                Value = virtualNodePoolTaintsValue,
            },
        },
        VirtualNodeTags = new Oci.ContainerEngine.Inputs.VirtualNodePoolVirtualNodeTagsArgs
        {
            DefinedTags = 
            {
                { "Operations.CostCenter", "42" },
            },
            FreeformTags = 
            {
                { "Department", "Finance" },
            },
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.ContainerEngine.VirtualNodePool;
import com.pulumi.oci.ContainerEngine.VirtualNodePoolArgs;
import com.pulumi.oci.ContainerEngine.inputs.VirtualNodePoolPlacementConfigurationArgs;
import com.pulumi.oci.ContainerEngine.inputs.VirtualNodePoolInitialVirtualNodeLabelArgs;
import com.pulumi.oci.ContainerEngine.inputs.VirtualNodePoolPodConfigurationArgs;
import com.pulumi.oci.ContainerEngine.inputs.VirtualNodePoolTaintArgs;
import com.pulumi.oci.ContainerEngine.inputs.VirtualNodePoolVirtualNodeTagsArgs;
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 testVirtualNodePool = new VirtualNodePool("testVirtualNodePool", VirtualNodePoolArgs.builder()
            .clusterId(testCluster.id())
            .compartmentId(compartmentId)
            .displayName(virtualNodePoolDisplayName)
            .placementConfigurations(VirtualNodePoolPlacementConfigurationArgs.builder()
                .availabilityDomain(virtualNodePoolPlacementConfigurationsAvailabilityDomain)
                .faultDomains(virtualNodePoolPlacementConfigurationsFaultDomain)
                .subnetId(testSubnet.id())
                .build())
            .definedTags(Map.of("Operations.CostCenter", "42"))
            .freeformTags(Map.of("Department", "Finance"))
            .initialVirtualNodeLabels(VirtualNodePoolInitialVirtualNodeLabelArgs.builder()
                .key(virtualNodePoolInitialVirtualNodeLabelsKey)
                .value(virtualNodePoolInitialVirtualNodeLabelsValue)
                .build())
            .nsgIds(virtualNodePoolNsgIds)
            .podConfiguration(VirtualNodePoolPodConfigurationArgs.builder()
                .shape(virtualNodePoolPodConfigurationShape)
                .subnetId(testSubnet.id())
                .nsgIds(virtualNodePoolPodConfigurationNsgIds)
                .build())
            .size(virtualNodePoolSize)
            .taints(VirtualNodePoolTaintArgs.builder()
                .effect(virtualNodePoolTaintsEffect)
                .key(virtualNodePoolTaintsKey)
                .value(virtualNodePoolTaintsValue)
                .build())
            .virtualNodeTags(VirtualNodePoolVirtualNodeTagsArgs.builder()
                .definedTags(Map.of("Operations.CostCenter", "42"))
                .freeformTags(Map.of("Department", "Finance"))
                .build())
            .build());

    }
}
Copy
resources:
  testVirtualNodePool:
    type: oci:ContainerEngine:VirtualNodePool
    name: test_virtual_node_pool
    properties:
      clusterId: ${testCluster.id}
      compartmentId: ${compartmentId}
      displayName: ${virtualNodePoolDisplayName}
      placementConfigurations:
        - availabilityDomain: ${virtualNodePoolPlacementConfigurationsAvailabilityDomain}
          faultDomains: ${virtualNodePoolPlacementConfigurationsFaultDomain}
          subnetId: ${testSubnet.id}
      definedTags:
        Operations.CostCenter: '42'
      freeformTags:
        Department: Finance
      initialVirtualNodeLabels:
        - key: ${virtualNodePoolInitialVirtualNodeLabelsKey}
          value: ${virtualNodePoolInitialVirtualNodeLabelsValue}
      nsgIds: ${virtualNodePoolNsgIds}
      podConfiguration:
        shape: ${virtualNodePoolPodConfigurationShape}
        subnetId: ${testSubnet.id}
        nsgIds: ${virtualNodePoolPodConfigurationNsgIds}
      size: ${virtualNodePoolSize}
      taints:
        - effect: ${virtualNodePoolTaintsEffect}
          key: ${virtualNodePoolTaintsKey}
          value: ${virtualNodePoolTaintsValue}
      virtualNodeTags:
        definedTags:
          Operations.CostCenter: '42'
        freeformTags:
          Department: Finance
Copy

Create VirtualNodePool Resource

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

Constructor syntax

new VirtualNodePool(name: string, args: VirtualNodePoolArgs, opts?: CustomResourceOptions);
@overload
def VirtualNodePool(resource_name: str,
                    args: VirtualNodePoolArgs,
                    opts: Optional[ResourceOptions] = None)

@overload
def VirtualNodePool(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    cluster_id: Optional[str] = None,
                    compartment_id: Optional[str] = None,
                    display_name: Optional[str] = None,
                    placement_configurations: Optional[Sequence[_containerengine.VirtualNodePoolPlacementConfigurationArgs]] = None,
                    pod_configuration: Optional[_containerengine.VirtualNodePoolPodConfigurationArgs] = None,
                    size: Optional[int] = None,
                    defined_tags: Optional[Mapping[str, str]] = None,
                    freeform_tags: Optional[Mapping[str, str]] = None,
                    initial_virtual_node_labels: Optional[Sequence[_containerengine.VirtualNodePoolInitialVirtualNodeLabelArgs]] = None,
                    nsg_ids: Optional[Sequence[str]] = None,
                    taints: Optional[Sequence[_containerengine.VirtualNodePoolTaintArgs]] = None,
                    virtual_node_tags: Optional[_containerengine.VirtualNodePoolVirtualNodeTagsArgs] = None)
func NewVirtualNodePool(ctx *Context, name string, args VirtualNodePoolArgs, opts ...ResourceOption) (*VirtualNodePool, error)
public VirtualNodePool(string name, VirtualNodePoolArgs args, CustomResourceOptions? opts = null)
public VirtualNodePool(String name, VirtualNodePoolArgs args)
public VirtualNodePool(String name, VirtualNodePoolArgs args, CustomResourceOptions options)
type: oci:ContainerEngine:VirtualNodePool
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. VirtualNodePoolArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. VirtualNodePoolArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. VirtualNodePoolArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. VirtualNodePoolArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. VirtualNodePoolArgs
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 virtualNodePoolResource = new Oci.ContainerEngine.VirtualNodePool("virtualNodePoolResource", new()
{
    ClusterId = "string",
    CompartmentId = "string",
    DisplayName = "string",
    PlacementConfigurations = new[]
    {
        new Oci.ContainerEngine.Inputs.VirtualNodePoolPlacementConfigurationArgs
        {
            AvailabilityDomain = "string",
            FaultDomains = new[]
            {
                "string",
            },
            SubnetId = "string",
        },
    },
    PodConfiguration = new Oci.ContainerEngine.Inputs.VirtualNodePoolPodConfigurationArgs
    {
        Shape = "string",
        SubnetId = "string",
        NsgIds = new[]
        {
            "string",
        },
    },
    Size = 0,
    DefinedTags = 
    {
        { "string", "string" },
    },
    FreeformTags = 
    {
        { "string", "string" },
    },
    InitialVirtualNodeLabels = new[]
    {
        new Oci.ContainerEngine.Inputs.VirtualNodePoolInitialVirtualNodeLabelArgs
        {
            Key = "string",
            Value = "string",
        },
    },
    NsgIds = new[]
    {
        "string",
    },
    Taints = new[]
    {
        new Oci.ContainerEngine.Inputs.VirtualNodePoolTaintArgs
        {
            Effect = "string",
            Key = "string",
            Value = "string",
        },
    },
    VirtualNodeTags = new Oci.ContainerEngine.Inputs.VirtualNodePoolVirtualNodeTagsArgs
    {
        DefinedTags = 
        {
            { "string", "string" },
        },
        FreeformTags = 
        {
            { "string", "string" },
        },
    },
});
Copy
example, err := containerengine.NewVirtualNodePool(ctx, "virtualNodePoolResource", &containerengine.VirtualNodePoolArgs{
	ClusterId:     pulumi.String("string"),
	CompartmentId: pulumi.String("string"),
	DisplayName:   pulumi.String("string"),
	PlacementConfigurations: containerengine.VirtualNodePoolPlacementConfigurationArray{
		&containerengine.VirtualNodePoolPlacementConfigurationArgs{
			AvailabilityDomain: pulumi.String("string"),
			FaultDomains: pulumi.StringArray{
				pulumi.String("string"),
			},
			SubnetId: pulumi.String("string"),
		},
	},
	PodConfiguration: &containerengine.VirtualNodePoolPodConfigurationArgs{
		Shape:    pulumi.String("string"),
		SubnetId: pulumi.String("string"),
		NsgIds: pulumi.StringArray{
			pulumi.String("string"),
		},
	},
	Size: pulumi.Int(0),
	DefinedTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	FreeformTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	InitialVirtualNodeLabels: containerengine.VirtualNodePoolInitialVirtualNodeLabelArray{
		&containerengine.VirtualNodePoolInitialVirtualNodeLabelArgs{
			Key:   pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
	NsgIds: pulumi.StringArray{
		pulumi.String("string"),
	},
	Taints: containerengine.VirtualNodePoolTaintArray{
		&containerengine.VirtualNodePoolTaintArgs{
			Effect: pulumi.String("string"),
			Key:    pulumi.String("string"),
			Value:  pulumi.String("string"),
		},
	},
	VirtualNodeTags: &containerengine.VirtualNodePoolVirtualNodeTagsArgs{
		DefinedTags: pulumi.StringMap{
			"string": pulumi.String("string"),
		},
		FreeformTags: pulumi.StringMap{
			"string": pulumi.String("string"),
		},
	},
})
Copy
var virtualNodePoolResource = new VirtualNodePool("virtualNodePoolResource", VirtualNodePoolArgs.builder()
    .clusterId("string")
    .compartmentId("string")
    .displayName("string")
    .placementConfigurations(VirtualNodePoolPlacementConfigurationArgs.builder()
        .availabilityDomain("string")
        .faultDomains("string")
        .subnetId("string")
        .build())
    .podConfiguration(VirtualNodePoolPodConfigurationArgs.builder()
        .shape("string")
        .subnetId("string")
        .nsgIds("string")
        .build())
    .size(0)
    .definedTags(Map.of("string", "string"))
    .freeformTags(Map.of("string", "string"))
    .initialVirtualNodeLabels(VirtualNodePoolInitialVirtualNodeLabelArgs.builder()
        .key("string")
        .value("string")
        .build())
    .nsgIds("string")
    .taints(VirtualNodePoolTaintArgs.builder()
        .effect("string")
        .key("string")
        .value("string")
        .build())
    .virtualNodeTags(VirtualNodePoolVirtualNodeTagsArgs.builder()
        .definedTags(Map.of("string", "string"))
        .freeformTags(Map.of("string", "string"))
        .build())
    .build());
Copy
virtual_node_pool_resource = oci.container_engine.VirtualNodePool("virtualNodePoolResource",
    cluster_id="string",
    compartment_id="string",
    display_name="string",
    placement_configurations=[{
        "availability_domain": "string",
        "fault_domains": ["string"],
        "subnet_id": "string",
    }],
    pod_configuration={
        "shape": "string",
        "subnet_id": "string",
        "nsg_ids": ["string"],
    },
    size=0,
    defined_tags={
        "string": "string",
    },
    freeform_tags={
        "string": "string",
    },
    initial_virtual_node_labels=[{
        "key": "string",
        "value": "string",
    }],
    nsg_ids=["string"],
    taints=[{
        "effect": "string",
        "key": "string",
        "value": "string",
    }],
    virtual_node_tags={
        "defined_tags": {
            "string": "string",
        },
        "freeform_tags": {
            "string": "string",
        },
    })
Copy
const virtualNodePoolResource = new oci.containerengine.VirtualNodePool("virtualNodePoolResource", {
    clusterId: "string",
    compartmentId: "string",
    displayName: "string",
    placementConfigurations: [{
        availabilityDomain: "string",
        faultDomains: ["string"],
        subnetId: "string",
    }],
    podConfiguration: {
        shape: "string",
        subnetId: "string",
        nsgIds: ["string"],
    },
    size: 0,
    definedTags: {
        string: "string",
    },
    freeformTags: {
        string: "string",
    },
    initialVirtualNodeLabels: [{
        key: "string",
        value: "string",
    }],
    nsgIds: ["string"],
    taints: [{
        effect: "string",
        key: "string",
        value: "string",
    }],
    virtualNodeTags: {
        definedTags: {
            string: "string",
        },
        freeformTags: {
            string: "string",
        },
    },
});
Copy
type: oci:ContainerEngine:VirtualNodePool
properties:
    clusterId: string
    compartmentId: string
    definedTags:
        string: string
    displayName: string
    freeformTags:
        string: string
    initialVirtualNodeLabels:
        - key: string
          value: string
    nsgIds:
        - string
    placementConfigurations:
        - availabilityDomain: string
          faultDomains:
            - string
          subnetId: string
    podConfiguration:
        nsgIds:
            - string
        shape: string
        subnetId: string
    size: 0
    taints:
        - effect: string
          key: string
          value: string
    virtualNodeTags:
        definedTags:
            string: string
        freeformTags:
            string: string
Copy

VirtualNodePool 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 VirtualNodePool resource accepts the following input properties:

ClusterId
This property is required.
Changes to this property will trigger replacement.
string
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
CompartmentId
This property is required.
Changes to this property will trigger replacement.
string
Compartment of the virtual node pool.
DisplayName This property is required. string
(Updatable) Display name of the virtual node pool. This is a non-unique value.
PlacementConfigurations This property is required. List<VirtualNodePoolPlacementConfiguration>
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
PodConfiguration This property is required. VirtualNodePoolPodConfiguration
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
Size This property is required. int
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
DefinedTags Dictionary<string, string>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
FreeformTags Dictionary<string, string>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
InitialVirtualNodeLabels List<VirtualNodePoolInitialVirtualNodeLabel>
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
NsgIds List<string>
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
Taints List<VirtualNodePoolTaint>
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
VirtualNodeTags VirtualNodePoolVirtualNodeTags
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
ClusterId
This property is required.
Changes to this property will trigger replacement.
string
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
CompartmentId
This property is required.
Changes to this property will trigger replacement.
string
Compartment of the virtual node pool.
DisplayName This property is required. string
(Updatable) Display name of the virtual node pool. This is a non-unique value.
PlacementConfigurations This property is required. []VirtualNodePoolPlacementConfigurationArgs
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
PodConfiguration This property is required. VirtualNodePoolPodConfigurationArgs
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
Size This property is required. int
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
DefinedTags map[string]string
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
FreeformTags map[string]string
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
InitialVirtualNodeLabels []VirtualNodePoolInitialVirtualNodeLabelArgs
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
NsgIds []string
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
Taints []VirtualNodePoolTaintArgs
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
VirtualNodeTags VirtualNodePoolVirtualNodeTagsArgs
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
clusterId
This property is required.
Changes to this property will trigger replacement.
String
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
compartmentId
This property is required.
Changes to this property will trigger replacement.
String
Compartment of the virtual node pool.
displayName This property is required. String
(Updatable) Display name of the virtual node pool. This is a non-unique value.
placementConfigurations This property is required. List<VirtualNodePoolPlacementConfiguration>
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
podConfiguration This property is required. VirtualNodePoolPodConfiguration
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
size This property is required. Integer
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
definedTags Map<String,String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeformTags Map<String,String>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
initialVirtualNodeLabels List<VirtualNodePoolInitialVirtualNodeLabel>
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
nsgIds List<String>
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
taints List<VirtualNodePoolTaint>
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
virtualNodeTags VirtualNodePoolVirtualNodeTags
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
clusterId
This property is required.
Changes to this property will trigger replacement.
string
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
compartmentId
This property is required.
Changes to this property will trigger replacement.
string
Compartment of the virtual node pool.
displayName This property is required. string
(Updatable) Display name of the virtual node pool. This is a non-unique value.
placementConfigurations This property is required. VirtualNodePoolPlacementConfiguration[]
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
podConfiguration This property is required. VirtualNodePoolPodConfiguration
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
size This property is required. number
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
definedTags {[key: string]: string}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeformTags {[key: string]: string}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
initialVirtualNodeLabels VirtualNodePoolInitialVirtualNodeLabel[]
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
nsgIds string[]
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
taints VirtualNodePoolTaint[]
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
virtualNodeTags VirtualNodePoolVirtualNodeTags
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
cluster_id
This property is required.
Changes to this property will trigger replacement.
str
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
compartment_id
This property is required.
Changes to this property will trigger replacement.
str
Compartment of the virtual node pool.
display_name This property is required. str
(Updatable) Display name of the virtual node pool. This is a non-unique value.
placement_configurations This property is required. Sequence[containerengine.VirtualNodePoolPlacementConfigurationArgs]
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
pod_configuration This property is required. containerengine.VirtualNodePoolPodConfigurationArgs
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
size This property is required. int
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
defined_tags Mapping[str, str]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeform_tags Mapping[str, str]
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
initial_virtual_node_labels Sequence[containerengine.VirtualNodePoolInitialVirtualNodeLabelArgs]
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
nsg_ids Sequence[str]
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
taints Sequence[containerengine.VirtualNodePoolTaintArgs]
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
virtual_node_tags containerengine.VirtualNodePoolVirtualNodeTagsArgs
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
clusterId
This property is required.
Changes to this property will trigger replacement.
String
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
compartmentId
This property is required.
Changes to this property will trigger replacement.
String
Compartment of the virtual node pool.
displayName This property is required. String
(Updatable) Display name of the virtual node pool. This is a non-unique value.
placementConfigurations This property is required. List<Property Map>
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
podConfiguration This property is required. Property Map
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
size This property is required. Number
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
definedTags Map<String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeformTags Map<String>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
initialVirtualNodeLabels List<Property Map>
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
nsgIds List<String>
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
taints List<Property Map>
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
virtualNodeTags Property Map
(Updatable) The tags associated to the virtual nodes in this virtual node pool.

Outputs

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

Id string
The provider-assigned unique ID for this managed resource.
KubernetesVersion string
The version of Kubernetes running on the nodes in the node pool.
LifecycleDetails string
Details about the state of the Virtual Node Pool.
State string
The state of the Virtual Node Pool.
SystemTags Dictionary<string, string>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
TimeCreated string
The time the virtual node pool was created.
TimeUpdated string
The time the virtual node pool was updated.
Id string
The provider-assigned unique ID for this managed resource.
KubernetesVersion string
The version of Kubernetes running on the nodes in the node pool.
LifecycleDetails string
Details about the state of the Virtual Node Pool.
State string
The state of the Virtual Node Pool.
SystemTags map[string]string
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
TimeCreated string
The time the virtual node pool was created.
TimeUpdated string
The time the virtual node pool was updated.
id String
The provider-assigned unique ID for this managed resource.
kubernetesVersion String
The version of Kubernetes running on the nodes in the node pool.
lifecycleDetails String
Details about the state of the Virtual Node Pool.
state String
The state of the Virtual Node Pool.
systemTags Map<String,String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
timeCreated String
The time the virtual node pool was created.
timeUpdated String
The time the virtual node pool was updated.
id string
The provider-assigned unique ID for this managed resource.
kubernetesVersion string
The version of Kubernetes running on the nodes in the node pool.
lifecycleDetails string
Details about the state of the Virtual Node Pool.
state string
The state of the Virtual Node Pool.
systemTags {[key: string]: string}
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
timeCreated string
The time the virtual node pool was created.
timeUpdated string
The time the virtual node pool was updated.
id str
The provider-assigned unique ID for this managed resource.
kubernetes_version str
The version of Kubernetes running on the nodes in the node pool.
lifecycle_details str
Details about the state of the Virtual Node Pool.
state str
The state of the Virtual Node Pool.
system_tags Mapping[str, str]
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
time_created str
The time the virtual node pool was created.
time_updated str
The time the virtual node pool was updated.
id String
The provider-assigned unique ID for this managed resource.
kubernetesVersion String
The version of Kubernetes running on the nodes in the node pool.
lifecycleDetails String
Details about the state of the Virtual Node Pool.
state String
The state of the Virtual Node Pool.
systemTags Map<String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
timeCreated String
The time the virtual node pool was created.
timeUpdated String
The time the virtual node pool was updated.

Look up Existing VirtualNodePool Resource

Get an existing VirtualNodePool 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?: VirtualNodePoolState, opts?: CustomResourceOptions): VirtualNodePool
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        cluster_id: Optional[str] = None,
        compartment_id: Optional[str] = None,
        defined_tags: Optional[Mapping[str, str]] = None,
        display_name: Optional[str] = None,
        freeform_tags: Optional[Mapping[str, str]] = None,
        initial_virtual_node_labels: Optional[Sequence[_containerengine.VirtualNodePoolInitialVirtualNodeLabelArgs]] = None,
        kubernetes_version: Optional[str] = None,
        lifecycle_details: Optional[str] = None,
        nsg_ids: Optional[Sequence[str]] = None,
        placement_configurations: Optional[Sequence[_containerengine.VirtualNodePoolPlacementConfigurationArgs]] = None,
        pod_configuration: Optional[_containerengine.VirtualNodePoolPodConfigurationArgs] = None,
        size: Optional[int] = None,
        state: Optional[str] = None,
        system_tags: Optional[Mapping[str, str]] = None,
        taints: Optional[Sequence[_containerengine.VirtualNodePoolTaintArgs]] = None,
        time_created: Optional[str] = None,
        time_updated: Optional[str] = None,
        virtual_node_tags: Optional[_containerengine.VirtualNodePoolVirtualNodeTagsArgs] = None) -> VirtualNodePool
func GetVirtualNodePool(ctx *Context, name string, id IDInput, state *VirtualNodePoolState, opts ...ResourceOption) (*VirtualNodePool, error)
public static VirtualNodePool Get(string name, Input<string> id, VirtualNodePoolState? state, CustomResourceOptions? opts = null)
public static VirtualNodePool get(String name, Output<String> id, VirtualNodePoolState state, CustomResourceOptions options)
resources:  _:    type: oci:ContainerEngine:VirtualNodePool    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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:
ClusterId Changes to this property will trigger replacement. string
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
CompartmentId Changes to this property will trigger replacement. string
Compartment of the virtual node pool.
DefinedTags Dictionary<string, string>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
DisplayName string
(Updatable) Display name of the virtual node pool. This is a non-unique value.
FreeformTags Dictionary<string, string>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
InitialVirtualNodeLabels List<VirtualNodePoolInitialVirtualNodeLabel>
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
KubernetesVersion string
The version of Kubernetes running on the nodes in the node pool.
LifecycleDetails string
Details about the state of the Virtual Node Pool.
NsgIds List<string>
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
PlacementConfigurations List<VirtualNodePoolPlacementConfiguration>
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
PodConfiguration VirtualNodePoolPodConfiguration
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
Size int
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
State string
The state of the Virtual Node Pool.
SystemTags Dictionary<string, string>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
Taints List<VirtualNodePoolTaint>
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
TimeCreated string
The time the virtual node pool was created.
TimeUpdated string
The time the virtual node pool was updated.
VirtualNodeTags VirtualNodePoolVirtualNodeTags
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
ClusterId Changes to this property will trigger replacement. string
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
CompartmentId Changes to this property will trigger replacement. string
Compartment of the virtual node pool.
DefinedTags map[string]string
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
DisplayName string
(Updatable) Display name of the virtual node pool. This is a non-unique value.
FreeformTags map[string]string
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
InitialVirtualNodeLabels []VirtualNodePoolInitialVirtualNodeLabelArgs
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
KubernetesVersion string
The version of Kubernetes running on the nodes in the node pool.
LifecycleDetails string
Details about the state of the Virtual Node Pool.
NsgIds []string
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
PlacementConfigurations []VirtualNodePoolPlacementConfigurationArgs
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
PodConfiguration VirtualNodePoolPodConfigurationArgs
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
Size int
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
State string
The state of the Virtual Node Pool.
SystemTags map[string]string
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
Taints []VirtualNodePoolTaintArgs
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
TimeCreated string
The time the virtual node pool was created.
TimeUpdated string
The time the virtual node pool was updated.
VirtualNodeTags VirtualNodePoolVirtualNodeTagsArgs
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
clusterId Changes to this property will trigger replacement. String
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
compartmentId Changes to this property will trigger replacement. String
Compartment of the virtual node pool.
definedTags Map<String,String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
displayName String
(Updatable) Display name of the virtual node pool. This is a non-unique value.
freeformTags Map<String,String>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
initialVirtualNodeLabels List<VirtualNodePoolInitialVirtualNodeLabel>
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
kubernetesVersion String
The version of Kubernetes running on the nodes in the node pool.
lifecycleDetails String
Details about the state of the Virtual Node Pool.
nsgIds List<String>
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
placementConfigurations List<VirtualNodePoolPlacementConfiguration>
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
podConfiguration VirtualNodePoolPodConfiguration
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
size Integer
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
state String
The state of the Virtual Node Pool.
systemTags Map<String,String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
taints List<VirtualNodePoolTaint>
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
timeCreated String
The time the virtual node pool was created.
timeUpdated String
The time the virtual node pool was updated.
virtualNodeTags VirtualNodePoolVirtualNodeTags
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
clusterId Changes to this property will trigger replacement. string
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
compartmentId Changes to this property will trigger replacement. string
Compartment of the virtual node pool.
definedTags {[key: string]: string}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
displayName string
(Updatable) Display name of the virtual node pool. This is a non-unique value.
freeformTags {[key: string]: string}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
initialVirtualNodeLabels VirtualNodePoolInitialVirtualNodeLabel[]
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
kubernetesVersion string
The version of Kubernetes running on the nodes in the node pool.
lifecycleDetails string
Details about the state of the Virtual Node Pool.
nsgIds string[]
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
placementConfigurations VirtualNodePoolPlacementConfiguration[]
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
podConfiguration VirtualNodePoolPodConfiguration
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
size number
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
state string
The state of the Virtual Node Pool.
systemTags {[key: string]: string}
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
taints VirtualNodePoolTaint[]
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
timeCreated string
The time the virtual node pool was created.
timeUpdated string
The time the virtual node pool was updated.
virtualNodeTags VirtualNodePoolVirtualNodeTags
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
cluster_id Changes to this property will trigger replacement. str
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
compartment_id Changes to this property will trigger replacement. str
Compartment of the virtual node pool.
defined_tags Mapping[str, str]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
display_name str
(Updatable) Display name of the virtual node pool. This is a non-unique value.
freeform_tags Mapping[str, str]
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
initial_virtual_node_labels Sequence[containerengine.VirtualNodePoolInitialVirtualNodeLabelArgs]
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
kubernetes_version str
The version of Kubernetes running on the nodes in the node pool.
lifecycle_details str
Details about the state of the Virtual Node Pool.
nsg_ids Sequence[str]
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
placement_configurations Sequence[containerengine.VirtualNodePoolPlacementConfigurationArgs]
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
pod_configuration containerengine.VirtualNodePoolPodConfigurationArgs
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
size int
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
state str
The state of the Virtual Node Pool.
system_tags Mapping[str, str]
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
taints Sequence[containerengine.VirtualNodePoolTaintArgs]
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
time_created str
The time the virtual node pool was created.
time_updated str
The time the virtual node pool was updated.
virtual_node_tags containerengine.VirtualNodePoolVirtualNodeTagsArgs
(Updatable) The tags associated to the virtual nodes in this virtual node pool.
clusterId Changes to this property will trigger replacement. String
The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
compartmentId Changes to this property will trigger replacement. String
Compartment of the virtual node pool.
definedTags Map<String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
displayName String
(Updatable) Display name of the virtual node pool. This is a non-unique value.
freeformTags Map<String>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
initialVirtualNodeLabels List<Property Map>
(Updatable) Initial labels that will be added to the Kubernetes Virtual Node object when it registers.
kubernetesVersion String
The version of Kubernetes running on the nodes in the node pool.
lifecycleDetails String
Details about the state of the Virtual Node Pool.
nsgIds List<String>
(Updatable) List of network security group id's applied to the Virtual Node VNIC.
placementConfigurations List<Property Map>
(Updatable) The list of placement configurations which determines where Virtual Nodes will be provisioned across as it relates to the subnet and availability domains. The size attribute determines how many we evenly spread across these placement configurations
podConfiguration Property Map
(Updatable) The pod configuration for pods run on virtual nodes of this virtual node pool.
size Number
(Updatable) The number of Virtual Nodes that should be in the Virtual Node Pool. The placement configurations determine where these virtual nodes are placed.
state String
The state of the Virtual Node Pool.
systemTags Map<String>
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
taints List<Property Map>
(Updatable) A taint is a collection of <key, value, effect>. These taints will be applied to the Virtual Nodes of this Virtual Node Pool for Kubernetes scheduling.
timeCreated String
The time the virtual node pool was created.
timeUpdated String
The time the virtual node pool was updated.
virtualNodeTags Property Map
(Updatable) The tags associated to the virtual nodes in this virtual node pool.

Supporting Types

VirtualNodePoolInitialVirtualNodeLabel
, VirtualNodePoolInitialVirtualNodeLabelArgs

Key string
(Updatable) The key of the pair.
Value string
(Updatable) The value of the pair.
Key string
(Updatable) The key of the pair.
Value string
(Updatable) The value of the pair.
key String
(Updatable) The key of the pair.
value String
(Updatable) The value of the pair.
key string
(Updatable) The key of the pair.
value string
(Updatable) The value of the pair.
key str
(Updatable) The key of the pair.
value str
(Updatable) The value of the pair.
key String
(Updatable) The key of the pair.
value String
(Updatable) The value of the pair.

VirtualNodePoolPlacementConfiguration
, VirtualNodePoolPlacementConfigurationArgs

AvailabilityDomain This property is required. string
(Updatable) The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
FaultDomains This property is required. List<string>
(Updatable) The fault domain of this virtual node.
SubnetId This property is required. string
(Updatable) The OCID of the subnet in which to place virtual nodes.
AvailabilityDomain This property is required. string
(Updatable) The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
FaultDomains This property is required. []string
(Updatable) The fault domain of this virtual node.
SubnetId This property is required. string
(Updatable) The OCID of the subnet in which to place virtual nodes.
availabilityDomain This property is required. String
(Updatable) The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
faultDomains This property is required. List<String>
(Updatable) The fault domain of this virtual node.
subnetId This property is required. String
(Updatable) The OCID of the subnet in which to place virtual nodes.
availabilityDomain This property is required. string
(Updatable) The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
faultDomains This property is required. string[]
(Updatable) The fault domain of this virtual node.
subnetId This property is required. string
(Updatable) The OCID of the subnet in which to place virtual nodes.
availability_domain This property is required. str
(Updatable) The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
fault_domains This property is required. Sequence[str]
(Updatable) The fault domain of this virtual node.
subnet_id This property is required. str
(Updatable) The OCID of the subnet in which to place virtual nodes.
availabilityDomain This property is required. String
(Updatable) The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
faultDomains This property is required. List<String>
(Updatable) The fault domain of this virtual node.
subnetId This property is required. String
(Updatable) The OCID of the subnet in which to place virtual nodes.

VirtualNodePoolPodConfiguration
, VirtualNodePoolPodConfigurationArgs

Shape This property is required. string
(Updatable) Shape of the pods.
SubnetId This property is required. string
(Updatable) The regional subnet where pods' VNIC will be placed.
NsgIds List<string>
(Updatable) List of network security group IDs applied to the Pod VNIC.
Shape This property is required. string
(Updatable) Shape of the pods.
SubnetId This property is required. string
(Updatable) The regional subnet where pods' VNIC will be placed.
NsgIds []string
(Updatable) List of network security group IDs applied to the Pod VNIC.
shape This property is required. String
(Updatable) Shape of the pods.
subnetId This property is required. String
(Updatable) The regional subnet where pods' VNIC will be placed.
nsgIds List<String>
(Updatable) List of network security group IDs applied to the Pod VNIC.
shape This property is required. string
(Updatable) Shape of the pods.
subnetId This property is required. string
(Updatable) The regional subnet where pods' VNIC will be placed.
nsgIds string[]
(Updatable) List of network security group IDs applied to the Pod VNIC.
shape This property is required. str
(Updatable) Shape of the pods.
subnet_id This property is required. str
(Updatable) The regional subnet where pods' VNIC will be placed.
nsg_ids Sequence[str]
(Updatable) List of network security group IDs applied to the Pod VNIC.
shape This property is required. String
(Updatable) Shape of the pods.
subnetId This property is required. String
(Updatable) The regional subnet where pods' VNIC will be placed.
nsgIds List<String>
(Updatable) List of network security group IDs applied to the Pod VNIC.

VirtualNodePoolTaint
, VirtualNodePoolTaintArgs

Effect string
(Updatable) The effect of the pair.
Key string
(Updatable) The key of the pair.
Value string
(Updatable) The value of the pair.
Effect string
(Updatable) The effect of the pair.
Key string
(Updatable) The key of the pair.
Value string
(Updatable) The value of the pair.
effect String
(Updatable) The effect of the pair.
key String
(Updatable) The key of the pair.
value String
(Updatable) The value of the pair.
effect string
(Updatable) The effect of the pair.
key string
(Updatable) The key of the pair.
value string
(Updatable) The value of the pair.
effect str
(Updatable) The effect of the pair.
key str
(Updatable) The key of the pair.
value str
(Updatable) The value of the pair.
effect String
(Updatable) The effect of the pair.
key String
(Updatable) The key of the pair.
value String
(Updatable) The value of the pair.

VirtualNodePoolVirtualNodeTags
, VirtualNodePoolVirtualNodeTagsArgs

DefinedTags Dictionary<string, string>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
FreeformTags Dictionary<string, string>

(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

DefinedTags map[string]string
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
FreeformTags map[string]string

(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

definedTags Map<String,String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeformTags Map<String,String>

(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

definedTags {[key: string]: string}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeformTags {[key: string]: string}

(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

defined_tags Mapping[str, str]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeform_tags Mapping[str, str]

(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

definedTags Map<String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeformTags Map<String>

(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Import

VirtualNodePools can be imported using the id, e.g.

$ pulumi import oci:ContainerEngine/virtualNodePool:VirtualNodePool test_virtual_node_pool "id"
Copy

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

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes
This Pulumi package is based on the oci Terraform Provider.