Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
oci.ContainerEngine.getVirtualNodePool
Explore with Pulumi AI
This data source provides details about a specific Virtual Node Pool resource in Oracle Cloud Infrastructure Container Engine service.
Get the details of a virtual node pool.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testVirtualNodePool = oci.ContainerEngine.getVirtualNodePool({
    virtualNodePoolId: testVirtualNodePoolOciContainerengineVirtualNodePool.id,
});
import pulumi
import pulumi_oci as oci
test_virtual_node_pool = oci.ContainerEngine.get_virtual_node_pool(virtual_node_pool_id=test_virtual_node_pool_oci_containerengine_virtual_node_pool["id"])
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.GetVirtualNodePool(ctx, &containerengine.GetVirtualNodePoolArgs{
			VirtualNodePoolId: testVirtualNodePoolOciContainerengineVirtualNodePool.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() => 
{
    var testVirtualNodePool = Oci.ContainerEngine.GetVirtualNodePool.Invoke(new()
    {
        VirtualNodePoolId = testVirtualNodePoolOciContainerengineVirtualNodePool.Id,
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.ContainerEngine.ContainerEngineFunctions;
import com.pulumi.oci.ContainerEngine.inputs.GetVirtualNodePoolArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var testVirtualNodePool = ContainerEngineFunctions.getVirtualNodePool(GetVirtualNodePoolArgs.builder()
            .virtualNodePoolId(testVirtualNodePoolOciContainerengineVirtualNodePool.id())
            .build());
    }
}
variables:
  testVirtualNodePool:
    fn::invoke:
      function: oci:ContainerEngine:getVirtualNodePool
      arguments:
        virtualNodePoolId: ${testVirtualNodePoolOciContainerengineVirtualNodePool.id}
Using getVirtualNodePool
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getVirtualNodePool(args: GetVirtualNodePoolArgs, opts?: InvokeOptions): Promise<GetVirtualNodePoolResult>
function getVirtualNodePoolOutput(args: GetVirtualNodePoolOutputArgs, opts?: InvokeOptions): Output<GetVirtualNodePoolResult>def get_virtual_node_pool(virtual_node_pool_id: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetVirtualNodePoolResult
def get_virtual_node_pool_output(virtual_node_pool_id: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetVirtualNodePoolResult]func LookupVirtualNodePool(ctx *Context, args *LookupVirtualNodePoolArgs, opts ...InvokeOption) (*LookupVirtualNodePoolResult, error)
func LookupVirtualNodePoolOutput(ctx *Context, args *LookupVirtualNodePoolOutputArgs, opts ...InvokeOption) LookupVirtualNodePoolResultOutput> Note: This function is named LookupVirtualNodePool in the Go SDK.
public static class GetVirtualNodePool 
{
    public static Task<GetVirtualNodePoolResult> InvokeAsync(GetVirtualNodePoolArgs args, InvokeOptions? opts = null)
    public static Output<GetVirtualNodePoolResult> Invoke(GetVirtualNodePoolInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetVirtualNodePoolResult> getVirtualNodePool(GetVirtualNodePoolArgs args, InvokeOptions options)
public static Output<GetVirtualNodePoolResult> getVirtualNodePool(GetVirtualNodePoolArgs args, InvokeOptions options)
fn::invoke:
  function: oci:ContainerEngine/getVirtualNodePool:getVirtualNodePool
  arguments:
    # arguments dictionaryThe following arguments are supported:
- VirtualNode stringPool Id 
- The OCID of the virtual node pool.
- VirtualNode stringPool Id 
- The OCID of the virtual node pool.
- virtualNode StringPool Id 
- The OCID of the virtual node pool.
- virtualNode stringPool Id 
- The OCID of the virtual node pool.
- virtual_node_ strpool_ id 
- The OCID of the virtual node pool.
- virtualNode StringPool Id 
- The OCID of the virtual node pool.
getVirtualNodePool Result
The following output properties are available:
- ClusterId string
- The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
- CompartmentId string
- Compartment of the virtual node pool.
- Dictionary<string, string>
- 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
- Display name of the virtual node pool. This is a non-unique value.
- Dictionary<string, string>
- 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"}
- Id string
- The OCID of the virtual node pool.
- InitialVirtual List<GetNode Labels Virtual Node Pool Initial Virtual Node Label> 
- Initial labels that will be added to the Kubernetes Virtual Node object when it registers. This is the same as virtualNodePool resources.
- 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>
- List of network security group IDs applied to the Pod VNIC.
- PlacementConfigurations List<GetVirtual Node Pool Placement Configuration> 
- 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
- PodConfigurations List<GetVirtual Node Pool Pod Configuration> 
- The pod configuration for pods run on virtual nodes of this virtual node pool.
- Size int
- 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.
- Dictionary<string, string>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
- Taints
List<GetVirtual Node Pool Taint> 
- 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.
- VirtualNode stringPool Id 
- 
List<GetVirtual Node Pool Virtual Node Tag> 
- The tags associated to the virtual nodes in this virtual node pool.
- ClusterId string
- The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
- CompartmentId string
- Compartment of the virtual node pool.
- map[string]string
- 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
- Display name of the virtual node pool. This is a non-unique value.
- map[string]string
- 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"}
- Id string
- The OCID of the virtual node pool.
- InitialVirtual []GetNode Labels Virtual Node Pool Initial Virtual Node Label 
- Initial labels that will be added to the Kubernetes Virtual Node object when it registers. This is the same as virtualNodePool resources.
- 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
- List of network security group IDs applied to the Pod VNIC.
- PlacementConfigurations []GetVirtual Node Pool Placement Configuration 
- 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
- PodConfigurations []GetVirtual Node Pool Pod Configuration 
- The pod configuration for pods run on virtual nodes of this virtual node pool.
- Size int
- 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.
- map[string]string
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
- Taints
[]GetVirtual Node Pool Taint 
- 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.
- VirtualNode stringPool Id 
- 
[]GetVirtual Node Pool Virtual Node Tag 
- The tags associated to the virtual nodes in this virtual node pool.
- clusterId String
- The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
- compartmentId String
- Compartment of the virtual node pool.
- Map<String,String>
- 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
- Display name of the virtual node pool. This is a non-unique value.
- Map<String,String>
- 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"}
- id String
- The OCID of the virtual node pool.
- initialVirtual List<GetNode Labels Virtual Node Pool Initial Virtual Node Label> 
- Initial labels that will be added to the Kubernetes Virtual Node object when it registers. This is the same as virtualNodePool resources.
- 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>
- List of network security group IDs applied to the Pod VNIC.
- placementConfigurations List<GetVirtual Node Pool Placement Configuration> 
- 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
- podConfigurations List<GetVirtual Node Pool Pod Configuration> 
- The pod configuration for pods run on virtual nodes of this virtual node pool.
- size Integer
- 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.
- Map<String,String>
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
- taints
List<GetVirtual Node Pool Taint> 
- 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.
- virtualNode StringPool Id 
- 
List<GetVirtual Node Pool Virtual Node Tag> 
- The tags associated to the virtual nodes in this virtual node pool.
- clusterId string
- The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
- compartmentId string
- Compartment of the virtual node pool.
- {[key: string]: string}
- 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
- Display name of the virtual node pool. This is a non-unique value.
- {[key: string]: string}
- 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"}
- id string
- The OCID of the virtual node pool.
- initialVirtual GetNode Labels Virtual Node Pool Initial Virtual Node Label[] 
- Initial labels that will be added to the Kubernetes Virtual Node object when it registers. This is the same as virtualNodePool resources.
- 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[]
- List of network security group IDs applied to the Pod VNIC.
- placementConfigurations GetVirtual Node Pool Placement Configuration[] 
- 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
- podConfigurations GetVirtual Node Pool Pod Configuration[] 
- The pod configuration for pods run on virtual nodes of this virtual node pool.
- size number
- 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.
- {[key: string]: string}
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
- taints
GetVirtual Node Pool Taint[] 
- 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.
- virtualNode stringPool Id 
- 
GetVirtual Node Pool Virtual Node Tag[] 
- The tags associated to the virtual nodes in this virtual node pool.
- cluster_id str
- The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
- compartment_id str
- Compartment of the virtual node pool.
- Mapping[str, str]
- 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
- Display name of the virtual node pool. This is a non-unique value.
- Mapping[str, str]
- 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"}
- id str
- The OCID of the virtual node pool.
- initial_virtual_ Sequence[Getnode_ labels Virtual Node Pool Initial Virtual Node Label] 
- Initial labels that will be added to the Kubernetes Virtual Node object when it registers. This is the same as virtualNodePool resources.
- 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]
- List of network security group IDs applied to the Pod VNIC.
- placement_configurations Sequence[GetVirtual Node Pool Placement Configuration] 
- 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_configurations Sequence[GetVirtual Node Pool Pod Configuration] 
- The pod configuration for pods run on virtual nodes of this virtual node pool.
- size int
- 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.
- Mapping[str, str]
- Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
- taints
Sequence[GetVirtual Node Pool Taint] 
- 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_ strpool_ id 
- 
Sequence[GetVirtual Node Pool Virtual Node Tag] 
- The tags associated to the virtual nodes in this virtual node pool.
- clusterId String
- The cluster the virtual node pool is associated with. A virtual node pool can only be associated with one cluster.
- compartmentId String
- Compartment of the virtual node pool.
- Map<String>
- 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
- Display name of the virtual node pool. This is a non-unique value.
- Map<String>
- 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"}
- id String
- The OCID of the virtual node pool.
- initialVirtual List<Property Map>Node Labels 
- Initial labels that will be added to the Kubernetes Virtual Node object when it registers. This is the same as virtualNodePool resources.
- 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>
- List of network security group IDs applied to the Pod VNIC.
- placementConfigurations List<Property Map>
- 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
- podConfigurations List<Property Map>
- The pod configuration for pods run on virtual nodes of this virtual node pool.
- size Number
- 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.
- 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>
- 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.
- virtualNode StringPool Id 
- List<Property Map>
- The tags associated to the virtual nodes in this virtual node pool.
Supporting Types
GetVirtualNodePoolInitialVirtualNodeLabel       
GetVirtualNodePoolPlacementConfiguration     
- AvailabilityDomain string
- The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
- FaultDomains List<string>
- The fault domain of this virtual node.
- SubnetId string
- The regional subnet where pods' VNIC will be placed.
- AvailabilityDomain string
- The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
- FaultDomains []string
- The fault domain of this virtual node.
- SubnetId string
- The regional subnet where pods' VNIC will be placed.
- availabilityDomain String
- The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
- faultDomains List<String>
- The fault domain of this virtual node.
- subnetId String
- The regional subnet where pods' VNIC will be placed.
- availabilityDomain string
- The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
- faultDomains string[]
- The fault domain of this virtual node.
- subnetId string
- The regional subnet where pods' VNIC will be placed.
- availability_domain str
- The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
- fault_domains Sequence[str]
- The fault domain of this virtual node.
- subnet_id str
- The regional subnet where pods' VNIC will be placed.
- availabilityDomain String
- The availability domain in which to place virtual nodes. Example: Uocm:PHX-AD-1
- faultDomains List<String>
- The fault domain of this virtual node.
- subnetId String
- The regional subnet where pods' VNIC will be placed.
GetVirtualNodePoolPodConfiguration     
GetVirtualNodePoolTaint    
GetVirtualNodePoolVirtualNodeTag      
- Dictionary<string, string>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- Dictionary<string, string>
- 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"}
- map[string]string
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- map[string]string
- 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"}
- Map<String,String>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- Map<String,String>
- 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"}
- {[key: string]: string}
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- {[key: string]: string}
- 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"}
- Mapping[str, str]
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- Mapping[str, str]
- 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"}
- Map<String>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
- Map<String>
- 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"}
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the ociTerraform Provider.