Sign in Dashboard Get started
  1. Packages
  2. Packages
  3. Oracle Cloud Infrastructure
  4. API Docs
  5. Dns
  6. getResolverEndpoint
Viewing docs for Oracle Cloud Infrastructure v4.19.0
published on Thursday, Jul 9, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-oci

oci.Dns.getResolverEndpoint

oci logo
Viewing docs for Oracle Cloud Infrastructure v4.19.0
published on Thursday, Jul 9, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-oci

    This data source provides details about a specific Resolver Endpoint resource in Oracle Cloud Infrastructure DNS service.

    Gets information about a specific resolver endpoint.

    Note that attempting to get a resolver endpoint in the DELETED lifecycle state will result in a 404 response to be consistent with other operations of the API.

    Example Usage

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

const testResolverEndpoint = oci.dns.getResolverEndpoint({
    resolverEndpointName: testResolverEndpointOciDnsResolverEndpoint.name,
    resolverId: testResolver.id,
    scope: "PRIVATE",
});

    import pulumi
import pulumi_oci as oci

test_resolver_endpoint = oci.dns.get_resolver_endpoint(resolver_endpoint_name=test_resolver_endpoint_oci_dns_resolver_endpoint["name"],
    resolver_id=test_resolver["id"],
    scope="PRIVATE")

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := dns.GetResolverEndpoint(ctx, &dns.GetResolverEndpointArgs{
			ResolverEndpointName: testResolverEndpointOciDnsResolverEndpoint.Name,
			ResolverId:           testResolver.Id,
			Scope:                pulumi.StringRef("PRIVATE"),
		}, 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 testResolverEndpoint = Oci.Dns.GetResolverEndpoint.Invoke(new()
    {
        ResolverEndpointName = testResolverEndpointOciDnsResolverEndpoint.Name,
        ResolverId = testResolver.Id,
        Scope = "PRIVATE",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Dns.DnsFunctions;
import com.pulumi.oci.Dns.inputs.GetResolverEndpointArgs;
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 testResolverEndpoint = DnsFunctions.getResolverEndpoint(GetResolverEndpointArgs.builder()
            .resolverEndpointName(testResolverEndpointOciDnsResolverEndpoint.name())
            .resolverId(testResolver.id())
            .scope("PRIVATE")
            .build());

    }
}

    variables:
  testResolverEndpoint:
    fn::invoke:
      function: oci:Dns:getResolverEndpoint
      arguments:
        resolverEndpointName: ${testResolverEndpointOciDnsResolverEndpoint.name}
        resolverId: ${testResolver.id}
        scope: PRIVATE

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

data "oci_dns_getresolverendpoint" "testResolverEndpoint" {
  resolver_endpoint_name = testResolverEndpointOciDnsResolverEndpoint.name
  resolver_id            = testResolver.id
  scope                  = "PRIVATE"
}

    Using getResolverEndpoint

    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 getResolverEndpoint(args: GetResolverEndpointArgs, opts?: InvokeOptions): Promise<GetResolverEndpointResult>
function getResolverEndpointOutput(args: GetResolverEndpointOutputArgs, opts?: InvokeOptions): Output<GetResolverEndpointResult>
    def get_resolver_endpoint(resolver_endpoint_name: Optional[str] = None,
                          resolver_id: Optional[str] = None,
                          scope: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetResolverEndpointResult
def get_resolver_endpoint_output(resolver_endpoint_name: pulumi.Input[Optional[str]] = None,
                          resolver_id: pulumi.Input[Optional[str]] = None,
                          scope: pulumi.Input[Optional[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetResolverEndpointResult]
    func LookupResolverEndpoint(ctx *Context, args *LookupResolverEndpointArgs, opts ...InvokeOption) (*LookupResolverEndpointResult, error)
func LookupResolverEndpointOutput(ctx *Context, args *LookupResolverEndpointOutputArgs, opts ...InvokeOption) LookupResolverEndpointResultOutput

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

    public static class GetResolverEndpoint 
{
    public static Task<GetResolverEndpointResult> InvokeAsync(GetResolverEndpointArgs args, InvokeOptions? opts = null)
    public static Output<GetResolverEndpointResult> Invoke(GetResolverEndpointInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetResolverEndpointResult> getResolverEndpoint(GetResolverEndpointArgs args, InvokeOptions options)
public static Output<GetResolverEndpointResult> getResolverEndpoint(GetResolverEndpointArgs args, InvokeOptions options)

    fn::invoke:
  function: oci:Dns/getResolverEndpoint:getResolverEndpoint
  arguments:
    # arguments dictionary
    data "oci_dns_getresolverendpoint" "name" {
    # arguments
}

    The following arguments are supported:

    ResolverEndpointName string
    The name of the target resolver endpoint.
    ResolverId string
    The OCID of the target resolver.
    Scope string
    Value must be PRIVATE when listing private name resolver endpoints.
    ResolverEndpointName string
    The name of the target resolver endpoint.
    ResolverId string
    The OCID of the target resolver.
    Scope string
    Value must be PRIVATE when listing private name resolver endpoints.
    resolver_endpoint_name string
    The name of the target resolver endpoint.
    resolver_id string
    The OCID of the target resolver.
    scope string
    Value must be PRIVATE when listing private name resolver endpoints.
    resolverEndpointName String
    The name of the target resolver endpoint.
    resolverId String
    The OCID of the target resolver.
    scope String
    Value must be PRIVATE when listing private name resolver endpoints.
    resolverEndpointName string
    The name of the target resolver endpoint.
    resolverId string
    The OCID of the target resolver.
    scope string
    Value must be PRIVATE when listing private name resolver endpoints.
    resolver_endpoint_name str
    The name of the target resolver endpoint.
    resolver_id str
    The OCID of the target resolver.
    scope str
    Value must be PRIVATE when listing private name resolver endpoints.
    resolverEndpointName String
    The name of the target resolver endpoint.
    resolverId String
    The OCID of the target resolver.
    scope String
    Value must be PRIVATE when listing private name resolver endpoints.

    getResolverEndpoint Result

    The following output properties are available:

    CompartmentId string
    The OCID of the owning compartment. This will match the resolver that the resolver endpoint is under and will be updated if the resolver's compartment is changed.
    DefinedTags Dictionary<string, string>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
    EndpointType string
    The type of resolver endpoint. VNIC is currently the only supported type.
    ForwardingAddress string
    An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
    FreeformTags Dictionary<string, string>
    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.
    Id string
    The Terraform ID of the resolver endpoint.
    IsForwarding bool
    A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
    IsListening bool
    A Boolean flag indicating whether or not the resolver endpoint is for listening.
    ListeningAddress string
    An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
    Name string
    The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
    NsgIds List<string>
    An array of network security group OCIDs for the resolver endpoint. These must be part of the VCN that the resolver endpoint is a part of.
    PeId string
    The OCID of the private endpoint resource that this resolver endpoint corresponds to.
    ResolverEndpointName string
    ResolverId string
    The OCID of the resolver.
    SecurityAttributes Dictionary<string, string>
    Security attributes are labels for a resource that can be referenced in a Zero Trust Packet Routing (ZPR) policy to control access to ZPR-supported resources. Example: {"Oracle-DataSecurity-ZPR": {"MaxEgressCount": {"value":"42","mode":"audit"}}}
    Self string
    The canonical absolute URL of the resource.
    State string
    The current state of the resource.
    SubnetId string
    The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
    TimeCreated string
    The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    TimeUpdated string
    The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    VnicId string
    The OCID of the VNIC resource that this resolver endpoint corresponds to.
    Scope string
    CompartmentId string
    The OCID of the owning compartment. This will match the resolver that the resolver endpoint is under and will be updated if the resolver's compartment is changed.
    DefinedTags map[string]string
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
    EndpointType string
    The type of resolver endpoint. VNIC is currently the only supported type.
    ForwardingAddress string
    An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
    FreeformTags map[string]string
    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.
    Id string
    The Terraform ID of the resolver endpoint.
    IsForwarding bool
    A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
    IsListening bool
    A Boolean flag indicating whether or not the resolver endpoint is for listening.
    ListeningAddress string
    An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
    Name string
    The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
    NsgIds []string
    An array of network security group OCIDs for the resolver endpoint. These must be part of the VCN that the resolver endpoint is a part of.
    PeId string
    The OCID of the private endpoint resource that this resolver endpoint corresponds to.
    ResolverEndpointName string
    ResolverId string
    The OCID of the resolver.
    SecurityAttributes map[string]string
    Security attributes are labels for a resource that can be referenced in a Zero Trust Packet Routing (ZPR) policy to control access to ZPR-supported resources. Example: {"Oracle-DataSecurity-ZPR": {"MaxEgressCount": {"value":"42","mode":"audit"}}}
    Self string
    The canonical absolute URL of the resource.
    State string
    The current state of the resource.
    SubnetId string
    The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
    TimeCreated string
    The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    TimeUpdated string
    The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    VnicId string
    The OCID of the VNIC resource that this resolver endpoint corresponds to.
    Scope string
    compartment_id string
    The OCID of the owning compartment. This will match the resolver that the resolver endpoint is under and will be updated if the resolver's compartment is changed.
    defined_tags map(string)
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
    endpoint_type string
    The type of resolver endpoint. VNIC is currently the only supported type.
    forwarding_address string
    An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
    freeform_tags map(string)
    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.
    id string
    The Terraform ID of the resolver endpoint.
    is_forwarding bool
    A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
    is_listening bool
    A Boolean flag indicating whether or not the resolver endpoint is for listening.
    listening_address string
    An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
    name string
    The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
    nsg_ids list(string)
    An array of network security group OCIDs for the resolver endpoint. These must be part of the VCN that the resolver endpoint is a part of.
    pe_id string
    The OCID of the private endpoint resource that this resolver endpoint corresponds to.
    resolver_endpoint_name string
    resolver_id string
    The OCID of the resolver.
    security_attributes map(string)
    Security attributes are labels for a resource that can be referenced in a Zero Trust Packet Routing (ZPR) policy to control access to ZPR-supported resources. Example: {"Oracle-DataSecurity-ZPR": {"MaxEgressCount": {"value":"42","mode":"audit"}}}
    self string
    The canonical absolute URL of the resource.
    state string
    The current state of the resource.
    subnet_id string
    The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
    time_created string
    The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    time_updated string
    The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    vnic_id string
    The OCID of the VNIC resource that this resolver endpoint corresponds to.
    scope string
    compartmentId String
    The OCID of the owning compartment. This will match the resolver that the resolver endpoint is under and will be updated if the resolver's compartment is changed.
    definedTags Map<String,String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
    endpointType String
    The type of resolver endpoint. VNIC is currently the only supported type.
    forwardingAddress String
    An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
    freeformTags Map<String,String>
    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.
    id String
    The Terraform ID of the resolver endpoint.
    isForwarding Boolean
    A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
    isListening Boolean
    A Boolean flag indicating whether or not the resolver endpoint is for listening.
    listeningAddress String
    An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
    name String
    The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
    nsgIds List<String>
    An array of network security group OCIDs for the resolver endpoint. These must be part of the VCN that the resolver endpoint is a part of.
    peId String
    The OCID of the private endpoint resource that this resolver endpoint corresponds to.
    resolverEndpointName String
    resolverId String
    The OCID of the resolver.
    securityAttributes Map<String,String>
    Security attributes are labels for a resource that can be referenced in a Zero Trust Packet Routing (ZPR) policy to control access to ZPR-supported resources. Example: {"Oracle-DataSecurity-ZPR": {"MaxEgressCount": {"value":"42","mode":"audit"}}}
    self String
    The canonical absolute URL of the resource.
    state String
    The current state of the resource.
    subnetId String
    The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
    timeCreated String
    The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    timeUpdated String
    The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    vnicId String
    The OCID of the VNIC resource that this resolver endpoint corresponds to.
    scope String
    compartmentId string
    The OCID of the owning compartment. This will match the resolver that the resolver endpoint is under and will be updated if the resolver's compartment is changed.
    definedTags {[key: string]: string}
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
    endpointType string
    The type of resolver endpoint. VNIC is currently the only supported type.
    forwardingAddress string
    An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
    freeformTags {[key: string]: string}
    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.
    id string
    The Terraform ID of the resolver endpoint.
    isForwarding boolean
    A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
    isListening boolean
    A Boolean flag indicating whether or not the resolver endpoint is for listening.
    listeningAddress string
    An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
    name string
    The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
    nsgIds string[]
    An array of network security group OCIDs for the resolver endpoint. These must be part of the VCN that the resolver endpoint is a part of.
    peId string
    The OCID of the private endpoint resource that this resolver endpoint corresponds to.
    resolverEndpointName string
    resolverId string
    The OCID of the resolver.
    securityAttributes {[key: string]: string}
    Security attributes are labels for a resource that can be referenced in a Zero Trust Packet Routing (ZPR) policy to control access to ZPR-supported resources. Example: {"Oracle-DataSecurity-ZPR": {"MaxEgressCount": {"value":"42","mode":"audit"}}}
    self string
    The canonical absolute URL of the resource.
    state string
    The current state of the resource.
    subnetId string
    The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
    timeCreated string
    The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    timeUpdated string
    The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    vnicId string
    The OCID of the VNIC resource that this resolver endpoint corresponds to.
    scope string
    compartment_id str
    The OCID of the owning compartment. This will match the resolver that the resolver endpoint is under and will be updated if the resolver's compartment is changed.
    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.
    endpoint_type str
    The type of resolver endpoint. VNIC is currently the only supported type.
    forwarding_address str
    An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
    freeform_tags Mapping[str, str]
    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.
    id str
    The Terraform ID of the resolver endpoint.
    is_forwarding bool
    A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
    is_listening bool
    A Boolean flag indicating whether or not the resolver endpoint is for listening.
    listening_address str
    An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
    name str
    The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
    nsg_ids Sequence[str]
    An array of network security group OCIDs for the resolver endpoint. These must be part of the VCN that the resolver endpoint is a part of.
    pe_id str
    The OCID of the private endpoint resource that this resolver endpoint corresponds to.
    resolver_endpoint_name str
    resolver_id str
    The OCID of the resolver.
    security_attributes Mapping[str, str]
    Security attributes are labels for a resource that can be referenced in a Zero Trust Packet Routing (ZPR) policy to control access to ZPR-supported resources. Example: {"Oracle-DataSecurity-ZPR": {"MaxEgressCount": {"value":"42","mode":"audit"}}}
    self str
    The canonical absolute URL of the resource.
    state str
    The current state of the resource.
    subnet_id str
    The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
    time_created str
    The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    time_updated str
    The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    vnic_id str
    The OCID of the VNIC resource that this resolver endpoint corresponds to.
    scope str
    compartmentId String
    The OCID of the owning compartment. This will match the resolver that the resolver endpoint is under and will be updated if the resolver's compartment is changed.
    definedTags Map<String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
    endpointType String
    The type of resolver endpoint. VNIC is currently the only supported type.
    forwardingAddress String
    An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
    freeformTags Map<String>
    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.
    id String
    The Terraform ID of the resolver endpoint.
    isForwarding Boolean
    A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
    isListening Boolean
    A Boolean flag indicating whether or not the resolver endpoint is for listening.
    listeningAddress String
    An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
    name String
    The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
    nsgIds List<String>
    An array of network security group OCIDs for the resolver endpoint. These must be part of the VCN that the resolver endpoint is a part of.
    peId String
    The OCID of the private endpoint resource that this resolver endpoint corresponds to.
    resolverEndpointName String
    resolverId String
    The OCID of the resolver.
    securityAttributes Map<String>
    Security attributes are labels for a resource that can be referenced in a Zero Trust Packet Routing (ZPR) policy to control access to ZPR-supported resources. Example: {"Oracle-DataSecurity-ZPR": {"MaxEgressCount": {"value":"42","mode":"audit"}}}
    self String
    The canonical absolute URL of the resource.
    state String
    The current state of the resource.
    subnetId String
    The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
    timeCreated String
    The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    timeUpdated String
    The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
    vnicId String
    The OCID of the VNIC resource that this resolver endpoint corresponds to.
    scope String

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Viewing docs for Oracle Cloud Infrastructure v4.19.0
    published on Thursday, Jul 9, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-oci

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial