1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Dns
  5. getResolverEndpoint
Oracle Cloud Infrastructure v1.41.0 published on Wednesday, Jun 19, 2024 by Pulumi

oci.Dns.getResolverEndpoint

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v1.41.0 published on Wednesday, Jun 19, 2024 by Pulumi

    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. Requires a PRIVATE scope query parameter.

    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/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.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 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
    

    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: Optional[pulumi.Input[str]] = None,
                              resolver_id: Optional[pulumi.Input[str]] = None,
                              scope: Optional[pulumi.Input[str]] = None,
                              opts: Optional[InvokeOptions] = None) -> Output[GetResolverEndpointResult]
    func GetResolverEndpoint(ctx *Context, args *GetResolverEndpointArgs, opts ...InvokeOption) (*GetResolverEndpointResult, error)
    func GetResolverEndpointOutput(ctx *Context, args *GetResolverEndpointOutputArgs, opts ...InvokeOption) GetResolverEndpointResultOutput

    > Note: This function is named GetResolverEndpoint 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)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: oci:Dns/getResolverEndpoint:getResolverEndpoint
      arguments:
        # arguments dictionary

    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.
    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.
    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.
    Id string
    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.
    ResolverEndpointName string
    ResolverId string
    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.
    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.
    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.
    Id string
    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.
    ResolverEndpointName string
    ResolverId string
    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.
    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.
    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.
    id String
    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.
    resolverEndpointName String
    resolverId String
    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.
    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.
    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.
    id string
    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.
    resolverEndpointName string
    resolverId string
    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.
    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.
    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.
    id str
    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.
    resolver_endpoint_name str
    resolver_id str
    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.
    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.
    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.
    id String
    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.
    resolverEndpointName String
    resolverId String
    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.
    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
    Oracle Cloud Infrastructure v1.41.0 published on Wednesday, Jun 19, 2024 by Pulumi