InstancePool

Oracle Cloud Infrastructure v5.7.0, Nov 12 26

Viewing docs for Oracle Cloud Infrastructure v5.7.0
published on Thursday, Nov 12, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-oci

Viewing docs for Oracle Cloud Infrastructure v5.7.0
published on Thursday, Nov 12, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-oci

To determine whether capacity is available for a specific shape before you create an instance pool, use the CreateComputeCapacityReport operation. You can optionally include overridePolicy to define availability domain-scoped launch overrides for future launches. Existing pool members are not modified.

Example Usage

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

const testInstancePool = new oci.core.InstancePool("test_instance_pool", {
    compartmentId: compartmentId,
    instanceConfigurationId: testInstanceConfiguration.id,
    placementConfigurations: [{
        availabilityDomain: instancePoolPlacementConfigurationsAvailabilityDomain,
        computeClusterId: testComputeCluster.id,
        faultDomains: instancePoolPlacementConfigurationsFaultDomains,
        primarySubnetId: testSubnet.id,
        primaryVnicSubnets: {
            subnetId: testSubnet.id,
            ipv6addressIpv6subnetCidrPairDetails: [{
                ipv6subnetCidr: instancePoolPlacementConfigurationsPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr,
            }],
            isAssignIpv6ip: instancePoolPlacementConfigurationsPrimaryVnicSubnetsIsAssignIpv6ip,
        },
        secondaryVnicSubnets: [{
            subnetId: testSubnet.id,
            displayName: instancePoolPlacementConfigurationsSecondaryVnicSubnetsDisplayName,
            ipv6addressIpv6subnetCidrPairDetails: [{
                ipv6subnetCidr: instancePoolPlacementConfigurationsSecondaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr,
            }],
            isAssignIpv6ip: instancePoolPlacementConfigurationsSecondaryVnicSubnetsIsAssignIpv6ip,
        }],
    }],
    size: instancePoolSize,
    definedTags: {
        "Operations.CostCenter": "42",
    },
    displayName: instancePoolDisplayName,
    freeformTags: {
        Department: "Finance",
    },
    instanceDisplayNameFormatter: instancePoolInstanceDisplayNameFormatter,
    instanceHostnameFormatter: instancePoolInstanceHostnameFormatter,
    lifecycleManagement: {
        lifecycleActions: {
            preTermination: {
                isEnabled: instancePoolLifecycleManagementLifecycleActionsPreTerminationIsEnabled,
                onTimeout: {
                    preserveBlockVolumeMode: instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBlockVolumeMode,
                    preserveBootVolumeMode: instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBootVolumeMode,
                },
                timeout: instancePoolLifecycleManagementLifecycleActionsPreTerminationTimeout,
            },
        },
    },
    loadBalancers: [{
        backendSetName: testBackendSet.name,
        loadBalancerId: testLoadBalancer.id,
        port: instancePoolLoadBalancersPort,
        vnicSelection: instancePoolLoadBalancersVnicSelection,
    }],
    overridePolicy: {
        overrideStatements: [{
            name: instancePoolOverridePolicyOverrideStatementsName,
            overrideOptions: [{
                name: instancePoolOverridePolicyOverrideStatementsOverrideOptionsName,
                override: {
                    capacityReservationId: testCapacityReservation.id,
                    shape: instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShape,
                    shapeConfigDetails: {
                        baselineOcpuUtilization: instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsBaselineOcpuUtilization,
                        localVolumeSizeInGbs: instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsLocalVolumeSizeInGbs,
                        memoryInGbs: instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsMemoryInGbs,
                        nvmes: instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsNvmes,
                        ocpus: instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsOcpus,
                        resourceManagement: instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsResourceManagement,
                        vcpus: instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsVcpus,
                    },
                },
            }],
            selector: {
                availabilityDomain: instancePoolOverridePolicyOverrideStatementsSelectorAvailabilityDomain,
            },
        }],
    },
});

import pulumi
import pulumi_oci as oci

test_instance_pool = oci.core.InstancePool("test_instance_pool",
    compartment_id=compartment_id,
    instance_configuration_id=test_instance_configuration["id"],
    placement_configurations=[{
        "availability_domain": instance_pool_placement_configurations_availability_domain,
        "compute_cluster_id": test_compute_cluster["id"],
        "fault_domains": instance_pool_placement_configurations_fault_domains,
        "primary_subnet_id": test_subnet["id"],
        "primary_vnic_subnets": {
            "subnet_id": test_subnet["id"],
            "ipv6address_ipv6subnet_cidr_pair_details": [{
                "ipv6subnet_cidr": instance_pool_placement_configurations_primary_vnic_subnets_ipv6address_ipv6subnet_cidr_pair_details_ipv6subnet_cidr,
            }],
            "is_assign_ipv6ip": instance_pool_placement_configurations_primary_vnic_subnets_is_assign_ipv6ip,
        },
        "secondary_vnic_subnets": [{
            "subnet_id": test_subnet["id"],
            "display_name": instance_pool_placement_configurations_secondary_vnic_subnets_display_name,
            "ipv6address_ipv6subnet_cidr_pair_details": [{
                "ipv6subnet_cidr": instance_pool_placement_configurations_secondary_vnic_subnets_ipv6address_ipv6subnet_cidr_pair_details_ipv6subnet_cidr,
            }],
            "is_assign_ipv6ip": instance_pool_placement_configurations_secondary_vnic_subnets_is_assign_ipv6ip,
        }],
    }],
    size=instance_pool_size,
    defined_tags={
        "Operations.CostCenter": "42",
    },
    display_name=instance_pool_display_name,
    freeform_tags={
        "Department": "Finance",
    },
    instance_display_name_formatter=instance_pool_instance_display_name_formatter,
    instance_hostname_formatter=instance_pool_instance_hostname_formatter,
    lifecycle_management={
        "lifecycle_actions": {
            "pre_termination": {
                "is_enabled": instance_pool_lifecycle_management_lifecycle_actions_pre_termination_is_enabled,
                "on_timeout": {
                    "preserve_block_volume_mode": instance_pool_lifecycle_management_lifecycle_actions_pre_termination_on_timeout_preserve_block_volume_mode,
                    "preserve_boot_volume_mode": instance_pool_lifecycle_management_lifecycle_actions_pre_termination_on_timeout_preserve_boot_volume_mode,
                },
                "timeout": instance_pool_lifecycle_management_lifecycle_actions_pre_termination_timeout,
            },
        },
    },
    load_balancers=[{
        "backend_set_name": test_backend_set["name"],
        "load_balancer_id": test_load_balancer["id"],
        "port": instance_pool_load_balancers_port,
        "vnic_selection": instance_pool_load_balancers_vnic_selection,
    }],
    override_policy={
        "override_statements": [{
            "name": instance_pool_override_policy_override_statements_name,
            "override_options": [{
                "name": instance_pool_override_policy_override_statements_override_options_name,
                "override": {
                    "capacity_reservation_id": test_capacity_reservation["id"],
                    "shape": instance_pool_override_policy_override_statements_override_options_override_shape,
                    "shape_config_details": {
                        "baseline_ocpu_utilization": instance_pool_override_policy_override_statements_override_options_override_shape_config_details_baseline_ocpu_utilization,
                        "local_volume_size_in_gbs": instance_pool_override_policy_override_statements_override_options_override_shape_config_details_local_volume_size_in_gbs,
                        "memory_in_gbs": instance_pool_override_policy_override_statements_override_options_override_shape_config_details_memory_in_gbs,
                        "nvmes": instance_pool_override_policy_override_statements_override_options_override_shape_config_details_nvmes,
                        "ocpus": instance_pool_override_policy_override_statements_override_options_override_shape_config_details_ocpus,
                        "resource_management": instance_pool_override_policy_override_statements_override_options_override_shape_config_details_resource_management,
                        "vcpus": instance_pool_override_policy_override_statements_override_options_override_shape_config_details_vcpus,
                    },
                },
            }],
            "selector": {
                "availability_domain": instance_pool_override_policy_override_statements_selector_availability_domain,
            },
        }],
    })

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := core.NewInstancePool(ctx, "test_instance_pool", &core.InstancePoolArgs{
			CompartmentId:           pulumi.Any(compartmentId),
			InstanceConfigurationId: pulumi.Any(testInstanceConfiguration.Id),
			PlacementConfigurations: core.InstancePoolPlacementConfigurationArray{
				&core.InstancePoolPlacementConfigurationArgs{
					AvailabilityDomain: pulumi.Any(instancePoolPlacementConfigurationsAvailabilityDomain),
					ComputeClusterId:   pulumi.Any(testComputeCluster.Id),
					FaultDomains:       pulumi.Any(instancePoolPlacementConfigurationsFaultDomains),
					PrimarySubnetId:    pulumi.Any(testSubnet.Id),
					PrimaryVnicSubnets: &core.InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs{
						SubnetId: pulumi.Any(testSubnet.Id),
						Ipv6addressIpv6subnetCidrPairDetails: core.InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArray{
							&core.InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs{
								Ipv6subnetCidr: pulumi.Any(instancePoolPlacementConfigurationsPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr),
							},
						},
						IsAssignIpv6ip: pulumi.Any(instancePoolPlacementConfigurationsPrimaryVnicSubnetsIsAssignIpv6ip),
					},
					SecondaryVnicSubnets: core.InstancePoolPlacementConfigurationSecondaryVnicSubnetArray{
						&core.InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs{
							SubnetId:    pulumi.Any(testSubnet.Id),
							DisplayName: pulumi.Any(instancePoolPlacementConfigurationsSecondaryVnicSubnetsDisplayName),
							Ipv6addressIpv6subnetCidrPairDetails: core.InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArray{
								&core.InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs{
									Ipv6subnetCidr: pulumi.Any(instancePoolPlacementConfigurationsSecondaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr),
								},
							},
							IsAssignIpv6ip: pulumi.Any(instancePoolPlacementConfigurationsSecondaryVnicSubnetsIsAssignIpv6ip),
						},
					},
				},
			},
			Size: pulumi.Any(instancePoolSize),
			DefinedTags: pulumi.StringMap{
				"Operations.CostCenter": pulumi.String("42"),
			},
			DisplayName: pulumi.Any(instancePoolDisplayName),
			FreeformTags: pulumi.StringMap{
				"Department": pulumi.String("Finance"),
			},
			InstanceDisplayNameFormatter: pulumi.Any(instancePoolInstanceDisplayNameFormatter),
			InstanceHostnameFormatter:    pulumi.Any(instancePoolInstanceHostnameFormatter),
			LifecycleManagement: &core.InstancePoolLifecycleManagementArgs{
				LifecycleActions: &core.InstancePoolLifecycleManagementLifecycleActionsArgs{
					PreTermination: &core.InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs{
						IsEnabled: pulumi.Any(instancePoolLifecycleManagementLifecycleActionsPreTerminationIsEnabled),
						OnTimeout: &core.InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs{
							PreserveBlockVolumeMode: pulumi.Any(instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBlockVolumeMode),
							PreserveBootVolumeMode:  pulumi.Any(instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBootVolumeMode),
						},
						Timeout: pulumi.Any(instancePoolLifecycleManagementLifecycleActionsPreTerminationTimeout),
					},
				},
			},
			LoadBalancers: core.InstancePoolLoadBalancerArray{
				&core.InstancePoolLoadBalancerArgs{
					BackendSetName: pulumi.Any(testBackendSet.Name),
					LoadBalancerId: pulumi.Any(testLoadBalancer.Id),
					Port:           pulumi.Any(instancePoolLoadBalancersPort),
					VnicSelection:  pulumi.Any(instancePoolLoadBalancersVnicSelection),
				},
			},
			OverridePolicy: &core.InstancePoolOverridePolicyArgs{
				OverrideStatements: core.InstancePoolOverridePolicyOverrideStatementArray{
					&core.InstancePoolOverridePolicyOverrideStatementArgs{
						Name: instancePoolOverridePolicyOverrideStatementsName,
						OverrideOptions: core.InstancePoolOverridePolicyOverrideStatementOverrideOptionArray{
							&core.InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs{
								Name: pulumi.Any(instancePoolOverridePolicyOverrideStatementsOverrideOptionsName),
								Override: &core.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs{
									CapacityReservationId: pulumi.Any(testCapacityReservation.Id),
									Shape:                 pulumi.Any(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShape),
									ShapeConfigDetails: &core.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs{
										BaselineOcpuUtilization: pulumi.Any(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsBaselineOcpuUtilization),
										LocalVolumeSizeInGbs:    pulumi.Any(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsLocalVolumeSizeInGbs),
										MemoryInGbs:             pulumi.Any(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsMemoryInGbs),
										Nvmes:                   pulumi.Any(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsNvmes),
										Ocpus:                   pulumi.Any(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsOcpus),
										ResourceManagement:      pulumi.Any(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsResourceManagement),
										Vcpus:                   pulumi.Any(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsVcpus),
									},
								},
							},
						},
						Selector: &core.InstancePoolOverridePolicyOverrideStatementSelectorArgs{
							AvailabilityDomain: pulumi.Any(instancePoolOverridePolicyOverrideStatementsSelectorAvailabilityDomain),
						},
					},
				},
			},
		})
		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 testInstancePool = new Oci.Core.InstancePool("test_instance_pool", new()
    {
        CompartmentId = compartmentId,
        InstanceConfigurationId = testInstanceConfiguration.Id,
        PlacementConfigurations = new[]
        {
            new Oci.Core.Inputs.InstancePoolPlacementConfigurationArgs
            {
                AvailabilityDomain = instancePoolPlacementConfigurationsAvailabilityDomain,
                ComputeClusterId = testComputeCluster.Id,
                FaultDomains = instancePoolPlacementConfigurationsFaultDomains,
                PrimarySubnetId = testSubnet.Id,
                PrimaryVnicSubnets = new Oci.Core.Inputs.InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs
                {
                    SubnetId = testSubnet.Id,
                    Ipv6addressIpv6subnetCidrPairDetails = new[]
                    {
                        new Oci.Core.Inputs.InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs
                        {
                            Ipv6subnetCidr = instancePoolPlacementConfigurationsPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr,
                        },
                    },
                    IsAssignIpv6ip = instancePoolPlacementConfigurationsPrimaryVnicSubnetsIsAssignIpv6ip,
                },
                SecondaryVnicSubnets = new[]
                {
                    new Oci.Core.Inputs.InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs
                    {
                        SubnetId = testSubnet.Id,
                        DisplayName = instancePoolPlacementConfigurationsSecondaryVnicSubnetsDisplayName,
                        Ipv6addressIpv6subnetCidrPairDetails = new[]
                        {
                            new Oci.Core.Inputs.InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs
                            {
                                Ipv6subnetCidr = instancePoolPlacementConfigurationsSecondaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr,
                            },
                        },
                        IsAssignIpv6ip = instancePoolPlacementConfigurationsSecondaryVnicSubnetsIsAssignIpv6ip,
                    },
                },
            },
        },
        Size = instancePoolSize,
        DefinedTags = 
        {
            { "Operations.CostCenter", "42" },
        },
        DisplayName = instancePoolDisplayName,
        FreeformTags = 
        {
            { "Department", "Finance" },
        },
        InstanceDisplayNameFormatter = instancePoolInstanceDisplayNameFormatter,
        InstanceHostnameFormatter = instancePoolInstanceHostnameFormatter,
        LifecycleManagement = new Oci.Core.Inputs.InstancePoolLifecycleManagementArgs
        {
            LifecycleActions = new Oci.Core.Inputs.InstancePoolLifecycleManagementLifecycleActionsArgs
            {
                PreTermination = new Oci.Core.Inputs.InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs
                {
                    IsEnabled = instancePoolLifecycleManagementLifecycleActionsPreTerminationIsEnabled,
                    OnTimeout = new Oci.Core.Inputs.InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs
                    {
                        PreserveBlockVolumeMode = instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBlockVolumeMode,
                        PreserveBootVolumeMode = instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBootVolumeMode,
                    },
                    Timeout = instancePoolLifecycleManagementLifecycleActionsPreTerminationTimeout,
                },
            },
        },
        LoadBalancers = new[]
        {
            new Oci.Core.Inputs.InstancePoolLoadBalancerArgs
            {
                BackendSetName = testBackendSet.Name,
                LoadBalancerId = testLoadBalancer.Id,
                Port = instancePoolLoadBalancersPort,
                VnicSelection = instancePoolLoadBalancersVnicSelection,
            },
        },
        OverridePolicy = new Oci.Core.Inputs.InstancePoolOverridePolicyArgs
        {
            OverrideStatements = new[]
            {
                new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementArgs
                {
                    Name = instancePoolOverridePolicyOverrideStatementsName,
                    OverrideOptions = new[]
                    {
                        new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs
                        {
                            Name = instancePoolOverridePolicyOverrideStatementsOverrideOptionsName,
                            Override = new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs
                            {
                                CapacityReservationId = testCapacityReservation.Id,
                                Shape = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShape,
                                ShapeConfigDetails = new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs
                                {
                                    BaselineOcpuUtilization = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsBaselineOcpuUtilization,
                                    LocalVolumeSizeInGbs = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsLocalVolumeSizeInGbs,
                                    MemoryInGbs = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsMemoryInGbs,
                                    Nvmes = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsNvmes,
                                    Ocpus = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsOcpus,
                                    ResourceManagement = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsResourceManagement,
                                    Vcpus = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsVcpus,
                                },
                            },
                        },
                    },
                    Selector = new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementSelectorArgs
                    {
                        AvailabilityDomain = instancePoolOverridePolicyOverrideStatementsSelectorAvailabilityDomain,
                    },
                },
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.InstancePool;
import com.pulumi.oci.Core.InstancePoolArgs;
import com.pulumi.oci.Core.inputs.InstancePoolPlacementConfigurationArgs;
import com.pulumi.oci.Core.inputs.InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs;
import com.pulumi.oci.Core.inputs.InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs;
import com.pulumi.oci.Core.inputs.InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs;
import com.pulumi.oci.Core.inputs.InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs;
import com.pulumi.oci.Core.inputs.InstancePoolLifecycleManagementArgs;
import com.pulumi.oci.Core.inputs.InstancePoolLifecycleManagementLifecycleActionsArgs;
import com.pulumi.oci.Core.inputs.InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs;
import com.pulumi.oci.Core.inputs.InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs;
import com.pulumi.oci.Core.inputs.InstancePoolLoadBalancerArgs;
import com.pulumi.oci.Core.inputs.InstancePoolOverridePolicyArgs;
import com.pulumi.oci.Core.inputs.InstancePoolOverridePolicyOverrideStatementArgs;
import com.pulumi.oci.Core.inputs.InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs;
import com.pulumi.oci.Core.inputs.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs;
import com.pulumi.oci.Core.inputs.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs;
import com.pulumi.oci.Core.inputs.InstancePoolOverridePolicyOverrideStatementSelectorArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 testInstancePool = new InstancePool("testInstancePool", InstancePoolArgs.builder()
            .compartmentId(compartmentId)
            .instanceConfigurationId(testInstanceConfiguration.get("id"))
            .placementConfigurations(InstancePoolPlacementConfigurationArgs.builder()
                .availabilityDomain(instancePoolPlacementConfigurationsAvailabilityDomain)
                .computeClusterId(testComputeCluster.get("id"))
                .faultDomains(instancePoolPlacementConfigurationsFaultDomains)
                .primarySubnetId(testSubnet.get("id"))
                .primaryVnicSubnets(InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs.builder()
                    .subnetId(testSubnet.get("id"))
                    .ipv6addressIpv6subnetCidrPairDetails(InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs.builder()
                        .ipv6subnetCidr(instancePoolPlacementConfigurationsPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr)
                        .build())
                    .isAssignIpv6ip(instancePoolPlacementConfigurationsPrimaryVnicSubnetsIsAssignIpv6ip)
                    .build())
                .secondaryVnicSubnets(InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs.builder()
                    .subnetId(testSubnet.get("id"))
                    .displayName(instancePoolPlacementConfigurationsSecondaryVnicSubnetsDisplayName)
                    .ipv6addressIpv6subnetCidrPairDetails(InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs.builder()
                        .ipv6subnetCidr(instancePoolPlacementConfigurationsSecondaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr)
                        .build())
                    .isAssignIpv6ip(instancePoolPlacementConfigurationsSecondaryVnicSubnetsIsAssignIpv6ip)
                    .build())
                .build())
            .size(instancePoolSize)
            .definedTags(Map.of("Operations.CostCenter", "42"))
            .displayName(instancePoolDisplayName)
            .freeformTags(Map.of("Department", "Finance"))
            .instanceDisplayNameFormatter(instancePoolInstanceDisplayNameFormatter)
            .instanceHostnameFormatter(instancePoolInstanceHostnameFormatter)
            .lifecycleManagement(InstancePoolLifecycleManagementArgs.builder()
                .lifecycleActions(InstancePoolLifecycleManagementLifecycleActionsArgs.builder()
                    .preTermination(InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs.builder()
                        .isEnabled(instancePoolLifecycleManagementLifecycleActionsPreTerminationIsEnabled)
                        .onTimeout(InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs.builder()
                            .preserveBlockVolumeMode(instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBlockVolumeMode)
                            .preserveBootVolumeMode(instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBootVolumeMode)
                            .build())
                        .timeout(instancePoolLifecycleManagementLifecycleActionsPreTerminationTimeout)
                        .build())
                    .build())
                .build())
            .loadBalancers(InstancePoolLoadBalancerArgs.builder()
                .backendSetName(testBackendSet.get("name"))
                .loadBalancerId(testLoadBalancer.get("id"))
                .port(instancePoolLoadBalancersPort)
                .vnicSelection(instancePoolLoadBalancersVnicSelection)
                .build())
            .overridePolicy(InstancePoolOverridePolicyArgs.builder()
                .overrideStatements(InstancePoolOverridePolicyOverrideStatementArgs.builder()
                    .name(instancePoolOverridePolicyOverrideStatementsName)
                    .overrideOptions(InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs.builder()
                        .name(instancePoolOverridePolicyOverrideStatementsOverrideOptionsName)
                        .override(InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs.builder()
                            .capacityReservationId(testCapacityReservation.get("id"))
                            .shape(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShape)
                            .shapeConfigDetails(InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs.builder()
                                .baselineOcpuUtilization(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsBaselineOcpuUtilization)
                                .localVolumeSizeInGbs(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsLocalVolumeSizeInGbs)
                                .memoryInGbs(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsMemoryInGbs)
                                .nvmes(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsNvmes)
                                .ocpus(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsOcpus)
                                .resourceManagement(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsResourceManagement)
                                .vcpus(instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsVcpus)
                                .build())
                            .build())
                        .build())
                    .selector(InstancePoolOverridePolicyOverrideStatementSelectorArgs.builder()
                        .availabilityDomain(instancePoolOverridePolicyOverrideStatementsSelectorAvailabilityDomain)
                        .build())
                    .build())
                .build())
            .build());

    }
}

resources:
  testInstancePool:
    type: oci:Core:InstancePool
    name: test_instance_pool
    properties:
      compartmentId: ${compartmentId}
      instanceConfigurationId: ${testInstanceConfiguration.id}
      placementConfigurations:
        - availabilityDomain: ${instancePoolPlacementConfigurationsAvailabilityDomain}
          computeClusterId: ${testComputeCluster.id}
          faultDomains: ${instancePoolPlacementConfigurationsFaultDomains}
          primarySubnetId: ${testSubnet.id}
          primaryVnicSubnets:
            subnetId: ${testSubnet.id}
            ipv6addressIpv6subnetCidrPairDetails:
              - ipv6subnetCidr: ${instancePoolPlacementConfigurationsPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr}
            isAssignIpv6ip: ${instancePoolPlacementConfigurationsPrimaryVnicSubnetsIsAssignIpv6ip}
          secondaryVnicSubnets:
            - subnetId: ${testSubnet.id}
              displayName: ${instancePoolPlacementConfigurationsSecondaryVnicSubnetsDisplayName}
              ipv6addressIpv6subnetCidrPairDetails:
                - ipv6subnetCidr: ${instancePoolPlacementConfigurationsSecondaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr}
              isAssignIpv6ip: ${instancePoolPlacementConfigurationsSecondaryVnicSubnetsIsAssignIpv6ip}
      size: ${instancePoolSize}
      definedTags:
        Operations.CostCenter: '42'
      displayName: ${instancePoolDisplayName}
      freeformTags:
        Department: Finance
      instanceDisplayNameFormatter: ${instancePoolInstanceDisplayNameFormatter}
      instanceHostnameFormatter: ${instancePoolInstanceHostnameFormatter}
      lifecycleManagement:
        lifecycleActions:
          preTermination:
            isEnabled: ${instancePoolLifecycleManagementLifecycleActionsPreTerminationIsEnabled}
            onTimeout:
              preserveBlockVolumeMode: ${instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBlockVolumeMode}
              preserveBootVolumeMode: ${instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBootVolumeMode}
            timeout: ${instancePoolLifecycleManagementLifecycleActionsPreTerminationTimeout}
      loadBalancers:
        - backendSetName: ${testBackendSet.name}
          loadBalancerId: ${testLoadBalancer.id}
          port: ${instancePoolLoadBalancersPort}
          vnicSelection: ${instancePoolLoadBalancersVnicSelection}
      overridePolicy:
        overrideStatements:
          - name: ${instancePoolOverridePolicyOverrideStatementsName}
            overrideOptions:
              - name: ${instancePoolOverridePolicyOverrideStatementsOverrideOptionsName}
                override:
                  capacityReservationId: ${testCapacityReservation.id}
                  shape: ${instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShape}
                  shapeConfigDetails:
                    baselineOcpuUtilization: ${instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsBaselineOcpuUtilization}
                    localVolumeSizeInGbs: ${instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsLocalVolumeSizeInGbs}
                    memoryInGbs: ${instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsMemoryInGbs}
                    nvmes: ${instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsNvmes}
                    ocpus: ${instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsOcpus}
                    resourceManagement: ${instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsResourceManagement}
                    vcpus: ${instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsVcpus}
            selector:
              availabilityDomain: ${instancePoolOverridePolicyOverrideStatementsSelectorAvailabilityDomain}

terraform {
  required_providers {
    oci = {
      source = "pulumi/oci"
    }
  }
}

resource "oci_core_instance_pool" "test_instance_pool" {
  lifecycle {
    create_before_destroy = true
  }
  compartment_id            = compartmentId
  instance_configuration_id = testInstanceConfiguration.id
  placement_configurations {
    availability_domain = instancePoolPlacementConfigurationsAvailabilityDomain
    compute_cluster_id  = testComputeCluster.id
    fault_domains       = instancePoolPlacementConfigurationsFaultDomains
    primary_subnet_id   = testSubnet.id
    primary_vnic_subnets {
      subnet_id = testSubnet.id
      ipv6address_ipv6subnet_cidr_pair_details {
        ipv6subnet_cidr = instancePoolPlacementConfigurationsPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr
      }
      is_assign_ipv6ip = instancePoolPlacementConfigurationsPrimaryVnicSubnetsIsAssignIpv6ip
    }
    secondary_vnic_subnets {
      subnet_id    = testSubnet.id
      display_name = instancePoolPlacementConfigurationsSecondaryVnicSubnetsDisplayName
      ipv6address_ipv6subnet_cidr_pair_details {
        ipv6subnet_cidr = instancePoolPlacementConfigurationsSecondaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr
      }
      is_assign_ipv6ip = instancePoolPlacementConfigurationsSecondaryVnicSubnetsIsAssignIpv6ip
    }
  }
  #Required
  #Optional
  #Required
  #Optional
  #Required
  #Optional
  #Optional
  size = instancePoolSize
  defined_tags = {
    "Operations.CostCenter" = "42"
  }
  display_name = instancePoolDisplayName
  freeform_tags = {
    "Department" = "Finance"
  }
  instance_display_name_formatter = instancePoolInstanceDisplayNameFormatter
  instance_hostname_formatter     = instancePoolInstanceHostnameFormatter
  lifecycle_management {
    lifecycle_actions {
      pre_termination {
        is_enabled = instancePoolLifecycleManagementLifecycleActionsPreTerminationIsEnabled
        on_timeout {
          preserve_block_volume_mode = instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBlockVolumeMode
          preserve_boot_volume_mode  = instancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutPreserveBootVolumeMode
        }
        timeout = instancePoolLifecycleManagementLifecycleActionsPreTerminationTimeout
      }
    }
  }
  #Required
  #Required
  load_balancers {
    backend_set_name = testBackendSet.name
    load_balancer_id = testLoadBalancer.id
    port             = instancePoolLoadBalancersPort
    vnic_selection   = instancePoolLoadBalancersVnicSelection
  }
  #Required
  override_policy {
    override_statements {
      name = instancePoolOverridePolicyOverrideStatementsName
      override_options {
        name = instancePoolOverridePolicyOverrideStatementsOverrideOptionsName
        override {
          capacity_reservation_id = testCapacityReservation.id
          shape                   = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShape
          shape_config_details {
            baseline_ocpu_utilization = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsBaselineOcpuUtilization
            local_volume_size_in_gbs  = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsLocalVolumeSizeInGbs
            memory_in_gbs             = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsMemoryInGbs
            nvmes                     = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsNvmes
            ocpus                     = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsOcpus
            resource_management       = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsResourceManagement
            vcpus                     = instancePoolOverridePolicyOverrideStatementsOverrideOptionsOverrideShapeConfigDetailsVcpus
          }
        }
      }
      selector {
        availability_domain = instancePoolOverridePolicyOverrideStatementsSelectorAvailabilityDomain
      }
    }
  }
}

Create InstancePool Resource

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

Constructor syntax

new InstancePool(name: string, args: InstancePoolArgs, opts?: CustomResourceOptions);

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

@overload
def InstancePool(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 instance_configuration_id: Optional[str] = None,
                 size: Optional[int] = None,
                 placement_configurations: Optional[Sequence[InstancePoolPlacementConfigurationArgs]] = None,
                 compartment_id: Optional[str] = None,
                 instance_hostname_formatter: Optional[str] = None,
                 instance_display_name_formatter: Optional[str] = None,
                 freeform_tags: Optional[Mapping[str, str]] = None,
                 lifecycle_management: Optional[InstancePoolLifecycleManagementArgs] = None,
                 load_balancers: Optional[Sequence[InstancePoolLoadBalancerArgs]] = None,
                 override_policy: Optional[InstancePoolOverridePolicyArgs] = None,
                 display_name: Optional[str] = None,
                 defined_tags: Optional[Mapping[str, str]] = None,
                 state: Optional[str] = None)

func NewInstancePool(ctx *Context, name string, args InstancePoolArgs, opts ...ResourceOption) (*InstancePool, error)

public InstancePool(string name, InstancePoolArgs args, CustomResourceOptions? opts = null)

public InstancePool(String name, InstancePoolArgs args)
public InstancePool(String name, InstancePoolArgs args, CustomResourceOptions options)

type: oci:Core:InstancePool
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

resource "oci_core_instance_pool" "name" {
    # resource properties
}

Parameters

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

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

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

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

name String: The unique name of the resource.
args InstancePoolArgs: 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 instancePoolResource = new Oci.Core.InstancePool("instancePoolResource", new()
{
    InstanceConfigurationId = "string",
    Size = 0,
    PlacementConfigurations = new[]
    {
        new Oci.Core.Inputs.InstancePoolPlacementConfigurationArgs
        {
            AvailabilityDomain = "string",
            ComputeClusterId = "string",
            FaultDomains = new[]
            {
                "string",
            },
            PrimarySubnetId = "string",
            PrimaryVnicSubnets = new Oci.Core.Inputs.InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs
            {
                SubnetId = "string",
                Ipv6addressIpv6subnetCidrPairDetails = new[]
                {
                    new Oci.Core.Inputs.InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs
                    {
                        Ipv6subnetCidr = "string",
                    },
                },
                IsAssignIpv6ip = false,
            },
            SecondaryVnicSubnets = new[]
            {
                new Oci.Core.Inputs.InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs
                {
                    SubnetId = "string",
                    DisplayName = "string",
                    Ipv6addressIpv6subnetCidrPairDetails = new[]
                    {
                        new Oci.Core.Inputs.InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs
                        {
                            Ipv6subnetCidr = "string",
                        },
                    },
                    IsAssignIpv6ip = false,
                },
            },
        },
    },
    CompartmentId = "string",
    InstanceHostnameFormatter = "string",
    InstanceDisplayNameFormatter = "string",
    FreeformTags = 
    {
        { "string", "string" },
    },
    LifecycleManagement = new Oci.Core.Inputs.InstancePoolLifecycleManagementArgs
    {
        LifecycleActions = new Oci.Core.Inputs.InstancePoolLifecycleManagementLifecycleActionsArgs
        {
            PreTermination = new Oci.Core.Inputs.InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs
            {
                IsEnabled = false,
                OnTimeout = new Oci.Core.Inputs.InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs
                {
                    PreserveBlockVolumeMode = "string",
                    PreserveBootVolumeMode = "string",
                },
                Timeout = 0,
            },
        },
    },
    LoadBalancers = new[]
    {
        new Oci.Core.Inputs.InstancePoolLoadBalancerArgs
        {
            BackendSetName = "string",
            LoadBalancerId = "string",
            Port = 0,
            VnicSelection = "string",
            Id = "string",
            InstancePoolId = "string",
            State = "string",
        },
    },
    OverridePolicy = new Oci.Core.Inputs.InstancePoolOverridePolicyArgs
    {
        OverrideStatements = new[]
        {
            new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementArgs
            {
                OverrideOptions = new[]
                {
                    new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs
                    {
                        Name = "string",
                        Override = new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs
                        {
                            CapacityReservationId = "string",
                            Shape = "string",
                            ShapeConfigDetails = new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs
                            {
                                BaselineOcpuUtilization = "string",
                                LocalVolumeSizeInGbs = 0,
                                MemoryInGbs = 0.0,
                                Nvmes = 0,
                                Ocpus = 0.0,
                                ResourceManagement = "string",
                                Vcpus = 0,
                            },
                        },
                    },
                },
                Selector = new Oci.Core.Inputs.InstancePoolOverridePolicyOverrideStatementSelectorArgs
                {
                    AvailabilityDomain = "string",
                },
            },
        },
    },
    DisplayName = "string",
    DefinedTags = 
    {
        { "string", "string" },
    },
    State = "string",
});

example, err := core.NewInstancePool(ctx, "instancePoolResource", &core.InstancePoolArgs{
	InstanceConfigurationId: pulumi.String("string"),
	Size:                    pulumi.Int(0),
	PlacementConfigurations: core.InstancePoolPlacementConfigurationArray{
		&core.InstancePoolPlacementConfigurationArgs{
			AvailabilityDomain: pulumi.String("string"),
			ComputeClusterId:   pulumi.String("string"),
			FaultDomains: pulumi.StringArray{
				pulumi.String("string"),
			},
			PrimarySubnetId: pulumi.String("string"),
			PrimaryVnicSubnets: &core.InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs{
				SubnetId: pulumi.String("string"),
				Ipv6addressIpv6subnetCidrPairDetails: core.InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArray{
					&core.InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs{
						Ipv6subnetCidr: pulumi.String("string"),
					},
				},
				IsAssignIpv6ip: pulumi.Bool(false),
			},
			SecondaryVnicSubnets: core.InstancePoolPlacementConfigurationSecondaryVnicSubnetArray{
				&core.InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs{
					SubnetId:    pulumi.String("string"),
					DisplayName: pulumi.String("string"),
					Ipv6addressIpv6subnetCidrPairDetails: core.InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArray{
						&core.InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs{
							Ipv6subnetCidr: pulumi.String("string"),
						},
					},
					IsAssignIpv6ip: pulumi.Bool(false),
				},
			},
		},
	},
	CompartmentId:                pulumi.String("string"),
	InstanceHostnameFormatter:    pulumi.String("string"),
	InstanceDisplayNameFormatter: pulumi.String("string"),
	FreeformTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	LifecycleManagement: &core.InstancePoolLifecycleManagementArgs{
		LifecycleActions: &core.InstancePoolLifecycleManagementLifecycleActionsArgs{
			PreTermination: &core.InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs{
				IsEnabled: pulumi.Bool(false),
				OnTimeout: &core.InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs{
					PreserveBlockVolumeMode: pulumi.String("string"),
					PreserveBootVolumeMode:  pulumi.String("string"),
				},
				Timeout: pulumi.Int(0),
			},
		},
	},
	LoadBalancers: core.InstancePoolLoadBalancerArray{
		&core.InstancePoolLoadBalancerArgs{
			BackendSetName: pulumi.String("string"),
			LoadBalancerId: pulumi.String("string"),
			Port:           pulumi.Int(0),
			VnicSelection:  pulumi.String("string"),
			Id:             pulumi.String("string"),
			InstancePoolId: pulumi.String("string"),
			State:          pulumi.String("string"),
		},
	},
	OverridePolicy: &core.InstancePoolOverridePolicyArgs{
		OverrideStatements: core.InstancePoolOverridePolicyOverrideStatementArray{
			&core.InstancePoolOverridePolicyOverrideStatementArgs{
				OverrideOptions: core.InstancePoolOverridePolicyOverrideStatementOverrideOptionArray{
					&core.InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs{
						Name: pulumi.String("string"),
						Override: &core.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs{
							CapacityReservationId: pulumi.String("string"),
							Shape:                 pulumi.String("string"),
							ShapeConfigDetails: &core.InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs{
								BaselineOcpuUtilization: pulumi.String("string"),
								LocalVolumeSizeInGbs:    pulumi.Int(0),
								MemoryInGbs:             pulumi.Float64(0),
								Nvmes:                   pulumi.Int(0),
								Ocpus:                   pulumi.Float64(0),
								ResourceManagement:      pulumi.String("string"),
								Vcpus:                   pulumi.Int(0),
							},
						},
					},
				},
				Selector: &core.InstancePoolOverridePolicyOverrideStatementSelectorArgs{
					AvailabilityDomain: pulumi.String("string"),
				},
			},
		},
	},
	DisplayName: pulumi.String("string"),
	DefinedTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	State: pulumi.String("string"),
})

resource "oci_core_instance_pool" "instancePoolResource" {
  lifecycle {
    create_before_destroy = true
  }
  instance_configuration_id = "string"
  size                      = 0
  placement_configurations {
    availability_domain = "string"
    compute_cluster_id  = "string"
    fault_domains       = ["string"]
    primary_subnet_id   = "string"
    primary_vnic_subnets = {
      subnet_id = "string"
      ipv6address_ipv6subnet_cidr_pair_details = [{
        ipv6subnet_cidr = "string"
      }]
      is_assign_ipv6ip = false
    }
    secondary_vnic_subnets {
      subnet_id    = "string"
      display_name = "string"
      ipv6address_ipv6subnet_cidr_pair_details {
        ipv6subnet_cidr = "string"
      }
      is_assign_ipv6ip = false
    }
  }
  compartment_id                  = "string"
  instance_hostname_formatter     = "string"
  instance_display_name_formatter = "string"
  freeform_tags = {
    "string" = "string"
  }
  lifecycle_management = {
    lifecycle_actions = {
      pre_termination = {
        is_enabled = false
        on_timeout = {
          preserve_block_volume_mode = "string"
          preserve_boot_volume_mode  = "string"
        }
        timeout = 0
      }
    }
  }
  load_balancers {
    backend_set_name = "string"
    load_balancer_id = "string"
    port             = 0
    vnic_selection   = "string"
    id               = "string"
    instance_pool_id = "string"
    state            = "string"
  }
  override_policy = {
    override_statements = [{
      override_options = [{
        name = "string"
        override = {
          capacity_reservation_id = "string"
          shape                   = "string"
          shape_config_details = {
            baseline_ocpu_utilization = "string"
            local_volume_size_in_gbs  = 0
            memory_in_gbs             = 0
            nvmes                     = 0
            ocpus                     = 0
            resource_management       = "string"
            vcpus                     = 0
          }
        }
      }]
      selector = {
        availability_domain = "string"
      }
    }]
  }
  display_name = "string"
  defined_tags = {
    "string" = "string"
  }
  state = "string"
}

var instancePoolResource = new InstancePool("instancePoolResource", InstancePoolArgs.builder()
    .instanceConfigurationId("string")
    .size(0)
    .placementConfigurations(InstancePoolPlacementConfigurationArgs.builder()
        .availabilityDomain("string")
        .computeClusterId("string")
        .faultDomains("string")
        .primarySubnetId("string")
        .primaryVnicSubnets(InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs.builder()
            .subnetId("string")
            .ipv6addressIpv6subnetCidrPairDetails(InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs.builder()
                .ipv6subnetCidr("string")
                .build())
            .isAssignIpv6ip(false)
            .build())
        .secondaryVnicSubnets(InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs.builder()
            .subnetId("string")
            .displayName("string")
            .ipv6addressIpv6subnetCidrPairDetails(InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs.builder()
                .ipv6subnetCidr("string")
                .build())
            .isAssignIpv6ip(false)
            .build())
        .build())
    .compartmentId("string")
    .instanceHostnameFormatter("string")
    .instanceDisplayNameFormatter("string")
    .freeformTags(Map.of("string", "string"))
    .lifecycleManagement(InstancePoolLifecycleManagementArgs.builder()
        .lifecycleActions(InstancePoolLifecycleManagementLifecycleActionsArgs.builder()
            .preTermination(InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs.builder()
                .isEnabled(false)
                .onTimeout(InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs.builder()
                    .preserveBlockVolumeMode("string")
                    .preserveBootVolumeMode("string")
                    .build())
                .timeout(0)
                .build())
            .build())
        .build())
    .loadBalancers(InstancePoolLoadBalancerArgs.builder()
        .backendSetName("string")
        .loadBalancerId("string")
        .port(0)
        .vnicSelection("string")
        .id("string")
        .instancePoolId("string")
        .state("string")
        .build())
    .overridePolicy(InstancePoolOverridePolicyArgs.builder()
        .overrideStatements(InstancePoolOverridePolicyOverrideStatementArgs.builder()
            .overrideOptions(InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs.builder()
                .name("string")
                .override(InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs.builder()
                    .capacityReservationId("string")
                    .shape("string")
                    .shapeConfigDetails(InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs.builder()
                        .baselineOcpuUtilization("string")
                        .localVolumeSizeInGbs(0)
                        .memoryInGbs(0.0)
                        .nvmes(0)
                        .ocpus(0.0)
                        .resourceManagement("string")
                        .vcpus(0)
                        .build())
                    .build())
                .build())
            .selector(InstancePoolOverridePolicyOverrideStatementSelectorArgs.builder()
                .availabilityDomain("string")
                .build())
            .build())
        .build())
    .displayName("string")
    .definedTags(Map.of("string", "string"))
    .state("string")
    .build());

instance_pool_resource = oci.core.InstancePool("instancePoolResource",
    instance_configuration_id="string",
    size=0,
    placement_configurations=[{
        "availability_domain": "string",
        "compute_cluster_id": "string",
        "fault_domains": ["string"],
        "primary_subnet_id": "string",
        "primary_vnic_subnets": {
            "subnet_id": "string",
            "ipv6address_ipv6subnet_cidr_pair_details": [{
                "ipv6subnet_cidr": "string",
            }],
            "is_assign_ipv6ip": False,
        },
        "secondary_vnic_subnets": [{
            "subnet_id": "string",
            "display_name": "string",
            "ipv6address_ipv6subnet_cidr_pair_details": [{
                "ipv6subnet_cidr": "string",
            }],
            "is_assign_ipv6ip": False,
        }],
    }],
    compartment_id="string",
    instance_hostname_formatter="string",
    instance_display_name_formatter="string",
    freeform_tags={
        "string": "string",
    },
    lifecycle_management={
        "lifecycle_actions": {
            "pre_termination": {
                "is_enabled": False,
                "on_timeout": {
                    "preserve_block_volume_mode": "string",
                    "preserve_boot_volume_mode": "string",
                },
                "timeout": 0,
            },
        },
    },
    load_balancers=[{
        "backend_set_name": "string",
        "load_balancer_id": "string",
        "port": 0,
        "vnic_selection": "string",
        "id": "string",
        "instance_pool_id": "string",
        "state": "string",
    }],
    override_policy={
        "override_statements": [{
            "override_options": [{
                "name": "string",
                "override": {
                    "capacity_reservation_id": "string",
                    "shape": "string",
                    "shape_config_details": {
                        "baseline_ocpu_utilization": "string",
                        "local_volume_size_in_gbs": 0,
                        "memory_in_gbs": float(0),
                        "nvmes": 0,
                        "ocpus": float(0),
                        "resource_management": "string",
                        "vcpus": 0,
                    },
                },
            }],
            "selector": {
                "availability_domain": "string",
            },
        }],
    },
    display_name="string",
    defined_tags={
        "string": "string",
    },
    state="string")

const instancePoolResource = new oci.core.InstancePool("instancePoolResource", {
    instanceConfigurationId: "string",
    size: 0,
    placementConfigurations: [{
        availabilityDomain: "string",
        computeClusterId: "string",
        faultDomains: ["string"],
        primarySubnetId: "string",
        primaryVnicSubnets: {
            subnetId: "string",
            ipv6addressIpv6subnetCidrPairDetails: [{
                ipv6subnetCidr: "string",
            }],
            isAssignIpv6ip: false,
        },
        secondaryVnicSubnets: [{
            subnetId: "string",
            displayName: "string",
            ipv6addressIpv6subnetCidrPairDetails: [{
                ipv6subnetCidr: "string",
            }],
            isAssignIpv6ip: false,
        }],
    }],
    compartmentId: "string",
    instanceHostnameFormatter: "string",
    instanceDisplayNameFormatter: "string",
    freeformTags: {
        string: "string",
    },
    lifecycleManagement: {
        lifecycleActions: {
            preTermination: {
                isEnabled: false,
                onTimeout: {
                    preserveBlockVolumeMode: "string",
                    preserveBootVolumeMode: "string",
                },
                timeout: 0,
            },
        },
    },
    loadBalancers: [{
        backendSetName: "string",
        loadBalancerId: "string",
        port: 0,
        vnicSelection: "string",
        id: "string",
        instancePoolId: "string",
        state: "string",
    }],
    overridePolicy: {
        overrideStatements: [{
            overrideOptions: [{
                name: "string",
                override: {
                    capacityReservationId: "string",
                    shape: "string",
                    shapeConfigDetails: {
                        baselineOcpuUtilization: "string",
                        localVolumeSizeInGbs: 0,
                        memoryInGbs: 0,
                        nvmes: 0,
                        ocpus: 0,
                        resourceManagement: "string",
                        vcpus: 0,
                    },
                },
            }],
            selector: {
                availabilityDomain: "string",
            },
        }],
    },
    displayName: "string",
    definedTags: {
        string: "string",
    },
    state: "string",
});

type: oci:Core:InstancePool
properties:
    compartmentId: string
    definedTags:
        string: string
    displayName: string
    freeformTags:
        string: string
    instanceConfigurationId: string
    instanceDisplayNameFormatter: string
    instanceHostnameFormatter: string
    lifecycleManagement:
        lifecycleActions:
            preTermination:
                isEnabled: false
                onTimeout:
                    preserveBlockVolumeMode: string
                    preserveBootVolumeMode: string
                timeout: 0
    loadBalancers:
        - backendSetName: string
          id: string
          instancePoolId: string
          loadBalancerId: string
          port: 0
          state: string
          vnicSelection: string
    overridePolicy:
        overrideStatements:
            - overrideOptions:
                - name: string
                  override:
                    capacityReservationId: string
                    shape: string
                    shapeConfigDetails:
                        baselineOcpuUtilization: string
                        localVolumeSizeInGbs: 0
                        memoryInGbs: 0
                        nvmes: 0
                        ocpus: 0
                        resourceManagement: string
                        vcpus: 0
              selector:
                availabilityDomain: string
    placementConfigurations:
        - availabilityDomain: string
          computeClusterId: string
          faultDomains:
            - string
          primarySubnetId: string
          primaryVnicSubnets:
            ipv6addressIpv6subnetCidrPairDetails:
                - ipv6subnetCidr: string
            isAssignIpv6ip: false
            subnetId: string
          secondaryVnicSubnets:
            - displayName: string
              ipv6addressIpv6subnetCidrPairDetails:
                - ipv6subnetCidr: string
              isAssignIpv6ip: false
              subnetId: string
    size: 0
    state: string

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

CompartmentId string

(Updatable) The OCID of the compartment containing the instance pool.

InstanceConfigurationId string

(Updatable) The OCID of the instance configuration associated with the instance pool.

PlacementConfigurations List<InstancePoolPlacementConfiguration>

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

To use the instance pool with a regional subnet, provide a placement configuration for each availability domain, and include the regional subnet in each placement configuration. To use compute cluster with instance pool, provide a single placement configuration.

Size int

(Updatable) The number of instances that should be in the instance pool. Modifying this value will override the size of the instance pool. If the instance pool is linked with autoscaling configuration, autoscaling configuration could resize the instance pool at a later point. The instance pool's actual size may differ from the configured size if it is associated with an autoscaling configuration, instance pool's actual size will be reflected in this size attribute. For a GMC-enabled resource pool, this is the number of GMC resources that should be in the 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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

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"}

InstanceDisplayNameFormatter string

(Updatable) 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

(Updatable) 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

LifecycleManagement InstancePoolLifecycleManagement

(Updatable) The lifecycle management options for the instance pool.

LoadBalancers List<InstancePoolLoadBalancer>

The load balancers to attach to the instance pool. (Note: From 6.16.0 loadBalancers field in oci.Core.InstancePool is changed from TypeList to TypeSet - to support load balancer insert operation. Also, LB cant by accessed by index)

OverridePolicy InstancePoolOverridePolicy

(Updatable) Optional pool-level launch override policy for future instance launches.

The policy is evaluated only after placement is resolved for a launch. In V1, provide between 1 and 3 availability domain-scoped statements and no more than one statement for the same availability domain.

For a matched availability domain, request order defines the canonical override candidate sequence. Preferred-candidate reuse may try one current option once as a fast path. If that fast path misses, canonical evaluation restarts from option 1. During canonical evaluation, the worker advances to the next option only for out-of-host-capacity, LimitExceeded, and QuotaExceeded, and only after same-option retries are exhausted. Other failures are terminal for that launch attempt.

When used on create, omitting overridePolicy preserves the existing base-plus-placement behavior. When used on update, omitting overridePolicy leaves the stored policy unchanged, a non-null value replaces the stored policy, and null clears it. Read surfaces omit overridePolicy when no policy is stored on the pool.

State string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

CompartmentId string

(Updatable) The OCID of the compartment containing the instance pool.

InstanceConfigurationId string

(Updatable) The OCID of the instance configuration associated with the instance pool.

PlacementConfigurations []InstancePoolPlacementConfigurationArgs

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

Size int

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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

FreeformTags map[string]string

InstanceDisplayNameFormatter string

InstanceHostnameFormatter string

LifecycleManagement InstancePoolLifecycleManagementArgs

(Updatable) The lifecycle management options for the instance pool.

LoadBalancers []InstancePoolLoadBalancerArgs

OverridePolicy InstancePoolOverridePolicyArgs

(Updatable) Optional pool-level launch override policy for future instance launches.

State string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

compartment_id string

(Updatable) The OCID of the compartment containing the instance pool.

instance_configuration_id string

(Updatable) The OCID of the instance configuration associated with the instance pool.

placement_configurations list(object)

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

size number

defined_tags 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"}

display_name string

(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeform_tags map(string)

instance_display_name_formatter string

instance_hostname_formatter string

lifecycle_management object

(Updatable) The lifecycle management options for the instance pool.

load_balancers list(object)

override_policy object

(Updatable) Optional pool-level launch override policy for future instance launches.

state string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

compartmentId String

(Updatable) The OCID of the compartment containing the instance pool.

instanceConfigurationId String

(Updatable) The OCID of the instance configuration associated with the instance pool.

placementConfigurations List<InstancePoolPlacementConfiguration>

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

size Integer

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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeformTags Map<String,String>

instanceDisplayNameFormatter String

instanceHostnameFormatter String

lifecycleManagement InstancePoolLifecycleManagement

(Updatable) The lifecycle management options for the instance pool.

loadBalancers List<InstancePoolLoadBalancer>

overridePolicy InstancePoolOverridePolicy

(Updatable) Optional pool-level launch override policy for future instance launches.

state String

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

compartmentId string

(Updatable) The OCID of the compartment containing the instance pool.

instanceConfigurationId string

(Updatable) The OCID of the instance configuration associated with the instance pool.

placementConfigurations InstancePoolPlacementConfiguration[]

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

size number

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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeformTags {[key: string]: string}

instanceDisplayNameFormatter string

instanceHostnameFormatter string

lifecycleManagement InstancePoolLifecycleManagement

(Updatable) The lifecycle management options for the instance pool.

loadBalancers InstancePoolLoadBalancer[]

overridePolicy InstancePoolOverridePolicy

(Updatable) Optional pool-level launch override policy for future instance launches.

state string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

compartment_id str

(Updatable) The OCID of the compartment containing the instance pool.

instance_configuration_id str

(Updatable) The OCID of the instance configuration associated with the instance pool.

placement_configurations Sequence[InstancePoolPlacementConfigurationArgs]

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

size int

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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeform_tags Mapping[str, str]

instance_display_name_formatter str

instance_hostname_formatter str

lifecycle_management InstancePoolLifecycleManagementArgs

(Updatable) The lifecycle management options for the instance pool.

load_balancers Sequence[InstancePoolLoadBalancerArgs]

override_policy InstancePoolOverridePolicyArgs

(Updatable) Optional pool-level launch override policy for future instance launches.

state str

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

compartmentId String

(Updatable) The OCID of the compartment containing the instance pool.

instanceConfigurationId String

(Updatable) The OCID of the instance configuration associated with the instance pool.

placementConfigurations List<Property Map>

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

size Number

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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeformTags Map<String>

instanceDisplayNameFormatter String

instanceHostnameFormatter String

lifecycleManagement Property Map

(Updatable) The lifecycle management options for the instance pool.

loadBalancers List<Property Map>

overridePolicy Property Map

(Updatable) Optional pool-level launch override policy for future instance launches.

state String

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

Outputs

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

ActualSize 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.
CurrentSize int: Count of instance in running state associated to the Instance Pool.
Id string: The provider-assigned unique ID for this managed resource.
PoolType string: The type of resources managed by the pool.
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: 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.
CurrentSize int: Count of instance in running state associated to the Instance Pool.
Id string: The provider-assigned unique ID for this managed resource.
PoolType string: The type of resources managed by the pool.
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 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.
current_size number: Count of instance in running state associated to the Instance Pool.
id string: The provider-assigned unique ID for this managed resource.
pool_type string: The type of resources managed by the pool.
time_created 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: 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.
currentSize Integer: Count of instance in running state associated to the Instance Pool.
id String: The provider-assigned unique ID for this managed resource.
poolType String: The type of resources managed by the pool.
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: 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.
currentSize number: Count of instance in running state associated to the Instance Pool.
id string: The provider-assigned unique ID for this managed resource.
poolType string: The type of resources managed by the pool.
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: 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.
current_size int: Count of instance in running state associated to the Instance Pool.
id str: The provider-assigned unique ID for this managed resource.
pool_type str: The type of resources managed by the pool.
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: 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.
currentSize Number: Count of instance in running state associated to the Instance Pool.
id String: The provider-assigned unique ID for this managed resource.
poolType String: The type of resources managed by the pool.
timeCreated String: The date and time the instance pool was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

Look up Existing InstancePool Resource

Get an existing InstancePool 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?: InstancePoolState, opts?: CustomResourceOptions): InstancePool

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        actual_size: Optional[int] = None,
        compartment_id: Optional[str] = None,
        current_size: Optional[int] = None,
        defined_tags: Optional[Mapping[str, str]] = None,
        display_name: Optional[str] = None,
        freeform_tags: Optional[Mapping[str, str]] = None,
        instance_configuration_id: Optional[str] = None,
        instance_display_name_formatter: Optional[str] = None,
        instance_hostname_formatter: Optional[str] = None,
        lifecycle_management: Optional[InstancePoolLifecycleManagementArgs] = None,
        load_balancers: Optional[Sequence[InstancePoolLoadBalancerArgs]] = None,
        override_policy: Optional[InstancePoolOverridePolicyArgs] = None,
        placement_configurations: Optional[Sequence[InstancePoolPlacementConfigurationArgs]] = None,
        pool_type: Optional[str] = None,
        size: Optional[int] = None,
        state: Optional[str] = None,
        time_created: Optional[str] = None) -> InstancePool

func GetInstancePool(ctx *Context, name string, id IDInput, state *InstancePoolState, opts ...ResourceOption) (*InstancePool, error)

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

public static InstancePool get(String name, Output<String> id, InstancePoolState state, CustomResourceOptions options)

resources:  _:    type: oci:Core:InstancePool    get:      id: ${id}

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

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

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

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

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

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

The following state arguments are supported:

ActualSize 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.

CompartmentId string

(Updatable) The OCID of the compartment containing the instance pool.

CurrentSize int

Count of instance in running state associated to the Instance 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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

FreeformTags Dictionary<string, string>

InstanceConfigurationId string

(Updatable) The OCID of the instance configuration associated with the instance pool.

InstanceDisplayNameFormatter string

InstanceHostnameFormatter string

LifecycleManagement InstancePoolLifecycleManagement

(Updatable) The lifecycle management options for the instance pool.

LoadBalancers List<InstancePoolLoadBalancer>

OverridePolicy InstancePoolOverridePolicy

(Updatable) Optional pool-level launch override policy for future instance launches.

PlacementConfigurations List<InstancePoolPlacementConfiguration>

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

PoolType string

The type of resources managed by the pool.

Size int

State string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

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

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.

CompartmentId string

(Updatable) The OCID of the compartment containing the instance pool.

CurrentSize int

Count of instance in running state associated to the Instance 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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

FreeformTags map[string]string

InstanceConfigurationId string

(Updatable) The OCID of the instance configuration associated with the instance pool.

InstanceDisplayNameFormatter string

InstanceHostnameFormatter string

LifecycleManagement InstancePoolLifecycleManagementArgs

(Updatable) The lifecycle management options for the instance pool.

LoadBalancers []InstancePoolLoadBalancerArgs

OverridePolicy InstancePoolOverridePolicyArgs

(Updatable) Optional pool-level launch override policy for future instance launches.

PlacementConfigurations []InstancePoolPlacementConfigurationArgs

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

PoolType string

The type of resources managed by the pool.

Size int

State string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

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 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.

compartment_id string

(Updatable) The OCID of the compartment containing the instance pool.

current_size number

Count of instance in running state associated to the Instance Pool.

defined_tags 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"}

display_name string

(Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeform_tags map(string)

instance_configuration_id string

(Updatable) The OCID of the instance configuration associated with the instance pool.

instance_display_name_formatter string

instance_hostname_formatter string

lifecycle_management object

(Updatable) The lifecycle management options for the instance pool.

load_balancers list(object)

override_policy object

(Updatable) Optional pool-level launch override policy for future instance launches.

placement_configurations list(object)

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

pool_type string

The type of resources managed by the pool.

size number

state string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

time_created 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

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.

compartmentId String

(Updatable) The OCID of the compartment containing the instance pool.

currentSize Integer

Count of instance in running state associated to the Instance 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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeformTags Map<String,String>

instanceConfigurationId String

(Updatable) The OCID of the instance configuration associated with the instance pool.

instanceDisplayNameFormatter String

instanceHostnameFormatter String

lifecycleManagement InstancePoolLifecycleManagement

(Updatable) The lifecycle management options for the instance pool.

loadBalancers List<InstancePoolLoadBalancer>

overridePolicy InstancePoolOverridePolicy

(Updatable) Optional pool-level launch override policy for future instance launches.

placementConfigurations List<InstancePoolPlacementConfiguration>

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

poolType String

The type of resources managed by the pool.

size Integer

state String

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

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

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.

compartmentId string

(Updatable) The OCID of the compartment containing the instance pool.

currentSize number

Count of instance in running state associated to the Instance 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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeformTags {[key: string]: string}

instanceConfigurationId string

(Updatable) The OCID of the instance configuration associated with the instance pool.

instanceDisplayNameFormatter string

instanceHostnameFormatter string

lifecycleManagement InstancePoolLifecycleManagement

(Updatable) The lifecycle management options for the instance pool.

loadBalancers InstancePoolLoadBalancer[]

overridePolicy InstancePoolOverridePolicy

(Updatable) Optional pool-level launch override policy for future instance launches.

placementConfigurations InstancePoolPlacementConfiguration[]

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

poolType string

The type of resources managed by the pool.

size number

state string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

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

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.

compartment_id str

(Updatable) The OCID of the compartment containing the instance pool.

current_size int

Count of instance in running state associated to the Instance 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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeform_tags Mapping[str, str]

instance_configuration_id str

(Updatable) The OCID of the instance configuration associated with the instance pool.

instance_display_name_formatter str

instance_hostname_formatter str

lifecycle_management InstancePoolLifecycleManagementArgs

(Updatable) The lifecycle management options for the instance pool.

load_balancers Sequence[InstancePoolLoadBalancerArgs]

override_policy InstancePoolOverridePolicyArgs

(Updatable) Optional pool-level launch override policy for future instance launches.

placement_configurations Sequence[InstancePoolPlacementConfigurationArgs]

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

pool_type str

The type of resources managed by the pool.

size int

state str

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

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

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.

compartmentId String

(Updatable) The OCID of the compartment containing the instance pool.

currentSize Number

Count of instance in running state associated to the Instance 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) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

freeformTags Map<String>

instanceConfigurationId String

(Updatable) The OCID of the instance configuration associated with the instance pool.

instanceDisplayNameFormatter String

instanceHostnameFormatter String

lifecycleManagement Property Map

(Updatable) The lifecycle management options for the instance pool.

loadBalancers List<Property Map>

overridePolicy Property Map

(Updatable) Optional pool-level launch override policy for future instance launches.

placementConfigurations List<Property Map>

(Updatable) The placement configurations for the instance pool. Provide one placement configuration for each availability domain.

poolType String

The type of resources managed by the pool.

size Number

state String

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

timeCreated String

The date and time the instance pool was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

Supporting Types

InstancePoolLifecycleManagement, InstancePoolLifecycleManagementArgs

LifecycleActions InstancePoolLifecycleManagementLifecycleActions: (Updatable) The lifecycle actions for the instance pool.

LifecycleActions InstancePoolLifecycleManagementLifecycleActions: (Updatable) The lifecycle actions for the instance pool.

lifecycle_actions object: (Updatable) The lifecycle actions for the instance pool.

lifecycleActions InstancePoolLifecycleManagementLifecycleActions: (Updatable) The lifecycle actions for the instance pool.

lifecycleActions InstancePoolLifecycleManagementLifecycleActions: (Updatable) The lifecycle actions for the instance pool.

lifecycle_actions InstancePoolLifecycleManagementLifecycleActions: (Updatable) The lifecycle actions for the instance pool.

lifecycleActions Property Map: (Updatable) The lifecycle actions for the instance pool.

InstancePoolLifecycleManagementLifecycleActions, InstancePoolLifecycleManagementLifecycleActionsArgs

PreTermination InstancePoolLifecycleManagementLifecycleActionsPreTermination: (Updatable) The data for pre-termination action for an instance pool

PreTermination InstancePoolLifecycleManagementLifecycleActionsPreTermination: (Updatable) The data for pre-termination action for an instance pool

pre_termination object: (Updatable) The data for pre-termination action for an instance pool

preTermination InstancePoolLifecycleManagementLifecycleActionsPreTermination: (Updatable) The data for pre-termination action for an instance pool

preTermination InstancePoolLifecycleManagementLifecycleActionsPreTermination: (Updatable) The data for pre-termination action for an instance pool

pre_termination InstancePoolLifecycleManagementLifecycleActionsPreTermination: (Updatable) The data for pre-termination action for an instance pool

preTermination Property Map: (Updatable) The data for pre-termination action for an instance pool

InstancePoolLifecycleManagementLifecycleActionsPreTermination, InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs

IsEnabled bool: (Updatable) Whether pre-termination action is enabled or not.
OnTimeout InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeout: (Updatable) Options to handle timeout for pre-termination action.
Timeout int: (Updatable) The timeout in seconds for pre-termination action for an instance pool(min = 0 sec, max = 7200 secs).

IsEnabled bool: (Updatable) Whether pre-termination action is enabled or not.
OnTimeout InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeout: (Updatable) Options to handle timeout for pre-termination action.
Timeout int: (Updatable) The timeout in seconds for pre-termination action for an instance pool(min = 0 sec, max = 7200 secs).

is_enabled bool: (Updatable) Whether pre-termination action is enabled or not.
on_timeout object: (Updatable) Options to handle timeout for pre-termination action.
timeout number: (Updatable) The timeout in seconds for pre-termination action for an instance pool(min = 0 sec, max = 7200 secs).

isEnabled Boolean: (Updatable) Whether pre-termination action is enabled or not.
onTimeout InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeout: (Updatable) Options to handle timeout for pre-termination action.
timeout Integer: (Updatable) The timeout in seconds for pre-termination action for an instance pool(min = 0 sec, max = 7200 secs).

isEnabled boolean: (Updatable) Whether pre-termination action is enabled or not.
onTimeout InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeout: (Updatable) Options to handle timeout for pre-termination action.
timeout number: (Updatable) The timeout in seconds for pre-termination action for an instance pool(min = 0 sec, max = 7200 secs).

is_enabled bool: (Updatable) Whether pre-termination action is enabled or not.
on_timeout InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeout: (Updatable) Options to handle timeout for pre-termination action.
timeout int: (Updatable) The timeout in seconds for pre-termination action for an instance pool(min = 0 sec, max = 7200 secs).

isEnabled Boolean: (Updatable) Whether pre-termination action is enabled or not.
onTimeout Property Map: (Updatable) Options to handle timeout for pre-termination action.
timeout Number: (Updatable) The timeout in seconds for pre-termination action for an instance pool(min = 0 sec, max = 7200 secs).

InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeout, InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs

PreserveBlockVolumeMode string: (Updatable) Whether the block volume should be preserved after termination.
PreserveBootVolumeMode string: (Updatable) Whether the boot volume should be preserved after termination.

PreserveBlockVolumeMode string: (Updatable) Whether the block volume should be preserved after termination.
PreserveBootVolumeMode string: (Updatable) Whether the boot volume should be preserved after termination.

preserve_block_volume_mode string: (Updatable) Whether the block volume should be preserved after termination.
preserve_boot_volume_mode string: (Updatable) Whether the boot volume should be preserved after termination.

preserveBlockVolumeMode String: (Updatable) Whether the block volume should be preserved after termination.
preserveBootVolumeMode String: (Updatable) Whether the boot volume should be preserved after termination.

preserveBlockVolumeMode string: (Updatable) Whether the block volume should be preserved after termination.
preserveBootVolumeMode string: (Updatable) Whether the boot volume should be preserved after termination.

preserve_block_volume_mode str: (Updatable) Whether the block volume should be preserved after termination.
preserve_boot_volume_mode str: (Updatable) Whether the boot volume should be preserved after termination.

preserveBlockVolumeMode String: (Updatable) Whether the block volume should be preserved after termination.
preserveBootVolumeMode String: (Updatable) Whether the boot volume should be preserved after termination.

InstancePoolLoadBalancer, InstancePoolLoadBalancerArgs

BackendSetName string

The name of the backend set on the load balancer to add instances to.

LoadBalancerId string

The OCID of the load balancer to attach to the instance pool.

Port int

The port value to use when creating the backend set.

VnicSelection string

Indicates which VNIC on each instance in the 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.

Id string

The OCID of the load balancer attachment.

InstancePoolId string

The OCID of the instance pool of the load balancer attachment.

State string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

BackendSetName string

The name of the backend set on the load balancer to add instances to.

LoadBalancerId string

The OCID of the load balancer to attach to the instance pool.

Port int

The port value to use when creating the backend set.

VnicSelection string

Id string

The OCID of the load balancer attachment.

InstancePoolId string

The OCID of the instance pool of the load balancer attachment.

State string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

backend_set_name string

The name of the backend set on the load balancer to add instances to.

load_balancer_id string

The OCID of the load balancer to attach to the instance pool.

port number

The port value to use when creating the backend set.

vnic_selection string

id string

The OCID of the load balancer attachment.

instance_pool_id string

The OCID of the instance pool of the load balancer attachment.

state string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

backendSetName String

The name of the backend set on the load balancer to add instances to.

loadBalancerId String

The OCID of the load balancer to attach to the instance pool.

port Integer

The port value to use when creating the backend set.

vnicSelection String

id String

The OCID of the load balancer attachment.

instancePoolId String

The OCID of the instance pool of the load balancer attachment.

state String

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

backendSetName string

The name of the backend set on the load balancer to add instances to.

loadBalancerId string

The OCID of the load balancer to attach to the instance pool.

port number

The port value to use when creating the backend set.

vnicSelection string

id string

The OCID of the load balancer attachment.

instancePoolId string

The OCID of the instance pool of the load balancer attachment.

state string

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

backend_set_name str

The name of the backend set on the load balancer to add instances to.

load_balancer_id str

The OCID of the load balancer to attach to the instance pool.

port int

The port value to use when creating the backend set.

vnic_selection str

id str

The OCID of the load balancer attachment.

instance_pool_id str

The OCID of the instance pool of the load balancer attachment.

state str

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

backendSetName String

The name of the backend set on the load balancer to add instances to.

loadBalancerId String

The OCID of the load balancer to attach to the instance pool.

port Number

The port value to use when creating the backend set.

vnicSelection String

id String

The OCID of the load balancer attachment.

instancePoolId String

The OCID of the instance pool of the load balancer attachment.

state String

(Updatable) The target state for the instance pool update operation (ignored at create time and should not be set). Could be set to RUNNING or STOPPED.

** 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

InstancePoolOverridePolicy, InstancePoolOverridePolicyArgs

OverrideStatements List<InstancePoolOverridePolicyOverrideStatement>: (Updatable) The ordered set of availability domain-scoped override statements for this policy.

OverrideStatements []InstancePoolOverridePolicyOverrideStatement: (Updatable) The ordered set of availability domain-scoped override statements for this policy.

override_statements list(object): (Updatable) The ordered set of availability domain-scoped override statements for this policy.

overrideStatements List<InstancePoolOverridePolicyOverrideStatement>: (Updatable) The ordered set of availability domain-scoped override statements for this policy.

overrideStatements InstancePoolOverridePolicyOverrideStatement[]: (Updatable) The ordered set of availability domain-scoped override statements for this policy.

override_statements Sequence[InstancePoolOverridePolicyOverrideStatement]: (Updatable) The ordered set of availability domain-scoped override statements for this policy.

overrideStatements List<Property Map>: (Updatable) The ordered set of availability domain-scoped override statements for this policy.

InstancePoolOverridePolicyOverrideStatement, InstancePoolOverridePolicyOverrideStatementArgs

OverrideOptions List<InstancePoolOverridePolicyOverrideStatementOverrideOption>

(Updatable) The ordered list of candidate override options for the matched availability domain.

Request order defines the canonical candidate sequence. Override options within the same statement must normalize to distinct override payloads.

Selector InstancePoolOverridePolicyOverrideStatementSelector

(Updatable) The selector for an override statement.

In V1, the selector contains only the scalar availabilityDomain. Additional selector fields are rejected.

OverrideOptions []InstancePoolOverridePolicyOverrideStatementOverrideOption

(Updatable) The ordered list of candidate override options for the matched availability domain.

Request order defines the canonical candidate sequence. Override options within the same statement must normalize to distinct override payloads.

Selector InstancePoolOverridePolicyOverrideStatementSelector

(Updatable) The selector for an override statement.

In V1, the selector contains only the scalar availabilityDomain. Additional selector fields are rejected.

override_options list(object)

(Updatable) The ordered list of candidate override options for the matched availability domain.

Request order defines the canonical candidate sequence. Override options within the same statement must normalize to distinct override payloads.

selector object

(Updatable) The selector for an override statement.

In V1, the selector contains only the scalar availabilityDomain. Additional selector fields are rejected.

overrideOptions List<InstancePoolOverridePolicyOverrideStatementOverrideOption>

(Updatable) The ordered list of candidate override options for the matched availability domain.

Request order defines the canonical candidate sequence. Override options within the same statement must normalize to distinct override payloads.

selector InstancePoolOverridePolicyOverrideStatementSelector

(Updatable) The selector for an override statement.

In V1, the selector contains only the scalar availabilityDomain. Additional selector fields are rejected.

overrideOptions InstancePoolOverridePolicyOverrideStatementOverrideOption[]

(Updatable) The ordered list of candidate override options for the matched availability domain.

Request order defines the canonical candidate sequence. Override options within the same statement must normalize to distinct override payloads.

selector InstancePoolOverridePolicyOverrideStatementSelector

(Updatable) The selector for an override statement.

In V1, the selector contains only the scalar availabilityDomain. Additional selector fields are rejected.

override_options Sequence[InstancePoolOverridePolicyOverrideStatementOverrideOption]

(Updatable) The ordered list of candidate override options for the matched availability domain.

Request order defines the canonical candidate sequence. Override options within the same statement must normalize to distinct override payloads.

selector InstancePoolOverridePolicyOverrideStatementSelector

(Updatable) The selector for an override statement.

In V1, the selector contains only the scalar availabilityDomain. Additional selector fields are rejected.

overrideOptions List<Property Map>

(Updatable) The ordered list of candidate override options for the matched availability domain.

Request order defines the canonical candidate sequence. Override options within the same statement must normalize to distinct override payloads.

selector Property Map

(Updatable) The selector for an override statement.

In V1, the selector contains only the scalar availabilityDomain. Additional selector fields are rejected.

InstancePoolOverridePolicyOverrideStatementOverrideOption, InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs

Name string

(Updatable) A user-friendly name for the override option.

Override InstancePoolOverridePolicyOverrideStatementOverrideOptionOverride

(Updatable) The concrete launch mutation payload for an override option.

In V1, the override payload is limited to shape, shapeConfigDetails, and capacityReservationId.

Each override option must include at least one of shape or capacityReservationId, so a capacityReservationId-only override is valid. shapeConfigDetails may be supplied only when shape is supplied. If shape is a Flex or Fungible shape, shapeConfigDetails is required.

Placement-owned and system-owned fields are not supported in this payload. Any field outside this V1 payload shape is rejected.

Name string

(Updatable) A user-friendly name for the override option.

Override InstancePoolOverridePolicyOverrideStatementOverrideOptionOverride

(Updatable) The concrete launch mutation payload for an override option.

In V1, the override payload is limited to shape, shapeConfigDetails, and capacityReservationId.

Placement-owned and system-owned fields are not supported in this payload. Any field outside this V1 payload shape is rejected.

name string

(Updatable) A user-friendly name for the override option.

override object

(Updatable) The concrete launch mutation payload for an override option.

In V1, the override payload is limited to shape, shapeConfigDetails, and capacityReservationId.

Placement-owned and system-owned fields are not supported in this payload. Any field outside this V1 payload shape is rejected.

name String

(Updatable) A user-friendly name for the override option.

override InstancePoolOverridePolicyOverrideStatementOverrideOptionOverride

(Updatable) The concrete launch mutation payload for an override option.

In V1, the override payload is limited to shape, shapeConfigDetails, and capacityReservationId.

Placement-owned and system-owned fields are not supported in this payload. Any field outside this V1 payload shape is rejected.

name string

(Updatable) A user-friendly name for the override option.

override InstancePoolOverridePolicyOverrideStatementOverrideOptionOverride

(Updatable) The concrete launch mutation payload for an override option.

In V1, the override payload is limited to shape, shapeConfigDetails, and capacityReservationId.

Placement-owned and system-owned fields are not supported in this payload. Any field outside this V1 payload shape is rejected.

name str

(Updatable) A user-friendly name for the override option.

override InstancePoolOverridePolicyOverrideStatementOverrideOptionOverride

(Updatable) The concrete launch mutation payload for an override option.

In V1, the override payload is limited to shape, shapeConfigDetails, and capacityReservationId.

Placement-owned and system-owned fields are not supported in this payload. Any field outside this V1 payload shape is rejected.

name String

(Updatable) A user-friendly name for the override option.

override Property Map

(Updatable) The concrete launch mutation payload for an override option.

In V1, the override payload is limited to shape, shapeConfigDetails, and capacityReservationId.

Placement-owned and system-owned fields are not supported in this payload. Any field outside this V1 payload shape is rejected.

InstancePoolOverridePolicyOverrideStatementOverrideOptionOverride, InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs

CapacityReservationId string

(Updatable) The OCID of the compute capacity reservation to use for the override option.

Shape string

(Updatable) The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.

You can enumerate all available shapes by calling ListShapes.

ShapeConfigDetails InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetails

(Updatable) The shape configuration requested for the override option.

CapacityReservationId string

(Updatable) The OCID of the compute capacity reservation to use for the override option.

Shape string

(Updatable) The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.

You can enumerate all available shapes by calling ListShapes.

ShapeConfigDetails InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetails

(Updatable) The shape configuration requested for the override option.

capacity_reservation_id string

(Updatable) The OCID of the compute capacity reservation to use for the override option.

shape string

(Updatable) The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.

You can enumerate all available shapes by calling ListShapes.

shape_config_details object

(Updatable) The shape configuration requested for the override option.

capacityReservationId String

(Updatable) The OCID of the compute capacity reservation to use for the override option.

shape String

(Updatable) The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.

You can enumerate all available shapes by calling ListShapes.

shapeConfigDetails InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetails

(Updatable) The shape configuration requested for the override option.

capacityReservationId string

(Updatable) The OCID of the compute capacity reservation to use for the override option.

shape string

(Updatable) The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.

You can enumerate all available shapes by calling ListShapes.

shapeConfigDetails InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetails

(Updatable) The shape configuration requested for the override option.

capacity_reservation_id str

(Updatable) The OCID of the compute capacity reservation to use for the override option.

shape str

(Updatable) The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.

You can enumerate all available shapes by calling ListShapes.

shape_config_details InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetails

(Updatable) The shape configuration requested for the override option.

capacityReservationId String

(Updatable) The OCID of the compute capacity reservation to use for the override option.

shape String

(Updatable) The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.

You can enumerate all available shapes by calling ListShapes.

shapeConfigDetails Property Map

(Updatable) The shape configuration requested for the override option.

InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetails, InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs

BaselineOcpuUtilization string

(Updatable) The baseline OCPU utilization for a subcore burstable VM instance. Leave this attribute blank for a non-burstable instance, or explicitly specify non-burstable with BASELINE_1_1.

The following values are supported:

BASELINE_1_8 - baseline usage is 1/8 of an OCPU.
BASELINE_1_2 - baseline usage is 1/2 of an OCPU.
BASELINE_1_1 - baseline usage is an entire OCPU. This represents a non-burstable instance.

LocalVolumeSizeInGbs int

(Updatable) The NVMe-backed local storage capacity, in GB, for flexible dense (DenseLV) VM shapes. If the selected shape is DenseLV, the value must be greater than 0. For all other shapes, the value must be null (if specified); any non-null value for a non-DenseLV shape results in an error.

MemoryInGbs double

(Updatable) The total amount of memory available to the instance, in gigabytes.

Nvmes int

(Updatable) The number of NVMe drives to be used for storage. A single drive has 6.8 TB available.

Ocpus double

(Updatable) The total number of OCPUs available to the instance.

ResourceManagement string

(Updatable) This field is reserved for internal use.

Vcpus int

(Updatable) The total number of VCPUs available to the instance. This can be used instead of OCPUs, in which case the actual number of OCPUs will be calculated based on this value and the actual hardware. This must be a multiple of 2.

BaselineOcpuUtilization string

(Updatable) The baseline OCPU utilization for a subcore burstable VM instance. Leave this attribute blank for a non-burstable instance, or explicitly specify non-burstable with BASELINE_1_1.

The following values are supported:

BASELINE_1_8 - baseline usage is 1/8 of an OCPU.
BASELINE_1_2 - baseline usage is 1/2 of an OCPU.
BASELINE_1_1 - baseline usage is an entire OCPU. This represents a non-burstable instance.

LocalVolumeSizeInGbs int

MemoryInGbs float64

(Updatable) The total amount of memory available to the instance, in gigabytes.

Nvmes int

(Updatable) The number of NVMe drives to be used for storage. A single drive has 6.8 TB available.

Ocpus float64

(Updatable) The total number of OCPUs available to the instance.

ResourceManagement string

(Updatable) This field is reserved for internal use.

Vcpus int

baseline_ocpu_utilization string

(Updatable) The baseline OCPU utilization for a subcore burstable VM instance. Leave this attribute blank for a non-burstable instance, or explicitly specify non-burstable with BASELINE_1_1.

The following values are supported:

BASELINE_1_8 - baseline usage is 1/8 of an OCPU.
BASELINE_1_2 - baseline usage is 1/2 of an OCPU.
BASELINE_1_1 - baseline usage is an entire OCPU. This represents a non-burstable instance.

local_volume_size_in_gbs number

memory_in_gbs number

(Updatable) The total amount of memory available to the instance, in gigabytes.

nvmes number

(Updatable) The number of NVMe drives to be used for storage. A single drive has 6.8 TB available.

ocpus number

(Updatable) The total number of OCPUs available to the instance.

resource_management string

(Updatable) This field is reserved for internal use.

vcpus number

baselineOcpuUtilization String

(Updatable) The baseline OCPU utilization for a subcore burstable VM instance. Leave this attribute blank for a non-burstable instance, or explicitly specify non-burstable with BASELINE_1_1.

The following values are supported:

BASELINE_1_8 - baseline usage is 1/8 of an OCPU.
BASELINE_1_2 - baseline usage is 1/2 of an OCPU.
BASELINE_1_1 - baseline usage is an entire OCPU. This represents a non-burstable instance.

localVolumeSizeInGbs Integer

memoryInGbs Double

(Updatable) The total amount of memory available to the instance, in gigabytes.

nvmes Integer

(Updatable) The number of NVMe drives to be used for storage. A single drive has 6.8 TB available.

ocpus Double

(Updatable) The total number of OCPUs available to the instance.

resourceManagement String

(Updatable) This field is reserved for internal use.

vcpus Integer

baselineOcpuUtilization string

(Updatable) The baseline OCPU utilization for a subcore burstable VM instance. Leave this attribute blank for a non-burstable instance, or explicitly specify non-burstable with BASELINE_1_1.

The following values are supported:

BASELINE_1_8 - baseline usage is 1/8 of an OCPU.
BASELINE_1_2 - baseline usage is 1/2 of an OCPU.
BASELINE_1_1 - baseline usage is an entire OCPU. This represents a non-burstable instance.

localVolumeSizeInGbs number

memoryInGbs number

(Updatable) The total amount of memory available to the instance, in gigabytes.

nvmes number

(Updatable) The number of NVMe drives to be used for storage. A single drive has 6.8 TB available.

ocpus number

(Updatable) The total number of OCPUs available to the instance.

resourceManagement string

(Updatable) This field is reserved for internal use.

vcpus number

baseline_ocpu_utilization str

(Updatable) The baseline OCPU utilization for a subcore burstable VM instance. Leave this attribute blank for a non-burstable instance, or explicitly specify non-burstable with BASELINE_1_1.

The following values are supported:

BASELINE_1_8 - baseline usage is 1/8 of an OCPU.
BASELINE_1_2 - baseline usage is 1/2 of an OCPU.
BASELINE_1_1 - baseline usage is an entire OCPU. This represents a non-burstable instance.

local_volume_size_in_gbs int

memory_in_gbs float

(Updatable) The total amount of memory available to the instance, in gigabytes.

nvmes int

(Updatable) The number of NVMe drives to be used for storage. A single drive has 6.8 TB available.

ocpus float

(Updatable) The total number of OCPUs available to the instance.

resource_management str

(Updatable) This field is reserved for internal use.

vcpus int

baselineOcpuUtilization String

(Updatable) The baseline OCPU utilization for a subcore burstable VM instance. Leave this attribute blank for a non-burstable instance, or explicitly specify non-burstable with BASELINE_1_1.

The following values are supported:

BASELINE_1_8 - baseline usage is 1/8 of an OCPU.
BASELINE_1_2 - baseline usage is 1/2 of an OCPU.
BASELINE_1_1 - baseline usage is an entire OCPU. This represents a non-burstable instance.

localVolumeSizeInGbs Number

memoryInGbs Number

(Updatable) The total amount of memory available to the instance, in gigabytes.

nvmes Number

(Updatable) The number of NVMe drives to be used for storage. A single drive has 6.8 TB available.

ocpus Number

(Updatable) The total number of OCPUs available to the instance.

resourceManagement String

(Updatable) This field is reserved for internal use.

vcpus Number

InstancePoolOverridePolicyOverrideStatementSelector, InstancePoolOverridePolicyOverrideStatementSelectorArgs

AvailabilityDomain string

(Updatable) The availability domain that this statement applies to.

The value must match an availability domain present in the pool's placementConfigurations.

AvailabilityDomain string

(Updatable) The availability domain that this statement applies to.

The value must match an availability domain present in the pool's placementConfigurations.

availability_domain string

(Updatable) The availability domain that this statement applies to.

The value must match an availability domain present in the pool's placementConfigurations.

availabilityDomain String

(Updatable) The availability domain that this statement applies to.

The value must match an availability domain present in the pool's placementConfigurations.

availabilityDomain string

(Updatable) The availability domain that this statement applies to.

The value must match an availability domain present in the pool's placementConfigurations.

availability_domain str

(Updatable) The availability domain that this statement applies to.

The value must match an availability domain present in the pool's placementConfigurations.

availabilityDomain String

(Updatable) The availability domain that this statement applies to.

The value must match an availability domain present in the pool's placementConfigurations.

InstancePoolPlacementConfiguration, InstancePoolPlacementConfigurationArgs

AvailabilityDomain string

(Updatable) The availability domain to place instances. Example: Uocm:PHX-AD-1

ComputeClusterId string

The OCID of the compute cluster that the instance will be created in.

Make sure the compute cluster belongs to the same availability domain as specified in placement configuration otherwise the request will be rejected with 400. Once this field is set, it cannot be updated. Also any update to the availability domain in placement configuration will be blocked.

FaultDomains List<string>

(Updatable) The fault domains to place instances.

If you don't provide any values, the system makes a best effort to distribute instances across all fault domains based on capacity.

To distribute the instances evenly across selected fault domains, provide a set of fault domains. For example, you might want instances to be evenly distributed if your applications require high availability.

To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

Example: [FAULT-DOMAIN-1, FAULT-DOMAIN-2, FAULT-DOMAIN-3]

PrimarySubnetId string

(Updatable) 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 InstancePoolPlacementConfigurationPrimaryVnicSubnets

(Updatable) Details about the IPv6 primary subnet.

SecondaryVnicSubnets List<InstancePoolPlacementConfigurationSecondaryVnicSubnet>

(Updatable) The set of secondary VNIC data for instances in the pool.

AvailabilityDomain string

(Updatable) The availability domain to place instances. Example: Uocm:PHX-AD-1

ComputeClusterId string

The OCID of the compute cluster that the instance will be created in.

FaultDomains []string

(Updatable) The fault domains to place instances.

If you don't provide any values, the system makes a best effort to distribute instances across all fault domains based on capacity.

To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

Example: [FAULT-DOMAIN-1, FAULT-DOMAIN-2, FAULT-DOMAIN-3]

PrimarySubnetId string

(Updatable) 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 InstancePoolPlacementConfigurationPrimaryVnicSubnets

(Updatable) Details about the IPv6 primary subnet.

SecondaryVnicSubnets []InstancePoolPlacementConfigurationSecondaryVnicSubnet

(Updatable) The set of secondary VNIC data for instances in the pool.

availability_domain string

(Updatable) The availability domain to place instances. Example: Uocm:PHX-AD-1

compute_cluster_id string

The OCID of the compute cluster that the instance will be created in.

fault_domains list(string)

(Updatable) The fault domains to place instances.

If you don't provide any values, the system makes a best effort to distribute instances across all fault domains based on capacity.

To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

Example: [FAULT-DOMAIN-1, FAULT-DOMAIN-2, FAULT-DOMAIN-3]

primary_subnet_id string

(Updatable) 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 object

(Updatable) Details about the IPv6 primary subnet.

secondary_vnic_subnets list(object)

(Updatable) The set of secondary VNIC data for instances in the pool.

availabilityDomain String

(Updatable) The availability domain to place instances. Example: Uocm:PHX-AD-1

computeClusterId String

The OCID of the compute cluster that the instance will be created in.

faultDomains List<String>

(Updatable) The fault domains to place instances.

If you don't provide any values, the system makes a best effort to distribute instances across all fault domains based on capacity.

To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

Example: [FAULT-DOMAIN-1, FAULT-DOMAIN-2, FAULT-DOMAIN-3]

primarySubnetId String

(Updatable) 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 InstancePoolPlacementConfigurationPrimaryVnicSubnets

(Updatable) Details about the IPv6 primary subnet.

secondaryVnicSubnets List<InstancePoolPlacementConfigurationSecondaryVnicSubnet>

(Updatable) The set of secondary VNIC data for instances in the pool.

availabilityDomain string

(Updatable) The availability domain to place instances. Example: Uocm:PHX-AD-1

computeClusterId string

The OCID of the compute cluster that the instance will be created in.

faultDomains string[]

(Updatable) The fault domains to place instances.

If you don't provide any values, the system makes a best effort to distribute instances across all fault domains based on capacity.

To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

Example: [FAULT-DOMAIN-1, FAULT-DOMAIN-2, FAULT-DOMAIN-3]

primarySubnetId string

(Updatable) 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 InstancePoolPlacementConfigurationPrimaryVnicSubnets

(Updatable) Details about the IPv6 primary subnet.

secondaryVnicSubnets InstancePoolPlacementConfigurationSecondaryVnicSubnet[]

(Updatable) The set of secondary VNIC data for instances in the pool.

availability_domain str

(Updatable) The availability domain to place instances. Example: Uocm:PHX-AD-1

compute_cluster_id str

The OCID of the compute cluster that the instance will be created in.

fault_domains Sequence[str]

(Updatable) The fault domains to place instances.

If you don't provide any values, the system makes a best effort to distribute instances across all fault domains based on capacity.

To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

Example: [FAULT-DOMAIN-1, FAULT-DOMAIN-2, FAULT-DOMAIN-3]

primary_subnet_id str

(Updatable) 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 InstancePoolPlacementConfigurationPrimaryVnicSubnets

(Updatable) Details about the IPv6 primary subnet.

secondary_vnic_subnets Sequence[InstancePoolPlacementConfigurationSecondaryVnicSubnet]

(Updatable) The set of secondary VNIC data for instances in the pool.

availabilityDomain String

(Updatable) The availability domain to place instances. Example: Uocm:PHX-AD-1

computeClusterId String

The OCID of the compute cluster that the instance will be created in.

faultDomains List<String>

(Updatable) The fault domains to place instances.

If you don't provide any values, the system makes a best effort to distribute instances across all fault domains based on capacity.

To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

Example: [FAULT-DOMAIN-1, FAULT-DOMAIN-2, FAULT-DOMAIN-3]

primarySubnetId String

(Updatable) 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 Property Map

(Updatable) Details about the IPv6 primary subnet.

secondaryVnicSubnets List<Property Map>

(Updatable) The set of secondary VNIC data for instances in the pool.

InstancePoolPlacementConfigurationPrimaryVnicSubnets, InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs

SubnetId string: (Updatable) The subnet OCID for the secondary VNIC.
Ipv6addressIpv6subnetCidrPairDetails List<InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetail>: (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
Ipv6addressIpv6subnetCidrPairDetails []InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetail: (Updatable) 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: (Updatable) 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 string: (Updatable) The subnet OCID for the secondary VNIC.
ipv6address_ipv6subnet_cidr_pair_details list(object): (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
ipv6addressIpv6subnetCidrPairDetails List<InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetail>: (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
ipv6addressIpv6subnetCidrPairDetails InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetail[]: (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
ipv6address_ipv6subnet_cidr_pair_details Sequence[InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetail]: (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
ipv6addressIpv6subnetCidrPairDetails List<Property Map>: (Updatable) 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: (Updatable) 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.

InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetail, InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs

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

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

ipv6subnet_cidr string: (Updatable) Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

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

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

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

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

InstancePoolPlacementConfigurationSecondaryVnicSubnet, InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs

SubnetId string: (Updatable) The subnet OCID for the secondary VNIC.
DisplayName string: (Updatable) The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
Ipv6addressIpv6subnetCidrPairDetails List<InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail>: (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
DisplayName string: (Updatable) The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
Ipv6addressIpv6subnetCidrPairDetails []InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail: (Updatable) 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: (Updatable) 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 string: (Updatable) The subnet OCID for the secondary VNIC.
display_name string: (Updatable) The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
ipv6address_ipv6subnet_cidr_pair_details list(object): (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
displayName String: (Updatable) The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
ipv6addressIpv6subnetCidrPairDetails List<InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail>: (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
displayName string: (Updatable) The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
ipv6addressIpv6subnetCidrPairDetails InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail[]: (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
display_name str: (Updatable) The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
ipv6address_ipv6subnet_cidr_pair_details Sequence[InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail]: (Updatable) 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: (Updatable) 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: (Updatable) The subnet OCID for the secondary VNIC.
displayName String: (Updatable) The display name of the VNIC. This is also used to match against the instance configuration defined secondary VNIC.
ipv6addressIpv6subnetCidrPairDetails List<Property Map>: (Updatable) 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: (Updatable) 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.

InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail, InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs

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

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

ipv6subnet_cidr string: (Updatable) Optional. Used to disambiguate which subnet prefix should be used to create an IPv6 allocation.

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

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

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

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

Import

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

$ pulumi import oci:Core/instancePool:InstancePool test_instance_pool "id"

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.

Viewing docs for Oracle Cloud Infrastructure v5.7.0
published on Thursday, Nov 12, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-oci

oci.Core.InstancePool

On this page

On this page

Example Usage

Create InstancePool Resource

Constructor syntax

Parameters

Constructor example

InstancePool Resource Properties

Inputs

Outputs

Look up Existing InstancePool Resource

Supporting Types

InstancePoolLifecycleManagement, InstancePoolLifecycleManagementArgs

InstancePoolLifecycleManagementLifecycleActions, InstancePoolLifecycleManagementLifecycleActionsArgs

InstancePoolLifecycleManagementLifecycleActionsPreTermination, InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs

InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeout, InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs

InstancePoolLoadBalancer, InstancePoolLoadBalancerArgs

InstancePoolOverridePolicy, InstancePoolOverridePolicyArgs

InstancePoolOverridePolicyOverrideStatement, InstancePoolOverridePolicyOverrideStatementArgs

InstancePoolOverridePolicyOverrideStatementOverrideOption, InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs

InstancePoolOverridePolicyOverrideStatementOverrideOptionOverride, InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs

InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetails, InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs

InstancePoolOverridePolicyOverrideStatementSelector, InstancePoolOverridePolicyOverrideStatementSelectorArgs

InstancePoolPlacementConfiguration, InstancePoolPlacementConfigurationArgs

InstancePoolPlacementConfigurationPrimaryVnicSubnets, InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs

InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetail, InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs

InstancePoolPlacementConfigurationSecondaryVnicSubnet, InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs

InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail, InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs

Import

Package Details

On this page

On this page

Try Pulumi Cloud free.
Your team will thank you.

oci.Core.InstancePool

On this page

On this page

Example Usage

Create InstancePool Resource

Constructor syntax

Parameters

Constructor example

InstancePool Resource Properties

Inputs

Outputs

Look up Existing InstancePool Resource

Supporting Types

InstancePoolLifecycleManagement, InstancePoolLifecycleManagementArgs

InstancePoolLifecycleManagementLifecycleActions, InstancePoolLifecycleManagementLifecycleActionsArgs

InstancePoolLifecycleManagementLifecycleActionsPreTermination, InstancePoolLifecycleManagementLifecycleActionsPreTerminationArgs

InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeout, InstancePoolLifecycleManagementLifecycleActionsPreTerminationOnTimeoutArgs

InstancePoolLoadBalancer, InstancePoolLoadBalancerArgs

InstancePoolOverridePolicy, InstancePoolOverridePolicyArgs

InstancePoolOverridePolicyOverrideStatement, InstancePoolOverridePolicyOverrideStatementArgs

InstancePoolOverridePolicyOverrideStatementOverrideOption, InstancePoolOverridePolicyOverrideStatementOverrideOptionArgs

InstancePoolOverridePolicyOverrideStatementOverrideOptionOverride, InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideArgs

InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetails, InstancePoolOverridePolicyOverrideStatementOverrideOptionOverrideShapeConfigDetailsArgs

InstancePoolOverridePolicyOverrideStatementSelector, InstancePoolOverridePolicyOverrideStatementSelectorArgs

InstancePoolPlacementConfiguration, InstancePoolPlacementConfigurationArgs

InstancePoolPlacementConfigurationPrimaryVnicSubnets, InstancePoolPlacementConfigurationPrimaryVnicSubnetsArgs

InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetail, InstancePoolPlacementConfigurationPrimaryVnicSubnetsIpv6addressIpv6subnetCidrPairDetailArgs

InstancePoolPlacementConfigurationSecondaryVnicSubnet, InstancePoolPlacementConfigurationSecondaryVnicSubnetArgs

InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetail, InstancePoolPlacementConfigurationSecondaryVnicSubnetIpv6addressIpv6subnetCidrPairDetailArgs

Import

Package Details

On this page

On this page

Try Pulumi Cloud free.Your team will thank you.

Try Pulumi Cloud free.
Your team will thank you.