Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
oci.Core.getClusterNetworkInstances
Explore with Pulumi AI
This data source provides the list of Cluster Network Instances in Oracle Cloud Infrastructure Core service.
Lists the instances in a cluster network with instance pools.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testClusterNetworkInstances = oci.Core.getClusterNetworkInstances({
    clusterNetworkId: testClusterNetwork.id,
    compartmentId: compartmentId,
    displayName: clusterNetworkInstanceDisplayName,
});
import pulumi
import pulumi_oci as oci
test_cluster_network_instances = oci.Core.get_cluster_network_instances(cluster_network_id=test_cluster_network["id"],
    compartment_id=compartment_id,
    display_name=cluster_network_instance_display_name)
package main
import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := core.GetClusterNetworkInstances(ctx, &core.GetClusterNetworkInstancesArgs{
			ClusterNetworkId: testClusterNetwork.Id,
			CompartmentId:    compartmentId,
			DisplayName:      pulumi.StringRef(clusterNetworkInstanceDisplayName),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() => 
{
    var testClusterNetworkInstances = Oci.Core.GetClusterNetworkInstances.Invoke(new()
    {
        ClusterNetworkId = testClusterNetwork.Id,
        CompartmentId = compartmentId,
        DisplayName = clusterNetworkInstanceDisplayName,
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.CoreFunctions;
import com.pulumi.oci.Core.inputs.GetClusterNetworkInstancesArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var testClusterNetworkInstances = CoreFunctions.getClusterNetworkInstances(GetClusterNetworkInstancesArgs.builder()
            .clusterNetworkId(testClusterNetwork.id())
            .compartmentId(compartmentId)
            .displayName(clusterNetworkInstanceDisplayName)
            .build());
    }
}
variables:
  testClusterNetworkInstances:
    fn::invoke:
      function: oci:Core:getClusterNetworkInstances
      arguments:
        clusterNetworkId: ${testClusterNetwork.id}
        compartmentId: ${compartmentId}
        displayName: ${clusterNetworkInstanceDisplayName}
Using getClusterNetworkInstances
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getClusterNetworkInstances(args: GetClusterNetworkInstancesArgs, opts?: InvokeOptions): Promise<GetClusterNetworkInstancesResult>
function getClusterNetworkInstancesOutput(args: GetClusterNetworkInstancesOutputArgs, opts?: InvokeOptions): Output<GetClusterNetworkInstancesResult>def get_cluster_network_instances(cluster_network_id: Optional[str] = None,
                                  compartment_id: Optional[str] = None,
                                  display_name: Optional[str] = None,
                                  filters: Optional[Sequence[GetClusterNetworkInstancesFilter]] = None,
                                  opts: Optional[InvokeOptions] = None) -> GetClusterNetworkInstancesResult
def get_cluster_network_instances_output(cluster_network_id: Optional[pulumi.Input[str]] = None,
                                  compartment_id: Optional[pulumi.Input[str]] = None,
                                  display_name: Optional[pulumi.Input[str]] = None,
                                  filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetClusterNetworkInstancesFilterArgs]]]] = None,
                                  opts: Optional[InvokeOptions] = None) -> Output[GetClusterNetworkInstancesResult]func GetClusterNetworkInstances(ctx *Context, args *GetClusterNetworkInstancesArgs, opts ...InvokeOption) (*GetClusterNetworkInstancesResult, error)
func GetClusterNetworkInstancesOutput(ctx *Context, args *GetClusterNetworkInstancesOutputArgs, opts ...InvokeOption) GetClusterNetworkInstancesResultOutput> Note: This function is named GetClusterNetworkInstances in the Go SDK.
public static class GetClusterNetworkInstances 
{
    public static Task<GetClusterNetworkInstancesResult> InvokeAsync(GetClusterNetworkInstancesArgs args, InvokeOptions? opts = null)
    public static Output<GetClusterNetworkInstancesResult> Invoke(GetClusterNetworkInstancesInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetClusterNetworkInstancesResult> getClusterNetworkInstances(GetClusterNetworkInstancesArgs args, InvokeOptions options)
public static Output<GetClusterNetworkInstancesResult> getClusterNetworkInstances(GetClusterNetworkInstancesArgs args, InvokeOptions options)
fn::invoke:
  function: oci:Core/getClusterNetworkInstances:getClusterNetworkInstances
  arguments:
    # arguments dictionaryThe following arguments are supported:
- ClusterNetwork stringId 
- The OCID of the cluster network.
- CompartmentId string
- The OCID of the compartment.
- DisplayName string
- A filter to return only resources that match the given display name exactly.
- Filters
List<GetCluster Network Instances Filter> 
- ClusterNetwork stringId 
- The OCID of the cluster network.
- CompartmentId string
- The OCID of the compartment.
- DisplayName string
- A filter to return only resources that match the given display name exactly.
- Filters
[]GetCluster Network Instances Filter 
- clusterNetwork StringId 
- The OCID of the cluster network.
- compartmentId String
- The OCID of the compartment.
- displayName String
- A filter to return only resources that match the given display name exactly.
- filters
List<GetCluster Network Instances Filter> 
- clusterNetwork stringId 
- The OCID of the cluster network.
- compartmentId string
- The OCID of the compartment.
- displayName string
- A filter to return only resources that match the given display name exactly.
- filters
GetCluster Network Instances Filter[] 
- cluster_network_ strid 
- The OCID of the cluster network.
- compartment_id str
- The OCID of the compartment.
- display_name str
- A filter to return only resources that match the given display name exactly.
- filters
Sequence[GetCluster Network Instances Filter] 
- clusterNetwork StringId 
- The OCID of the cluster network.
- compartmentId String
- The OCID of the compartment.
- displayName String
- A filter to return only resources that match the given display name exactly.
- filters List<Property Map>
getClusterNetworkInstances Result
The following output properties are available:
- ClusterNetwork stringId 
- CompartmentId string
- The OCID of the compartment that contains the instance.
- Id string
- The provider-assigned unique ID for this managed resource.
- Instances
List<GetCluster Network Instances Instance> 
- The list of instances.
- DisplayName string
- A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Filters
List<GetCluster Network Instances Filter> 
- ClusterNetwork stringId 
- CompartmentId string
- The OCID of the compartment that contains the instance.
- Id string
- The provider-assigned unique ID for this managed resource.
- Instances
[]GetCluster Network Instances Instance 
- The list of instances.
- DisplayName string
- A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- Filters
[]GetCluster Network Instances Filter 
- clusterNetwork StringId 
- compartmentId String
- The OCID of the compartment that contains the instance.
- id String
- The provider-assigned unique ID for this managed resource.
- instances
List<GetCluster Network Instances Instance> 
- The list of instances.
- displayName String
- A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- filters
List<GetCluster Network Instances Filter> 
- clusterNetwork stringId 
- compartmentId string
- The OCID of the compartment that contains the instance.
- id string
- The provider-assigned unique ID for this managed resource.
- instances
GetCluster Network Instances Instance[] 
- The list of instances.
- displayName string
- A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- filters
GetCluster Network Instances Filter[] 
- cluster_network_ strid 
- compartment_id str
- The OCID of the compartment that contains the instance.
- id str
- The provider-assigned unique ID for this managed resource.
- instances
Sequence[GetCluster Network Instances Instance] 
- The list of instances.
- display_name str
- A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- filters
Sequence[GetCluster Network Instances Filter] 
- clusterNetwork StringId 
- compartmentId String
- The OCID of the compartment that contains the instance.
- id String
- The provider-assigned unique ID for this managed resource.
- instances List<Property Map>
- The list of instances.
- displayName String
- A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
- filters List<Property Map>
Supporting Types
GetClusterNetworkInstancesFilter    
GetClusterNetworkInstancesInstance    
- AvailabilityDomain string
- The availability domain the instance is running in.
- CompartmentId string
- The OCID of the compartment.
- DisplayName string
- A filter to return only resources that match the given display name exactly.
- FaultDomain string
- The fault domain the instance is running in.
- Id string
- The OCID of the instance.
- InstanceConfiguration stringId 
- The OCID of the instance confgiuration used to create the instance.
- LoadBalancer List<GetBackends Cluster Network Instances Instance Load Balancer Backend> 
- The load balancer backends that are configured for the instance pool instance.
- Region string
- The region that contains the availability domain the instance is running in.
- Shape string
- The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.
- State string
- The current state of the instance pool instance.
- TimeCreated string
- The date and time the instance pool instance was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
- AvailabilityDomain string
- The availability domain the instance is running in.
- CompartmentId string
- The OCID of the compartment.
- DisplayName string
- A filter to return only resources that match the given display name exactly.
- FaultDomain string
- The fault domain the instance is running in.
- Id string
- The OCID of the instance.
- InstanceConfiguration stringId 
- The OCID of the instance confgiuration used to create the instance.
- LoadBalancer []GetBackends Cluster Network Instances Instance Load Balancer Backend 
- The load balancer backends that are configured for the instance pool instance.
- Region string
- The region that contains the availability domain the instance is running in.
- Shape string
- The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.
- State string
- The current state of the instance pool instance.
- TimeCreated string
- The date and time the instance pool instance was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
- availabilityDomain String
- The availability domain the instance is running in.
- compartmentId String
- The OCID of the compartment.
- displayName String
- A filter to return only resources that match the given display name exactly.
- faultDomain String
- The fault domain the instance is running in.
- id String
- The OCID of the instance.
- instanceConfiguration StringId 
- The OCID of the instance confgiuration used to create the instance.
- loadBalancer List<GetBackends Cluster Network Instances Instance Load Balancer Backend> 
- The load balancer backends that are configured for the instance pool instance.
- region String
- The region that contains the availability domain the instance is running in.
- shape String
- The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.
- state String
- The current state of the instance pool instance.
- timeCreated String
- The date and time the instance pool instance was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
- availabilityDomain string
- The availability domain the instance is running in.
- compartmentId string
- The OCID of the compartment.
- displayName string
- A filter to return only resources that match the given display name exactly.
- faultDomain string
- The fault domain the instance is running in.
- id string
- The OCID of the instance.
- instanceConfiguration stringId 
- The OCID of the instance confgiuration used to create the instance.
- loadBalancer GetBackends Cluster Network Instances Instance Load Balancer Backend[] 
- The load balancer backends that are configured for the instance pool instance.
- region string
- The region that contains the availability domain the instance is running in.
- shape string
- The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.
- state string
- The current state of the instance pool instance.
- timeCreated string
- The date and time the instance pool instance was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
- availability_domain str
- The availability domain the instance is running in.
- compartment_id str
- The OCID of the compartment.
- display_name str
- A filter to return only resources that match the given display name exactly.
- fault_domain str
- The fault domain the instance is running in.
- id str
- The OCID of the instance.
- instance_configuration_ strid 
- The OCID of the instance confgiuration used to create the instance.
- load_balancer_ Sequence[Getbackends Cluster Network Instances Instance Load Balancer Backend] 
- The load balancer backends that are configured for the instance pool instance.
- region str
- The region that contains the availability domain the instance is running in.
- shape str
- The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.
- state str
- The current state of the instance pool instance.
- time_created str
- The date and time the instance pool instance was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
- availabilityDomain String
- The availability domain the instance is running in.
- compartmentId String
- The OCID of the compartment.
- displayName String
- A filter to return only resources that match the given display name exactly.
- faultDomain String
- The fault domain the instance is running in.
- id String
- The OCID of the instance.
- instanceConfiguration StringId 
- The OCID of the instance confgiuration used to create the instance.
- loadBalancer List<Property Map>Backends 
- The load balancer backends that are configured for the instance pool instance.
- region String
- The region that contains the availability domain the instance is running in.
- shape String
- The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance.
- state String
- The current state of the instance pool instance.
- timeCreated String
- The date and time the instance pool instance was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
GetClusterNetworkInstancesInstanceLoadBalancerBackend       
- BackendHealth stringStatus 
- The health of the backend as observed by the load balancer.
- BackendName string
- The name of the backend in the backend set.
- BackendSet stringName 
- The name of the backend set on the load balancer.
- LoadBalancer stringId 
- The OCID of the load balancer attached to the instance pool.
- State string
- The current state of the instance pool instance.
- BackendHealth stringStatus 
- The health of the backend as observed by the load balancer.
- BackendName string
- The name of the backend in the backend set.
- BackendSet stringName 
- The name of the backend set on the load balancer.
- LoadBalancer stringId 
- The OCID of the load balancer attached to the instance pool.
- State string
- The current state of the instance pool instance.
- backendHealth StringStatus 
- The health of the backend as observed by the load balancer.
- backendName String
- The name of the backend in the backend set.
- backendSet StringName 
- The name of the backend set on the load balancer.
- loadBalancer StringId 
- The OCID of the load balancer attached to the instance pool.
- state String
- The current state of the instance pool instance.
- backendHealth stringStatus 
- The health of the backend as observed by the load balancer.
- backendName string
- The name of the backend in the backend set.
- backendSet stringName 
- The name of the backend set on the load balancer.
- loadBalancer stringId 
- The OCID of the load balancer attached to the instance pool.
- state string
- The current state of the instance pool instance.
- backend_health_ strstatus 
- The health of the backend as observed by the load balancer.
- backend_name str
- The name of the backend in the backend set.
- backend_set_ strname 
- The name of the backend set on the load balancer.
- load_balancer_ strid 
- The OCID of the load balancer attached to the instance pool.
- state str
- The current state of the instance pool instance.
- backendHealth StringStatus 
- The health of the backend as observed by the load balancer.
- backendName String
- The name of the backend in the backend set.
- backendSet StringName 
- The name of the backend set on the load balancer.
- loadBalancer StringId 
- The OCID of the load balancer attached to the instance pool.
- state String
- The current state of the instance pool instance.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the ociTerraform Provider.