1. Registry
  2. Packages
  3. Oracle Cloud Infrastructure
  4. API Docs
  5. GenerativeAi
  6. getDedicatedAiClusterAllocatableGpus
Viewing docs for Oracle Cloud Infrastructure v5.6.0
published on Thursday, Nov 5, 2026 by Pulumi
oci logo oci logo
Viewing docs for Oracle Cloud Infrastructure v5.6.0
published on Thursday, Nov 5, 2026 by Pulumi

    This data source provides the list of Dedicated Ai Cluster Allocatable Gpus in Oracle Cloud Infrastructure Generative AI service.

    Lists the allocatable GPUs for launching dedicated AI clusters tied to a specific capacity reservation id.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testDedicatedAiClusterAllocatableGpus = oci.generativeai.getDedicatedAiClusterAllocatableGpus({
        capacityReservationId: testCapacityReservation.id,
        compartmentId: compartmentId,
        computeShape: dedicatedAiClusterAllocatableGpuComputeShape,
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_dedicated_ai_cluster_allocatable_gpus = oci.generativeai.get_dedicated_ai_cluster_allocatable_gpus(capacity_reservation_id=test_capacity_reservation["id"],
        compartment_id=compartment_id,
        compute_shape=dedicated_ai_cluster_allocatable_gpu_compute_shape)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-oci/sdk/v5/go/oci/generativeai"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := generativeai.GetDedicatedAiClusterAllocatableGpus(ctx, &generativeai.GetDedicatedAiClusterAllocatableGpusArgs{
    			CapacityReservationId: testCapacityReservation.Id,
    			CompartmentId:         compartmentId,
    			ComputeShape:          pulumi.StringRef(dedicatedAiClusterAllocatableGpuComputeShape),
    		}, 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 testDedicatedAiClusterAllocatableGpus = Oci.GenerativeAi.GetDedicatedAiClusterAllocatableGpus.Invoke(new()
        {
            CapacityReservationId = testCapacityReservation.Id,
            CompartmentId = compartmentId,
            ComputeShape = dedicatedAiClusterAllocatableGpuComputeShape,
        });
    
    });
    
    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.GetDedicatedAiClusterAllocatableGpusArgs;
    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) {
            final var testDedicatedAiClusterAllocatableGpus = GenerativeAiFunctions.getDedicatedAiClusterAllocatableGpus(GetDedicatedAiClusterAllocatableGpusArgs.builder()
                .capacityReservationId(testCapacityReservation.get("id"))
                .compartmentId(compartmentId)
                .computeShape(dedicatedAiClusterAllocatableGpuComputeShape)
                .build());
    
        }
    }
    
    variables:
      testDedicatedAiClusterAllocatableGpus:
        fn::invoke:
          function: oci:GenerativeAi:getDedicatedAiClusterAllocatableGpus
          arguments:
            capacityReservationId: ${testCapacityReservation.id}
            compartmentId: ${compartmentId}
            computeShape: ${dedicatedAiClusterAllocatableGpuComputeShape}
    
    terraform {
      required_providers {
        oci = {
          source = "pulumi/oci"
        }
      }
    }
    
    data "oci_generative_ai_dedicated_ai_cluster_allocatable_gpus" "testDedicatedAiClusterAllocatableGpus" {
      capacity_reservation_id = testCapacityReservation.id
      compartment_id          = compartmentId
      compute_shape           = dedicatedAiClusterAllocatableGpuComputeShape
    }
    

    Using getDedicatedAiClusterAllocatableGpus

    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 getDedicatedAiClusterAllocatableGpus(args: GetDedicatedAiClusterAllocatableGpusArgs, opts?: InvokeOptions): Promise<GetDedicatedAiClusterAllocatableGpusResult>
    function getDedicatedAiClusterAllocatableGpusOutput(args: GetDedicatedAiClusterAllocatableGpusOutputArgs, opts?: InvokeOutputOptions): Output<GetDedicatedAiClusterAllocatableGpusResult>
    def get_dedicated_ai_cluster_allocatable_gpus(capacity_reservation_id: Optional[str] = None,
                                                  compartment_id: Optional[str] = None,
                                                  compute_shape: Optional[str] = None,
                                                  filters: Optional[Sequence[GetDedicatedAiClusterAllocatableGpusFilter]] = None,
                                                  opts: Optional[InvokeOptions] = None) -> GetDedicatedAiClusterAllocatableGpusResult
    def get_dedicated_ai_cluster_allocatable_gpus_output(capacity_reservation_id: pulumi.Input[Optional[str]] = None,
                                                  compartment_id: pulumi.Input[Optional[str]] = None,
                                                  compute_shape: pulumi.Input[Optional[str]] = None,
                                                  filters: pulumi.Input[Optional[Sequence[pulumi.Input[GetDedicatedAiClusterAllocatableGpusFilterArgs]]]] = None,
                                                  opts: Optional[InvokeOutputOptions] = None) -> Output[GetDedicatedAiClusterAllocatableGpusResult]
    func GetDedicatedAiClusterAllocatableGpus(ctx *Context, args *GetDedicatedAiClusterAllocatableGpusArgs, opts ...InvokeOption) (*GetDedicatedAiClusterAllocatableGpusResult, error)
    func GetDedicatedAiClusterAllocatableGpusOutput(ctx *Context, args *GetDedicatedAiClusterAllocatableGpusOutputArgs, opts ...InvokeOption) GetDedicatedAiClusterAllocatableGpusResultOutput

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

    public static class GetDedicatedAiClusterAllocatableGpus 
    {
        public static Task<GetDedicatedAiClusterAllocatableGpusResult> InvokeAsync(GetDedicatedAiClusterAllocatableGpusArgs args, InvokeOptions? opts = null)
        public static Output<GetDedicatedAiClusterAllocatableGpusResult> Invoke(GetDedicatedAiClusterAllocatableGpusInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetDedicatedAiClusterAllocatableGpusResult> Invoke(GetDedicatedAiClusterAllocatableGpusInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetDedicatedAiClusterAllocatableGpusResult> getDedicatedAiClusterAllocatableGpus(GetDedicatedAiClusterAllocatableGpusArgs args, InvokeOptions options)
    public static Output<GetDedicatedAiClusterAllocatableGpusResult> getDedicatedAiClusterAllocatableGpus(GetDedicatedAiClusterAllocatableGpusArgs args, InvokeOptions options)
    public static Output<GetDedicatedAiClusterAllocatableGpusResult> getDedicatedAiClusterAllocatableGpus(GetDedicatedAiClusterAllocatableGpusArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: oci:GenerativeAi/getDedicatedAiClusterAllocatableGpus:getDedicatedAiClusterAllocatableGpus
      arguments:
        # arguments dictionary
    data "oci_generative_ai_get_dedicated_ai_cluster_allocatable_gpus" "name" {
        # arguments
    }

    The following arguments are supported:

    CapacityReservationId string
    The OCID of the capacity reservation.
    CompartmentId string
    The OCID of the compartment in which to list resources.
    ComputeShape string
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    Filters List<GetDedicatedAiClusterAllocatableGpusFilter>
    CapacityReservationId string
    The OCID of the capacity reservation.
    CompartmentId string
    The OCID of the compartment in which to list resources.
    ComputeShape string
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    Filters []GetDedicatedAiClusterAllocatableGpusFilter
    capacity_reservation_id string
    The OCID of the capacity reservation.
    compartment_id string
    The OCID of the compartment in which to list resources.
    compute_shape string
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    filters list(object)
    capacityReservationId String
    The OCID of the capacity reservation.
    compartmentId String
    The OCID of the compartment in which to list resources.
    computeShape String
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    filters List<GetDedicatedAiClusterAllocatableGpusFilter>
    capacityReservationId string
    The OCID of the capacity reservation.
    compartmentId string
    The OCID of the compartment in which to list resources.
    computeShape string
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    filters GetDedicatedAiClusterAllocatableGpusFilter[]
    capacity_reservation_id str
    The OCID of the capacity reservation.
    compartment_id str
    The OCID of the compartment in which to list resources.
    compute_shape str
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    filters Sequence[GetDedicatedAiClusterAllocatableGpusFilter]
    capacityReservationId String
    The OCID of the capacity reservation.
    compartmentId String
    The OCID of the compartment in which to list resources.
    computeShape String
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    filters List<Property Map>

    getDedicatedAiClusterAllocatableGpus Result

    The following output properties are available:

    AllocatableGpuCollections List<GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollection>
    The list of allocatable_gpu_collection.
    CapacityReservationId string
    CompartmentId string
    Id string
    The provider-assigned unique ID for this managed resource.
    ComputeShape string
    The compute shape for the allocatable GPUs.
    Filters List<GetDedicatedAiClusterAllocatableGpusFilter>
    AllocatableGpuCollections []GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollection
    The list of allocatable_gpu_collection.
    CapacityReservationId string
    CompartmentId string
    Id string
    The provider-assigned unique ID for this managed resource.
    ComputeShape string
    The compute shape for the allocatable GPUs.
    Filters []GetDedicatedAiClusterAllocatableGpusFilter
    allocatable_gpu_collections list(object)
    The list of allocatable_gpu_collection.
    capacity_reservation_id string
    compartment_id string
    id string
    The provider-assigned unique ID for this managed resource.
    compute_shape string
    The compute shape for the allocatable GPUs.
    filters list(object)
    allocatableGpuCollections List<GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollection>
    The list of allocatable_gpu_collection.
    capacityReservationId String
    compartmentId String
    id String
    The provider-assigned unique ID for this managed resource.
    computeShape String
    The compute shape for the allocatable GPUs.
    filters List<GetDedicatedAiClusterAllocatableGpusFilter>
    allocatableGpuCollections GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollection[]
    The list of allocatable_gpu_collection.
    capacityReservationId string
    compartmentId string
    id string
    The provider-assigned unique ID for this managed resource.
    computeShape string
    The compute shape for the allocatable GPUs.
    filters GetDedicatedAiClusterAllocatableGpusFilter[]
    allocatable_gpu_collections Sequence[GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollection]
    The list of allocatable_gpu_collection.
    capacity_reservation_id str
    compartment_id str
    id str
    The provider-assigned unique ID for this managed resource.
    compute_shape str
    The compute shape for the allocatable GPUs.
    filters Sequence[GetDedicatedAiClusterAllocatableGpusFilter]
    allocatableGpuCollections List<Property Map>
    The list of allocatable_gpu_collection.
    capacityReservationId String
    compartmentId String
    id String
    The provider-assigned unique ID for this managed resource.
    computeShape String
    The compute shape for the allocatable GPUs.
    filters List<Property Map>

    Supporting Types

    GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollection

    items list(object)
    List of allocatable GPU summaries.
    items List<Property Map>
    List of allocatable GPU summaries.

    GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollectionItem

    ComputeShape string
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    GpuAllocations List<GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollectionItemGpuAllocation>
    The GPU allocation details for the compute shape. Each item represents one underlying capacity allocation.
    MaxAllocatableGpuUnits int
    The maximum number of GPU units that can be allocated to a single dedicated AI cluster for the compute shape without requiring additional provisioning.
    TotalAvailableGpuUnits int
    The total number of available GPU units for the compute shape.
    TotalUsedGpuUnits int
    The total number of used GPU units for the compute shape.
    ComputeShape string
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    GpuAllocations []GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollectionItemGpuAllocation
    The GPU allocation details for the compute shape. Each item represents one underlying capacity allocation.
    MaxAllocatableGpuUnits int
    The maximum number of GPU units that can be allocated to a single dedicated AI cluster for the compute shape without requiring additional provisioning.
    TotalAvailableGpuUnits int
    The total number of available GPU units for the compute shape.
    TotalUsedGpuUnits int
    The total number of used GPU units for the compute shape.
    compute_shape string
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    gpu_allocations list(object)
    The GPU allocation details for the compute shape. Each item represents one underlying capacity allocation.
    max_allocatable_gpu_units number
    The maximum number of GPU units that can be allocated to a single dedicated AI cluster for the compute shape without requiring additional provisioning.
    total_available_gpu_units number
    The total number of available GPU units for the compute shape.
    total_used_gpu_units number
    The total number of used GPU units for the compute shape.
    computeShape String
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    gpuAllocations List<GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollectionItemGpuAllocation>
    The GPU allocation details for the compute shape. Each item represents one underlying capacity allocation.
    maxAllocatableGpuUnits Integer
    The maximum number of GPU units that can be allocated to a single dedicated AI cluster for the compute shape without requiring additional provisioning.
    totalAvailableGpuUnits Integer
    The total number of available GPU units for the compute shape.
    totalUsedGpuUnits Integer
    The total number of used GPU units for the compute shape.
    computeShape string
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    gpuAllocations GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollectionItemGpuAllocation[]
    The GPU allocation details for the compute shape. Each item represents one underlying capacity allocation.
    maxAllocatableGpuUnits number
    The maximum number of GPU units that can be allocated to a single dedicated AI cluster for the compute shape without requiring additional provisioning.
    totalAvailableGpuUnits number
    The total number of available GPU units for the compute shape.
    totalUsedGpuUnits number
    The total number of used GPU units for the compute shape.
    compute_shape str
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    gpu_allocations Sequence[GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollectionItemGpuAllocation]
    The GPU allocation details for the compute shape. Each item represents one underlying capacity allocation.
    max_allocatable_gpu_units int
    The maximum number of GPU units that can be allocated to a single dedicated AI cluster for the compute shape without requiring additional provisioning.
    total_available_gpu_units int
    The total number of available GPU units for the compute shape.
    total_used_gpu_units int
    The total number of used GPU units for the compute shape.
    computeShape String
    The compute shape to use to filter allocatable GPUs. For example, BM.GPU.A10.4.
    gpuAllocations List<Property Map>
    The GPU allocation details for the compute shape. Each item represents one underlying capacity allocation.
    maxAllocatableGpuUnits Number
    The maximum number of GPU units that can be allocated to a single dedicated AI cluster for the compute shape without requiring additional provisioning.
    totalAvailableGpuUnits Number
    The total number of available GPU units for the compute shape.
    totalUsedGpuUnits Number
    The total number of used GPU units for the compute shape.

    GetDedicatedAiClusterAllocatableGpusAllocatableGpuCollectionItemGpuAllocation

    AvailableGpus int
    The number of available GPUs in this allocation.
    UsedGpus int
    The number of used GPUs in this allocation.
    AvailableGpus int
    The number of available GPUs in this allocation.
    UsedGpus int
    The number of used GPUs in this allocation.
    available_gpus number
    The number of available GPUs in this allocation.
    used_gpus number
    The number of used GPUs in this allocation.
    availableGpus Integer
    The number of available GPUs in this allocation.
    usedGpus Integer
    The number of used GPUs in this allocation.
    availableGpus number
    The number of available GPUs in this allocation.
    usedGpus number
    The number of used GPUs in this allocation.
    available_gpus int
    The number of available GPUs in this allocation.
    used_gpus int
    The number of used GPUs in this allocation.
    availableGpus Number
    The number of available GPUs in this allocation.
    usedGpus Number
    The number of used GPUs in this allocation.

    GetDedicatedAiClusterAllocatableGpusFilter

    Name string
    Values List<string>
    Regex bool
    Name string
    Values []string
    Regex bool
    name string
    values list(string)
    regex bool
    name String
    values List<String>
    regex Boolean
    name string
    values string[]
    regex boolean
    name str
    values Sequence[str]
    regex bool
    name String
    values List<String>
    regex Boolean

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo oci logo
    Viewing docs for Oracle Cloud Infrastructure v5.6.0
    published on Thursday, Nov 5, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial