Oracle Cloud Infrastructure v3.10.0, Nov 5 25

Oracle Cloud Infrastructure v3.10.0 published on Wednesday, Nov 5, 2025 by Pulumi

oci.GenerativeAi.getDedicatedAiClusters

Start a Neo task

Explain and create an oci.GenerativeAi.getDedicatedAiClusters resource

Oracle Cloud Infrastructure v3.10.0 published on Wednesday, Nov 5, 2025 by Pulumi

pulumi/pulumi-oci

Example Usage

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

const testDedicatedAiClusters = oci.GenerativeAi.getDedicatedAiClusters({
    compartmentId: compartmentId,
    displayName: dedicatedAiClusterDisplayName,
    id: dedicatedAiClusterId,
    state: dedicatedAiClusterState,
});

import pulumi
import pulumi_oci as oci

test_dedicated_ai_clusters = oci.GenerativeAi.get_dedicated_ai_clusters(compartment_id=compartment_id,
    display_name=dedicated_ai_cluster_display_name,
    id=dedicated_ai_cluster_id,
    state=dedicated_ai_cluster_state)

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := generativeai.GetDedicatedAiClusters(ctx, &generativeai.GetDedicatedAiClustersArgs{
			CompartmentId: compartmentId,
			DisplayName:   pulumi.StringRef(dedicatedAiClusterDisplayName),
			Id:            pulumi.StringRef(dedicatedAiClusterId),
			State:         pulumi.StringRef(dedicatedAiClusterState),
		}, 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 testDedicatedAiClusters = Oci.GenerativeAi.GetDedicatedAiClusters.Invoke(new()
    {
        CompartmentId = compartmentId,
        DisplayName = dedicatedAiClusterDisplayName,
        Id = dedicatedAiClusterId,
        State = dedicatedAiClusterState,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.GenerativeAi.GenerativeAiFunctions;
import com.pulumi.oci.GenerativeAi.inputs.GetDedicatedAiClustersArgs;
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 testDedicatedAiClusters = GenerativeAiFunctions.getDedicatedAiClusters(GetDedicatedAiClustersArgs.builder()
            .compartmentId(compartmentId)
            .displayName(dedicatedAiClusterDisplayName)
            .id(dedicatedAiClusterId)
            .state(dedicatedAiClusterState)
            .build());

    }
}

variables:
  testDedicatedAiClusters:
    fn::invoke:
      function: oci:GenerativeAi:getDedicatedAiClusters
      arguments:
        compartmentId: ${compartmentId}
        displayName: ${dedicatedAiClusterDisplayName}
        id: ${dedicatedAiClusterId}
        state: ${dedicatedAiClusterState}

Using getDedicatedAiClusters

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 getDedicatedAiClusters(args: GetDedicatedAiClustersArgs, opts?: InvokeOptions): Promise<GetDedicatedAiClustersResult>
function getDedicatedAiClustersOutput(args: GetDedicatedAiClustersOutputArgs, opts?: InvokeOptions): Output<GetDedicatedAiClustersResult>

def get_dedicated_ai_clusters(compartment_id: Optional[str] = None,
                              display_name: Optional[str] = None,
                              filters: Optional[Sequence[GetDedicatedAiClustersFilter]] = None,
                              id: Optional[str] = None,
                              state: Optional[str] = None,
                              opts: Optional[InvokeOptions] = None) -> GetDedicatedAiClustersResult
def get_dedicated_ai_clusters_output(compartment_id: Optional[pulumi.Input[str]] = None,
                              display_name: Optional[pulumi.Input[str]] = None,
                              filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetDedicatedAiClustersFilterArgs]]]] = None,
                              id: Optional[pulumi.Input[str]] = None,
                              state: Optional[pulumi.Input[str]] = None,
                              opts: Optional[InvokeOptions] = None) -> Output[GetDedicatedAiClustersResult]

func GetDedicatedAiClusters(ctx *Context, args *GetDedicatedAiClustersArgs, opts ...InvokeOption) (*GetDedicatedAiClustersResult, error)
func GetDedicatedAiClustersOutput(ctx *Context, args *GetDedicatedAiClustersOutputArgs, opts ...InvokeOption) GetDedicatedAiClustersResultOutput

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

public static class GetDedicatedAiClusters 
{
    public static Task<GetDedicatedAiClustersResult> InvokeAsync(GetDedicatedAiClustersArgs args, InvokeOptions? opts = null)
    public static Output<GetDedicatedAiClustersResult> Invoke(GetDedicatedAiClustersInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetDedicatedAiClustersResult> getDedicatedAiClusters(GetDedicatedAiClustersArgs args, InvokeOptions options)
public static Output<GetDedicatedAiClustersResult> getDedicatedAiClusters(GetDedicatedAiClustersArgs args, InvokeOptions options)

fn::invoke:
  function: oci:GenerativeAi/getDedicatedAiClusters:getDedicatedAiClusters
  arguments:
    # arguments dictionary

The following arguments are supported:

CompartmentId string: The OCID of the compartment in which to list resources.
DisplayName string: A filter to return only resources that match the given display name exactly.
Filters List<GetDedicatedAiClustersFilter>
Id string: The OCID of the dedicated AI cluster.
State string: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.

CompartmentId string: The OCID of the compartment in which to list resources.
DisplayName string: A filter to return only resources that match the given display name exactly.
Filters []GetDedicatedAiClustersFilter
Id string: The OCID of the dedicated AI cluster.
State string: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.

compartmentId String: The OCID of the compartment in which to list resources.
displayName String: A filter to return only resources that match the given display name exactly.
filters List<GetDedicatedAiClustersFilter>
id String: The OCID of the dedicated AI cluster.
state String: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.

compartmentId string: The OCID of the compartment in which to list resources.
displayName string: A filter to return only resources that match the given display name exactly.
filters GetDedicatedAiClustersFilter[]
id string: The OCID of the dedicated AI cluster.
state string: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.

compartment_id str: The OCID of the compartment in which to list resources.
display_name str: A filter to return only resources that match the given display name exactly.
filters Sequence[GetDedicatedAiClustersFilter]
id str: The OCID of the dedicated AI cluster.
state str: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.

compartmentId String: The OCID of the compartment in which to list resources.
displayName String: A filter to return only resources that match the given display name exactly.
filters List<Property Map>
id String: The OCID of the dedicated AI cluster.
state String: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.

getDedicatedAiClusters Result

The following output properties are available:

CompartmentId string
DedicatedAiClusterCollections List<GetDedicatedAiClustersDedicatedAiClusterCollection>: The list of dedicated_ai_cluster_collection.
DisplayName string: A user-friendly name. Does not have to be unique, and it's changeable.
Filters List<GetDedicatedAiClustersFilter>
Id string: The OCID of the dedicated AI cluster.
State string: The current state of the dedicated AI cluster.

CompartmentId string
DedicatedAiClusterCollections []GetDedicatedAiClustersDedicatedAiClusterCollection: The list of dedicated_ai_cluster_collection.
DisplayName string: A user-friendly name. Does not have to be unique, and it's changeable.
Filters []GetDedicatedAiClustersFilter
Id string: The OCID of the dedicated AI cluster.
State string: The current state of the dedicated AI cluster.

compartmentId String
dedicatedAiClusterCollections List<GetDedicatedAiClustersDedicatedAiClusterCollection>: The list of dedicated_ai_cluster_collection.
displayName String: A user-friendly name. Does not have to be unique, and it's changeable.
filters List<GetDedicatedAiClustersFilter>
id String: The OCID of the dedicated AI cluster.
state String: The current state of the dedicated AI cluster.

compartmentId string
dedicatedAiClusterCollections GetDedicatedAiClustersDedicatedAiClusterCollection[]: The list of dedicated_ai_cluster_collection.
displayName string: A user-friendly name. Does not have to be unique, and it's changeable.
filters GetDedicatedAiClustersFilter[]
id string: The OCID of the dedicated AI cluster.
state string: The current state of the dedicated AI cluster.

compartment_id str
dedicated_ai_cluster_collections Sequence[GetDedicatedAiClustersDedicatedAiClusterCollection]: The list of dedicated_ai_cluster_collection.
display_name str: A user-friendly name. Does not have to be unique, and it's changeable.
filters Sequence[GetDedicatedAiClustersFilter]
id str: The OCID of the dedicated AI cluster.
state str: The current state of the dedicated AI cluster.

compartmentId String
dedicatedAiClusterCollections List<Property Map>: The list of dedicated_ai_cluster_collection.
displayName String: A user-friendly name. Does not have to be unique, and it's changeable.
filters List<Property Map>
id String: The OCID of the dedicated AI cluster.
state String: The current state of the dedicated AI cluster.

Supporting Types

GetDedicatedAiClustersDedicatedAiClusterCollection

Items List<GetDedicatedAiClustersDedicatedAiClusterCollectionItem>

Items []GetDedicatedAiClustersDedicatedAiClusterCollectionItem

items List<GetDedicatedAiClustersDedicatedAiClusterCollectionItem>

items GetDedicatedAiClustersDedicatedAiClusterCollectionItem[]

items Sequence[GetDedicatedAiClustersDedicatedAiClusterCollectionItem]

items List<Property Map>

GetDedicatedAiClustersDedicatedAiClusterCollectionItem

Capacities List<GetDedicatedAiClustersDedicatedAiClusterCollectionItemCapacity>
CompartmentId string: The OCID of the compartment in which to list resources.
DefinedTags Dictionary<string, string>: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
Description string: An optional description of the dedicated AI cluster.
DisplayName string: A filter to return only resources that match the given display name exactly.
FreeformTags Dictionary<string, string>
Id string: The OCID of the dedicated AI cluster.
LifecycleDetails string: A message describing the current state with detail that can provide actionable information.
State string: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.
SystemTags Dictionary<string, string>: System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
TimeCreated string
TimeUpdated string: The date and time the dedicated AI cluster was updated, in the format defined by RFC 3339
Type string
UnitCount int: The number of dedicated units in this AI cluster.
UnitShape string: The shape of dedicated unit in this AI cluster. The underlying hardware configuration is hidden from customers.

Capacities []GetDedicatedAiClustersDedicatedAiClusterCollectionItemCapacity
CompartmentId string: The OCID of the compartment in which to list resources.
DefinedTags map[string]string: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
Description string: An optional description of the dedicated AI cluster.
DisplayName string: A filter to return only resources that match the given display name exactly.
FreeformTags map[string]string
Id string: The OCID of the dedicated AI cluster.
LifecycleDetails string: A message describing the current state with detail that can provide actionable information.
State string: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.
SystemTags map[string]string: System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
TimeCreated string
TimeUpdated string: The date and time the dedicated AI cluster was updated, in the format defined by RFC 3339
Type string
UnitCount int: The number of dedicated units in this AI cluster.
UnitShape string: The shape of dedicated unit in this AI cluster. The underlying hardware configuration is hidden from customers.

capacities List<GetDedicatedAiClustersDedicatedAiClusterCollectionItemCapacity>
compartmentId String: The OCID of the compartment in which to list resources.
definedTags Map<String,String>: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description String: An optional description of the dedicated AI cluster.
displayName String: A filter to return only resources that match the given display name exactly.
freeformTags Map<String,String>
id String: The OCID of the dedicated AI cluster.
lifecycleDetails String: A message describing the current state with detail that can provide actionable information.
state String: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.
systemTags Map<String,String>: System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
timeCreated String
timeUpdated String: The date and time the dedicated AI cluster was updated, in the format defined by RFC 3339
type String
unitCount Integer: The number of dedicated units in this AI cluster.
unitShape String: The shape of dedicated unit in this AI cluster. The underlying hardware configuration is hidden from customers.

capacities GetDedicatedAiClustersDedicatedAiClusterCollectionItemCapacity[]
compartmentId string: The OCID of the compartment in which to list resources.
definedTags {[key: string]: string}: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description string: An optional description of the dedicated AI cluster.
displayName string: A filter to return only resources that match the given display name exactly.
freeformTags {[key: string]: string}
id string: The OCID of the dedicated AI cluster.
lifecycleDetails string: A message describing the current state with detail that can provide actionable information.
state string: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.
systemTags {[key: string]: string}: System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
timeCreated string
timeUpdated string: The date and time the dedicated AI cluster was updated, in the format defined by RFC 3339
type string
unitCount number: The number of dedicated units in this AI cluster.
unitShape string: The shape of dedicated unit in this AI cluster. The underlying hardware configuration is hidden from customers.

capacities Sequence[GetDedicatedAiClustersDedicatedAiClusterCollectionItemCapacity]
compartment_id str: The OCID of the compartment in which to list resources.
defined_tags Mapping[str, str]: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description str: An optional description of the dedicated AI cluster.
display_name str: A filter to return only resources that match the given display name exactly.
freeform_tags Mapping[str, str]
id str: The OCID of the dedicated AI cluster.
lifecycle_details str: A message describing the current state with detail that can provide actionable information.
state str: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.
system_tags Mapping[str, str]: System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
time_created str
time_updated str: The date and time the dedicated AI cluster was updated, in the format defined by RFC 3339
type str
unit_count int: The number of dedicated units in this AI cluster.
unit_shape str: The shape of dedicated unit in this AI cluster. The underlying hardware configuration is hidden from customers.

capacities List<Property Map>
compartmentId String: The OCID of the compartment in which to list resources.
definedTags Map<String>: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description String: An optional description of the dedicated AI cluster.
displayName String: A filter to return only resources that match the given display name exactly.
freeformTags Map<String>
id String: The OCID of the dedicated AI cluster.
lifecycleDetails String: A message describing the current state with detail that can provide actionable information.
state String: A filter to return only the dedicated AI clusters that their lifecycle state matches the given lifecycle state.
systemTags Map<String>: System tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}
timeCreated String
timeUpdated String: The date and time the dedicated AI cluster was updated, in the format defined by RFC 3339
type String
unitCount Number: The number of dedicated units in this AI cluster.
unitShape String: The shape of dedicated unit in this AI cluster. The underlying hardware configuration is hidden from customers.