Oracle Cloud Infrastructure v3.3.0, Jul 17 25

Oracle Cloud Infrastructure v3.3.0 published on Thursday, Jul 17, 2025 by Pulumi

oci.Core.getInstancePools

Explore with Pulumi AI

Oracle Cloud Infrastructure v3.3.0 published on Thursday, Jul 17, 2025 by Pulumi

Example Usage

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

const testInstancePools = oci.Core.getInstancePools({
    compartmentId: compartmentId,
    displayName: instancePoolDisplayName,
    state: instancePoolState,
});

import pulumi
import pulumi_oci as oci

test_instance_pools = oci.Core.get_instance_pools(compartment_id=compartment_id,
    display_name=instance_pool_display_name,
    state=instance_pool_state)

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := core.GetInstancePools(ctx, &core.GetInstancePoolsArgs{
			CompartmentId: compartmentId,
			DisplayName:   pulumi.StringRef(instancePoolDisplayName),
			State:         pulumi.StringRef(instancePoolState),
		}, 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 testInstancePools = Oci.Core.GetInstancePools.Invoke(new()
    {
        CompartmentId = compartmentId,
        DisplayName = instancePoolDisplayName,
        State = instancePoolState,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.CoreFunctions;
import com.pulumi.oci.Core.inputs.GetInstancePoolsArgs;
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 testInstancePools = CoreFunctions.getInstancePools(GetInstancePoolsArgs.builder()
            .compartmentId(compartmentId)
            .displayName(instancePoolDisplayName)
            .state(instancePoolState)
            .build());

    }
}

variables:
  testInstancePools:
    fn::invoke:
      function: oci:Core:getInstancePools
      arguments:
        compartmentId: ${compartmentId}
        displayName: ${instancePoolDisplayName}
        state: ${instancePoolState}

Using getInstancePools

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 getInstancePools(args: GetInstancePoolsArgs, opts?: InvokeOptions): Promise<GetInstancePoolsResult>
function getInstancePoolsOutput(args: GetInstancePoolsOutputArgs, opts?: InvokeOptions): Output<GetInstancePoolsResult>

def get_instance_pools(compartment_id: Optional[str] = None,
                       display_name: Optional[str] = None,
                       filters: Optional[Sequence[GetInstancePoolsFilter]] = None,
                       state: Optional[str] = None,
                       opts: Optional[InvokeOptions] = None) -> GetInstancePoolsResult
def get_instance_pools_output(compartment_id: Optional[pulumi.Input[str]] = None,
                       display_name: Optional[pulumi.Input[str]] = None,
                       filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetInstancePoolsFilterArgs]]]] = None,
                       state: Optional[pulumi.Input[str]] = None,
                       opts: Optional[InvokeOptions] = None) -> Output[GetInstancePoolsResult]

func GetInstancePools(ctx *Context, args *GetInstancePoolsArgs, opts ...InvokeOption) (*GetInstancePoolsResult, error)
func GetInstancePoolsOutput(ctx *Context, args *GetInstancePoolsOutputArgs, opts ...InvokeOption) GetInstancePoolsResultOutput

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

public static class GetInstancePools 
{
    public static Task<GetInstancePoolsResult> InvokeAsync(GetInstancePoolsArgs args, InvokeOptions? opts = null)
    public static Output<GetInstancePoolsResult> Invoke(GetInstancePoolsInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetInstancePoolsResult> getInstancePools(GetInstancePoolsArgs args, InvokeOptions options)
public static Output<GetInstancePoolsResult> getInstancePools(GetInstancePoolsArgs args, InvokeOptions options)

fn::invoke:
  function: oci:Core/getInstancePools:getInstancePools
  arguments:
    # arguments dictionary

The following arguments are supported:

CompartmentId string: The OCID of the compartment.
DisplayName string: A filter to return only resources that match the given display name exactly.
Filters List<GetInstancePoolsFilter>
State string: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.

CompartmentId string: The OCID of the compartment.
DisplayName string: A filter to return only resources that match the given display name exactly.
Filters []GetInstancePoolsFilter
State string: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.

compartmentId String: The OCID of the compartment.
displayName String: A filter to return only resources that match the given display name exactly.
filters List<GetInstancePoolsFilter>
state String: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.

compartmentId string: The OCID of the compartment.
displayName string: A filter to return only resources that match the given display name exactly.
filters GetInstancePoolsFilter[]
state string: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.

compartment_id str: The OCID of the compartment.
display_name str: A filter to return only resources that match the given display name exactly.
filters Sequence[GetInstancePoolsFilter]
state str: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.

compartmentId String: The OCID of the compartment.
displayName String: A filter to return only resources that match the given display name exactly.
filters List<Property Map>
state String: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.

getInstancePools Result

The following output properties are available:

CompartmentId string: The OCID of the compartment containing the instance pool.
Id string: The provider-assigned unique ID for this managed resource.
InstancePools List<GetInstancePoolsInstancePool>: The list of instance_pools.
DisplayName string: The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
Filters List<GetInstancePoolsFilter>
State string: The current state of the instance pool.

CompartmentId string: The OCID of the compartment containing the instance pool.
Id string: The provider-assigned unique ID for this managed resource.
InstancePools []GetInstancePoolsInstancePool: The list of instance_pools.
DisplayName string: The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
Filters []GetInstancePoolsFilter
State string: The current state of the instance pool.

compartmentId String: The OCID of the compartment containing the instance pool.
id String: The provider-assigned unique ID for this managed resource.
instancePools List<GetInstancePoolsInstancePool>: The list of instance_pools.
displayName String: The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
filters List<GetInstancePoolsFilter>
state String: The current state of the instance pool.

compartmentId string: The OCID of the compartment containing the instance pool.
id string: The provider-assigned unique ID for this managed resource.
instancePools GetInstancePoolsInstancePool[]: The list of instance_pools.
displayName string: The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
filters GetInstancePoolsFilter[]
state string: The current state of the instance pool.

compartment_id str: The OCID of the compartment containing the instance pool.
id str: The provider-assigned unique ID for this managed resource.
instance_pools Sequence[GetInstancePoolsInstancePool]: The list of instance_pools.
display_name str: The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
filters Sequence[GetInstancePoolsFilter]
state str: The current state of the instance pool.

compartmentId String: The OCID of the compartment containing the instance pool.
id String: The provider-assigned unique ID for this managed resource.
instancePools List<Property Map>: The list of instance_pools.
displayName String: The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
filters List<Property Map>
state String: The current state of the instance pool.

Supporting Types

GetInstancePoolsFilter

Name string
Values List<string>
Regex bool

Name string
Values []string
Regex bool

name String
values List<String>
regex Boolean

name string
values string[]
regex boolean

name str
values Sequence[str]
regex bool

name String
values List<String>
regex Boolean

GetInstancePoolsInstancePool

ActualSize int
CompartmentId string: The OCID of the compartment.
DefinedTags 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: A filter to return only resources that match the given display name exactly.
FreeformTags 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 load balancer attachment.
InstanceConfigurationId string: The OCID of the instance configuration associated with the instance pool.
InstanceDisplayNameFormatter string: A user-friendly formatter for the instance pool's instances. Instance displaynames follow the format. The formatter does not retroactively change instance's displaynames, only instance displaynames in the future follow the format
InstanceHostnameFormatter string: A user-friendly formatter for the instance pool's instances. Instance hostnames follow the format. The formatter does not retroactively change instance's hostnames, only instance hostnames in the future follow the format
LoadBalancers List<GetInstancePoolsInstancePoolLoadBalancer>: The load balancers attached to the instance pool.
PlacementConfigurations List<GetInstancePoolsInstancePoolPlacementConfiguration>: The placement configurations for the instance pool.
Size int: The number of actual instances in the instance pool on the cloud. This attribute will be different when instance pool is used along with autoScaling Configuration.
State string: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
TimeCreated string: The date and time the instance pool was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

ActualSize int
CompartmentId string: The OCID of the compartment.
DefinedTags 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: A filter to return only resources that match the given display name exactly.
FreeformTags 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 load balancer attachment.
InstanceConfigurationId string: The OCID of the instance configuration associated with the instance pool.
InstanceDisplayNameFormatter string: A user-friendly formatter for the instance pool's instances. Instance displaynames follow the format. The formatter does not retroactively change instance's displaynames, only instance displaynames in the future follow the format
InstanceHostnameFormatter string: A user-friendly formatter for the instance pool's instances. Instance hostnames follow the format. The formatter does not retroactively change instance's hostnames, only instance hostnames in the future follow the format
LoadBalancers []GetInstancePoolsInstancePoolLoadBalancer: The load balancers attached to the instance pool.
PlacementConfigurations []GetInstancePoolsInstancePoolPlacementConfiguration: The placement configurations for the instance pool.
Size int: The number of actual instances in the instance pool on the cloud. This attribute will be different when instance pool is used along with autoScaling Configuration.
State string: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
TimeCreated string: The date and time the instance pool was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

actualSize Integer
compartmentId String: The OCID of the compartment.
definedTags 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: A filter to return only resources that match the given display name exactly.
freeformTags 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 load balancer attachment.
instanceConfigurationId String: The OCID of the instance configuration associated with the instance pool.
instanceDisplayNameFormatter String: A user-friendly formatter for the instance pool's instances. Instance displaynames follow the format. The formatter does not retroactively change instance's displaynames, only instance displaynames in the future follow the format
instanceHostnameFormatter String: A user-friendly formatter for the instance pool's instances. Instance hostnames follow the format. The formatter does not retroactively change instance's hostnames, only instance hostnames in the future follow the format
loadBalancers List<GetInstancePoolsInstancePoolLoadBalancer>: The load balancers attached to the instance pool.
placementConfigurations List<GetInstancePoolsInstancePoolPlacementConfiguration>: The placement configurations for the instance pool.
size Integer: The number of actual instances in the instance pool on the cloud. This attribute will be different when instance pool is used along with autoScaling Configuration.
state String: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
timeCreated String: The date and time the instance pool was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

actualSize number
compartmentId string: The OCID of the compartment.
definedTags {[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: A filter to return only resources that match the given display name exactly.
freeformTags {[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 load balancer attachment.
instanceConfigurationId string: The OCID of the instance configuration associated with the instance pool.
instanceDisplayNameFormatter string: A user-friendly formatter for the instance pool's instances. Instance displaynames follow the format. The formatter does not retroactively change instance's displaynames, only instance displaynames in the future follow the format
instanceHostnameFormatter string: A user-friendly formatter for the instance pool's instances. Instance hostnames follow the format. The formatter does not retroactively change instance's hostnames, only instance hostnames in the future follow the format
loadBalancers GetInstancePoolsInstancePoolLoadBalancer[]: The load balancers attached to the instance pool.
placementConfigurations GetInstancePoolsInstancePoolPlacementConfiguration[]: The placement configurations for the instance pool.
size number: The number of actual instances in the instance pool on the cloud. This attribute will be different when instance pool is used along with autoScaling Configuration.
state string: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
timeCreated string: The date and time the instance pool was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

actual_size int
compartment_id str: The OCID of the compartment.
defined_tags 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: A filter to return only resources that match the given display name exactly.
freeform_tags 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 load balancer attachment.
instance_configuration_id str: The OCID of the instance configuration associated with the instance pool.
instance_display_name_formatter str: A user-friendly formatter for the instance pool's instances. Instance displaynames follow the format. The formatter does not retroactively change instance's displaynames, only instance displaynames in the future follow the format
instance_hostname_formatter str: A user-friendly formatter for the instance pool's instances. Instance hostnames follow the format. The formatter does not retroactively change instance's hostnames, only instance hostnames in the future follow the format
load_balancers Sequence[GetInstancePoolsInstancePoolLoadBalancer]: The load balancers attached to the instance pool.
placement_configurations Sequence[GetInstancePoolsInstancePoolPlacementConfiguration]: The placement configurations for the instance pool.
size int: The number of actual instances in the instance pool on the cloud. This attribute will be different when instance pool is used along with autoScaling Configuration.
state str: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
time_created str: The date and time the instance pool was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

actualSize Number
compartmentId String: The OCID of the compartment.
definedTags 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: A filter to return only resources that match the given display name exactly.
freeformTags 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 load balancer attachment.
instanceConfigurationId String: The OCID of the instance configuration associated with the instance pool.
instanceDisplayNameFormatter String: A user-friendly formatter for the instance pool's instances. Instance displaynames follow the format. The formatter does not retroactively change instance's displaynames, only instance displaynames in the future follow the format
instanceHostnameFormatter String: A user-friendly formatter for the instance pool's instances. Instance hostnames follow the format. The formatter does not retroactively change instance's hostnames, only instance hostnames in the future follow the format
loadBalancers List<Property Map>: The load balancers attached to the instance pool.
placementConfigurations List<Property Map>: The placement configurations for the instance pool.
size Number: The number of actual instances in the instance pool on the cloud. This attribute will be different when instance pool is used along with autoScaling Configuration.
state String: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
timeCreated String: The date and time the instance pool was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

GetInstancePoolsInstancePoolLoadBalancer

BackendSetName string: The name of the backend set on the load balancer.
Id string: The OCID of the load balancer attachment.
InstancePoolId string: The OCID of the instance pool of the load balancer attachment.
LoadBalancerId string: The OCID of the load balancer attached to the instance pool.
Port int: The port value used for the backends.
State string: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
VnicSelection string: Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. Possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool.

BackendSetName string: The name of the backend set on the load balancer.
Id string: The OCID of the load balancer attachment.
InstancePoolId string: The OCID of the instance pool of the load balancer attachment.
LoadBalancerId string: The OCID of the load balancer attached to the instance pool.
Port int: The port value used for the backends.
State string: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
VnicSelection string: Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. Possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool.

backendSetName String: The name of the backend set on the load balancer.
id String: The OCID of the load balancer attachment.
instancePoolId String: The OCID of the instance pool of the load balancer attachment.
loadBalancerId String: The OCID of the load balancer attached to the instance pool.
port Integer: The port value used for the backends.
state String: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
vnicSelection String: Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. Possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool.

backendSetName string: The name of the backend set on the load balancer.
id string: The OCID of the load balancer attachment.
instancePoolId string: The OCID of the instance pool of the load balancer attachment.
loadBalancerId string: The OCID of the load balancer attached to the instance pool.
port number: The port value used for the backends.
state string: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
vnicSelection string: Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. Possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool.

backend_set_name str: The name of the backend set on the load balancer.
id str: The OCID of the load balancer attachment.
instance_pool_id str: The OCID of the instance pool of the load balancer attachment.
load_balancer_id str: The OCID of the load balancer attached to the instance pool.
port int: The port value used for the backends.
state str: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
vnic_selection str: Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. Possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool.

backendSetName String: The name of the backend set on the load balancer.
id String: The OCID of the load balancer attachment.
instancePoolId String: The OCID of the instance pool of the load balancer attachment.
loadBalancerId String: The OCID of the load balancer attached to the instance pool.
port Number: The port value used for the backends.
state String: A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.
vnicSelection String: Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. Possible values are "PrimaryVnic" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool.

GetInstancePoolsInstancePoolPlacementConfiguration

AvailabilityDomain string: The availability domain to place instances. Example: Uocm:PHX-AD-1
FaultDomains List<string>: The fault domains to place instances.
PrimarySubnetId string: The OCID of the primary subnet to place instances. This field is deprecated. Use primaryVnicSubnets instead to set VNIC data for instances in the pool.
PrimaryVnicSubnets List<GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnet>: Details about the IPv6 primary subnet.
SecondaryVnicSubnets List<GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnet>: The set of secondary VNIC data for instances in the pool.

AvailabilityDomain string: The availability domain to place instances. Example: Uocm:PHX-AD-1
FaultDomains []string: The fault domains to place instances.
PrimarySubnetId string: The OCID of the primary subnet to place instances. This field is deprecated. Use primaryVnicSubnets instead to set VNIC data for instances in the pool.
PrimaryVnicSubnets []GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnet: Details about the IPv6 primary subnet.
SecondaryVnicSubnets []GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnet: The set of secondary VNIC data for instances in the pool.

availabilityDomain String: The availability domain to place instances. Example: Uocm:PHX-AD-1
faultDomains List<String>: The fault domains to place instances.
primarySubnetId String: The OCID of the primary subnet to place instances. This field is deprecated. Use primaryVnicSubnets instead to set VNIC data for instances in the pool.
primaryVnicSubnets List<GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnet>: Details about the IPv6 primary subnet.
secondaryVnicSubnets List<GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnet>: The set of secondary VNIC data for instances in the pool.

availabilityDomain string: The availability domain to place instances. Example: Uocm:PHX-AD-1
faultDomains string[]: The fault domains to place instances.
primarySubnetId string: The OCID of the primary subnet to place instances. This field is deprecated. Use primaryVnicSubnets instead to set VNIC data for instances in the pool.
primaryVnicSubnets GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnet[]: Details about the IPv6 primary subnet.
secondaryVnicSubnets GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnet[]: The set of secondary VNIC data for instances in the pool.

availability_domain str: The availability domain to place instances. Example: Uocm:PHX-AD-1
fault_domains Sequence[str]: The fault domains to place instances.
primary_subnet_id str: The OCID of the primary subnet to place instances. This field is deprecated. Use primaryVnicSubnets instead to set VNIC data for instances in the pool.
primary_vnic_subnets Sequence[GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnet]: Details about the IPv6 primary subnet.
secondary_vnic_subnets Sequence[GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnet]: The set of secondary VNIC data for instances in the pool.

availabilityDomain String: The availability domain to place instances. Example: Uocm:PHX-AD-1
faultDomains List<String>: The fault domains to place instances.
primarySubnetId String: The OCID of the primary subnet to place instances. This field is deprecated. Use primaryVnicSubnets instead to set VNIC data for instances in the pool.
primaryVnicSubnets List<Property Map>: Details about the IPv6 primary subnet.
secondaryVnicSubnets List<Property Map>: The set of secondary VNIC data for instances in the pool.

GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnet

Ipv6addressIpv6subnetCidrPairDetails List<GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail>: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
IsAssignIpv6ip bool: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
SubnetId string: The subnet OCID for the secondary VNIC.

Ipv6addressIpv6subnetCidrPairDetails []GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
IsAssignIpv6ip bool: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
SubnetId string: The subnet OCID for the secondary VNIC.

ipv6addressIpv6subnetCidrPairDetails List<GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail>: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
isAssignIpv6ip Boolean: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
subnetId String: The subnet OCID for the secondary VNIC.

ipv6addressIpv6subnetCidrPairDetails GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail[]: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
isAssignIpv6ip boolean: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
subnetId string: The subnet OCID for the secondary VNIC.

ipv6address_ipv6subnet_cidr_pair_details Sequence[GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail]: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
is_assign_ipv6ip bool: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
subnet_id str: The subnet OCID for the secondary VNIC.

ipv6addressIpv6subnetCidrPairDetails List<Property Map>: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
isAssignIpv6ip Boolean: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
subnetId String: The subnet OCID for the secondary VNIC.

GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail

Ipv6subnetCidr string: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

Ipv6subnetCidr string: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

ipv6subnetCidr String: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

ipv6subnetCidr string: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

ipv6subnet_cidr str: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

ipv6subnetCidr String: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnet

DisplayName string: A filter to return only resources that match the given display name exactly.
Ipv6addressIpv6subnetCidrPairDetails List<GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail>: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
IsAssignIpv6ip bool: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
SubnetId string: The subnet OCID for the secondary VNIC.

DisplayName string: A filter to return only resources that match the given display name exactly.
Ipv6addressIpv6subnetCidrPairDetails []GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
IsAssignIpv6ip bool: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
SubnetId string: The subnet OCID for the secondary VNIC.

displayName String: A filter to return only resources that match the given display name exactly.
ipv6addressIpv6subnetCidrPairDetails List<GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail>: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
isAssignIpv6ip Boolean: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
subnetId String: The subnet OCID for the secondary VNIC.

displayName string: A filter to return only resources that match the given display name exactly.
ipv6addressIpv6subnetCidrPairDetails GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail[]: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
isAssignIpv6ip boolean: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
subnetId string: The subnet OCID for the secondary VNIC.

display_name str: A filter to return only resources that match the given display name exactly.
ipv6address_ipv6subnet_cidr_pair_details Sequence[GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail]: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
is_assign_ipv6ip bool: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
subnet_id str: The subnet OCID for the secondary VNIC.

displayName String: A filter to return only resources that match the given display name exactly.
ipv6addressIpv6subnetCidrPairDetails List<Property Map>: A list of IPv6 prefix ranges from which the VNIC should be assigned an IPv6 address. You can provide only the prefix ranges and Oracle Cloud Infrastructure will select an available address from the range. You can optionally choose to leave the prefix range empty and instead provide the specific IPv6 address that should be used from within that range.
isAssignIpv6ip Boolean: Whether to allocate an IPv6 address at instance and VNIC creation from an IPv6 enabled subnet. Default: False. When provided you may optionally provide an IPv6 prefix (ipv6SubnetCidr) of your choice to assign the IPv6 address from. If ipv6SubnetCidr is not provided then an IPv6 prefix is chosen for you.
subnetId String: The subnet OCID for the secondary VNIC.

GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail

Ipv6subnetCidr string: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

Ipv6subnetCidr string: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

ipv6subnetCidr String: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

ipv6subnetCidr string: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

ipv6subnet_cidr str: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

ipv6subnetCidr String: Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

Package Details

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

Oracle Cloud Infrastructure v3.3.0 published on Thursday, Jul 17, 2025 by Pulumi

pulumi/pulumi-oci

oci.Core.getInstancePools

On this page

On this page

Example Usage

Using getInstancePools

getInstancePools Result

Supporting Types

GetInstancePoolsFilter

GetInstancePoolsInstancePool

GetInstancePoolsInstancePoolLoadBalancer

GetInstancePoolsInstancePoolPlacementConfiguration

GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnet

GetInstancePoolsInstancePoolPlacementConfigurationPrimaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail

GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnet

GetInstancePoolsInstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail

Package Details

On this page

On this page