1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. GenerativeAi
  5. getEndpoints
Oracle Cloud Infrastructure v3.10.0 published on Wednesday, Nov 5, 2025 by Pulumi

oci.GenerativeAi.getEndpoints

Start a Neo task
Explain and create an oci.GenerativeAi.getEndpoints resource
oci logo
Oracle Cloud Infrastructure v3.10.0 published on Wednesday, Nov 5, 2025 by Pulumi

    This data source provides the list of Endpoints in Oracle Cloud Infrastructure Generative AI service.

    Lists the endpoints of a specific compartment.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testEndpoints = oci.GenerativeAi.getEndpoints({
        compartmentId: compartmentId,
        displayName: endpointDisplayName,
        generativeAiPrivateEndpointId: testGenerativeAiPrivateEndpoint.id,
        id: endpointId,
        state: endpointState,
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_endpoints = oci.GenerativeAi.get_endpoints(compartment_id=compartment_id,
        display_name=endpoint_display_name,
        generative_ai_private_endpoint_id=test_generative_ai_private_endpoint["id"],
        id=endpoint_id,
        state=endpoint_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.GetEndpoints(ctx, &generativeai.GetEndpointsArgs{
    			CompartmentId:                 compartmentId,
    			DisplayName:                   pulumi.StringRef(endpointDisplayName),
    			GenerativeAiPrivateEndpointId: pulumi.StringRef(testGenerativeAiPrivateEndpoint.Id),
    			Id:                            pulumi.StringRef(endpointId),
    			State:                         pulumi.StringRef(endpointState),
    		}, 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 testEndpoints = Oci.GenerativeAi.GetEndpoints.Invoke(new()
        {
            CompartmentId = compartmentId,
            DisplayName = endpointDisplayName,
            GenerativeAiPrivateEndpointId = testGenerativeAiPrivateEndpoint.Id,
            Id = endpointId,
            State = endpointState,
        });
    
    });
    
    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.GetEndpointsArgs;
    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 testEndpoints = GenerativeAiFunctions.getEndpoints(GetEndpointsArgs.builder()
                .compartmentId(compartmentId)
                .displayName(endpointDisplayName)
                .generativeAiPrivateEndpointId(testGenerativeAiPrivateEndpoint.id())
                .id(endpointId)
                .state(endpointState)
                .build());
    
        }
    }
    
    variables:
      testEndpoints:
        fn::invoke:
          function: oci:GenerativeAi:getEndpoints
          arguments:
            compartmentId: ${compartmentId}
            displayName: ${endpointDisplayName}
            generativeAiPrivateEndpointId: ${testGenerativeAiPrivateEndpoint.id}
            id: ${endpointId}
            state: ${endpointState}
    

    Using getEndpoints

    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 getEndpoints(args: GetEndpointsArgs, opts?: InvokeOptions): Promise<GetEndpointsResult>
    function getEndpointsOutput(args: GetEndpointsOutputArgs, opts?: InvokeOptions): Output<GetEndpointsResult>
    def get_endpoints(compartment_id: Optional[str] = None,
                      display_name: Optional[str] = None,
                      filters: Optional[Sequence[GetEndpointsFilter]] = None,
                      generative_ai_private_endpoint_id: Optional[str] = None,
                      id: Optional[str] = None,
                      state: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetEndpointsResult
    def get_endpoints_output(compartment_id: Optional[pulumi.Input[str]] = None,
                      display_name: Optional[pulumi.Input[str]] = None,
                      filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetEndpointsFilterArgs]]]] = None,
                      generative_ai_private_endpoint_id: Optional[pulumi.Input[str]] = None,
                      id: Optional[pulumi.Input[str]] = None,
                      state: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetEndpointsResult]
    func GetEndpoints(ctx *Context, args *GetEndpointsArgs, opts ...InvokeOption) (*GetEndpointsResult, error)
    func GetEndpointsOutput(ctx *Context, args *GetEndpointsOutputArgs, opts ...InvokeOption) GetEndpointsResultOutput

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

    public static class GetEndpoints 
    {
        public static Task<GetEndpointsResult> InvokeAsync(GetEndpointsArgs args, InvokeOptions? opts = null)
        public static Output<GetEndpointsResult> Invoke(GetEndpointsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetEndpointsResult> getEndpoints(GetEndpointsArgs args, InvokeOptions options)
    public static Output<GetEndpointsResult> getEndpoints(GetEndpointsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: oci:GenerativeAi/getEndpoints:getEndpoints
      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<GetEndpointsFilter>
    GenerativeAiPrivateEndpointId string
    The OCID of the private endpoint.
    Id string
    The OCID of the endpoint.
    State string
    A filter to return only resources 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 []GetEndpointsFilter
    GenerativeAiPrivateEndpointId string
    The OCID of the private endpoint.
    Id string
    The OCID of the endpoint.
    State string
    A filter to return only resources 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<GetEndpointsFilter>
    generativeAiPrivateEndpointId String
    The OCID of the private endpoint.
    id String
    The OCID of the endpoint.
    state String
    A filter to return only resources 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 GetEndpointsFilter[]
    generativeAiPrivateEndpointId string
    The OCID of the private endpoint.
    id string
    The OCID of the endpoint.
    state string
    A filter to return only resources 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[GetEndpointsFilter]
    generative_ai_private_endpoint_id str
    The OCID of the private endpoint.
    id str
    The OCID of the endpoint.
    state str
    A filter to return only resources 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>
    generativeAiPrivateEndpointId String
    The OCID of the private endpoint.
    id String
    The OCID of the endpoint.
    state String
    A filter to return only resources that their lifecycle state matches the given lifecycle state.

    getEndpoints Result

    The following output properties are available:

    CompartmentId string
    EndpointCollections List<GetEndpointsEndpointCollection>
    The list of endpoint_collection.
    DisplayName string
    Filters List<GetEndpointsFilter>
    GenerativeAiPrivateEndpointId string
    Id string
    State string
    The current state of the endpoint.
    CompartmentId string
    EndpointCollections []GetEndpointsEndpointCollection
    The list of endpoint_collection.
    DisplayName string
    Filters []GetEndpointsFilter
    GenerativeAiPrivateEndpointId string
    Id string
    State string
    The current state of the endpoint.
    compartmentId String
    endpointCollections List<GetEndpointsEndpointCollection>
    The list of endpoint_collection.
    displayName String
    filters List<GetEndpointsFilter>
    generativeAiPrivateEndpointId String
    id String
    state String
    The current state of the endpoint.
    compartmentId string
    endpointCollections GetEndpointsEndpointCollection[]
    The list of endpoint_collection.
    displayName string
    filters GetEndpointsFilter[]
    generativeAiPrivateEndpointId string
    id string
    state string
    The current state of the endpoint.
    compartmentId String
    endpointCollections List<Property Map>
    The list of endpoint_collection.
    displayName String
    filters List<Property Map>
    generativeAiPrivateEndpointId String
    id String
    state String
    The current state of the endpoint.

    Supporting Types

    GetEndpointsEndpointCollection

    GetEndpointsEndpointCollectionItem

    CompartmentId string
    The OCID of the compartment in which to list resources.
    ContentModerationConfigs List<GetEndpointsEndpointCollectionItemContentModerationConfig>
    The configuration details, whether to add the content moderation feature to the model. Content moderation removes toxic and biased content from responses.
    DedicatedAiClusterId string
    The OCID of the dedicated AI cluster on which the model will be deployed to.
    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
    DisplayName string
    A filter to return only resources that match the given display name exactly.
    FreeformTags Dictionary<string, string>
    GenerativeAiPrivateEndpointId string
    The OCID of the private endpoint.
    Id string
    The OCID of the endpoint.
    LifecycleDetails string
    A message describing the current state of the endpoint in more detail that can provide actionable information.
    ModelId string
    The OCID of the model used for the feature.
    State string
    A filter to return only resources 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
    CompartmentId string
    The OCID of the compartment in which to list resources.
    ContentModerationConfigs []GetEndpointsEndpointCollectionItemContentModerationConfig
    The configuration details, whether to add the content moderation feature to the model. Content moderation removes toxic and biased content from responses.
    DedicatedAiClusterId string
    The OCID of the dedicated AI cluster on which the model will be deployed to.
    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
    DisplayName string
    A filter to return only resources that match the given display name exactly.
    FreeformTags map[string]string
    GenerativeAiPrivateEndpointId string
    The OCID of the private endpoint.
    Id string
    The OCID of the endpoint.
    LifecycleDetails string
    A message describing the current state of the endpoint in more detail that can provide actionable information.
    ModelId string
    The OCID of the model used for the feature.
    State string
    A filter to return only resources 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
    compartmentId String
    The OCID of the compartment in which to list resources.
    contentModerationConfigs List<GetEndpointsEndpointCollectionItemContentModerationConfig>
    The configuration details, whether to add the content moderation feature to the model. Content moderation removes toxic and biased content from responses.
    dedicatedAiClusterId String
    The OCID of the dedicated AI cluster on which the model will be deployed to.
    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
    displayName String
    A filter to return only resources that match the given display name exactly.
    freeformTags Map<String,String>
    generativeAiPrivateEndpointId String
    The OCID of the private endpoint.
    id String
    The OCID of the endpoint.
    lifecycleDetails String
    A message describing the current state of the endpoint in more detail that can provide actionable information.
    modelId String
    The OCID of the model used for the feature.
    state String
    A filter to return only resources 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
    compartmentId string
    The OCID of the compartment in which to list resources.
    contentModerationConfigs GetEndpointsEndpointCollectionItemContentModerationConfig[]
    The configuration details, whether to add the content moderation feature to the model. Content moderation removes toxic and biased content from responses.
    dedicatedAiClusterId string
    The OCID of the dedicated AI cluster on which the model will be deployed to.
    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
    displayName string
    A filter to return only resources that match the given display name exactly.
    freeformTags {[key: string]: string}
    generativeAiPrivateEndpointId string
    The OCID of the private endpoint.
    id string
    The OCID of the endpoint.
    lifecycleDetails string
    A message describing the current state of the endpoint in more detail that can provide actionable information.
    modelId string
    The OCID of the model used for the feature.
    state string
    A filter to return only resources 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
    compartment_id str
    The OCID of the compartment in which to list resources.
    content_moderation_configs Sequence[GetEndpointsEndpointCollectionItemContentModerationConfig]
    The configuration details, whether to add the content moderation feature to the model. Content moderation removes toxic and biased content from responses.
    dedicated_ai_cluster_id str
    The OCID of the dedicated AI cluster on which the model will be deployed to.
    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
    display_name str
    A filter to return only resources that match the given display name exactly.
    freeform_tags Mapping[str, str]
    generative_ai_private_endpoint_id str
    The OCID of the private endpoint.
    id str
    The OCID of the endpoint.
    lifecycle_details str
    A message describing the current state of the endpoint in more detail that can provide actionable information.
    model_id str
    The OCID of the model used for the feature.
    state str
    A filter to return only resources 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
    compartmentId String
    The OCID of the compartment in which to list resources.
    contentModerationConfigs List<Property Map>
    The configuration details, whether to add the content moderation feature to the model. Content moderation removes toxic and biased content from responses.
    dedicatedAiClusterId String
    The OCID of the dedicated AI cluster on which the model will be deployed to.
    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
    displayName String
    A filter to return only resources that match the given display name exactly.
    freeformTags Map<String>
    generativeAiPrivateEndpointId String
    The OCID of the private endpoint.
    id String
    The OCID of the endpoint.
    lifecycleDetails String
    A message describing the current state of the endpoint in more detail that can provide actionable information.
    modelId String
    The OCID of the model used for the feature.
    state String
    A filter to return only resources 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

    GetEndpointsEndpointCollectionItemContentModerationConfig

    IsEnabled bool
    Whether to enable the content moderation feature.
    Mode string
    Enum for the modes of operation for inference protection.
    ModelId string
    The OCID of the model used for the feature.
    IsEnabled bool
    Whether to enable the content moderation feature.
    Mode string
    Enum for the modes of operation for inference protection.
    ModelId string
    The OCID of the model used for the feature.
    isEnabled Boolean
    Whether to enable the content moderation feature.
    mode String
    Enum for the modes of operation for inference protection.
    modelId String
    The OCID of the model used for the feature.
    isEnabled boolean
    Whether to enable the content moderation feature.
    mode string
    Enum for the modes of operation for inference protection.
    modelId string
    The OCID of the model used for the feature.
    is_enabled bool
    Whether to enable the content moderation feature.
    mode str
    Enum for the modes of operation for inference protection.
    model_id str
    The OCID of the model used for the feature.
    isEnabled Boolean
    Whether to enable the content moderation feature.
    mode String
    Enum for the modes of operation for inference protection.
    modelId String
    The OCID of the model used for the feature.

    GetEndpointsFilter

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

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Oracle Cloud Infrastructure v3.10.0 published on Wednesday, Nov 5, 2025 by Pulumi
      Meet Neo: Your AI Platform Teammate