oci logo
Oracle Cloud Infrastructure v0.6.0, Jan 23 23

oci.Dns.getResolver

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

Gets information about a specific resolver. Note that attempting to get a resolver in the DELETED lifecycleState will result in a 404 response to be consistent with other operations of the API. Requires a PRIVATE scope query parameter.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testResolver = Oci.Dns.GetResolver.Invoke(new()
    {
        ResolverId = oci_dns_resolver.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.GetResolver(ctx, &dns.GetResolverArgs{
			ResolverId: oci_dns_resolver.Test_resolver.Id,
			Scope:      pulumi.StringRef("PRIVATE"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
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.GetResolverArgs;
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 testResolver = DnsFunctions.getResolver(GetResolverArgs.builder()
            .resolverId(oci_dns_resolver.test_resolver().id())
            .scope("PRIVATE")
            .build());

    }
}
import pulumi
import pulumi_oci as oci

test_resolver = oci.Dns.get_resolver(resolver_id=oci_dns_resolver["test_resolver"]["id"],
    scope="PRIVATE")
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testResolver = oci.Dns.getResolver({
    resolverId: oci_dns_resolver.test_resolver.id,
    scope: "PRIVATE",
});
variables:
  testResolver:
    fn::invoke:
      Function: oci:Dns:getResolver
      Arguments:
        resolverId: ${oci_dns_resolver.test_resolver.id}
        scope: PRIVATE

Using getResolver

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 getResolver(args: GetResolverArgs, opts?: InvokeOptions): Promise<GetResolverResult>
function getResolverOutput(args: GetResolverOutputArgs, opts?: InvokeOptions): Output<GetResolverResult>
def get_resolver(resolver_id: Optional[str] = None,
                 scope: Optional[str] = None,
                 opts: Optional[InvokeOptions] = None) -> GetResolverResult
def get_resolver_output(resolver_id: Optional[pulumi.Input[str]] = None,
                 scope: Optional[pulumi.Input[str]] = None,
                 opts: Optional[InvokeOptions] = None) -> Output[GetResolverResult]
func GetResolver(ctx *Context, args *GetResolverArgs, opts ...InvokeOption) (*GetResolverResult, error)
func GetResolverOutput(ctx *Context, args *GetResolverOutputArgs, opts ...InvokeOption) GetResolverResultOutput

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

public static class GetResolver 
{
    public static Task<GetResolverResult> InvokeAsync(GetResolverArgs args, InvokeOptions? opts = null)
    public static Output<GetResolverResult> Invoke(GetResolverInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetResolverResult> getResolver(GetResolverArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: oci:Dns/getResolver:getResolver
  arguments:
    # arguments dictionary

The following arguments are supported:

ResolverId string

The OCID of the target resolver.

Scope string

Value must be PRIVATE when listing private name resolvers.

ResolverId string

The OCID of the target resolver.

Scope string

Value must be PRIVATE when listing private name resolvers.

resolverId String

The OCID of the target resolver.

scope String

Value must be PRIVATE when listing private name resolvers.

resolverId string

The OCID of the target resolver.

scope string

Value must be PRIVATE when listing private name resolvers.

resolver_id str

The OCID of the target resolver.

scope str

Value must be PRIVATE when listing private name resolvers.

resolverId String

The OCID of the target resolver.

scope String

Value must be PRIVATE when listing private name resolvers.

getResolver Result

The following output properties are available:

AttachedVcnId string

The OCID of the attached VCN.

AttachedViews List<GetResolverAttachedView>

The attached views. Views are evaluated in order.

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.

DefaultViewId string

The OCID of the default view.

DefinedTags Dictionary<string, object>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

DisplayName string

The display name of the resolver.

Endpoints List<GetResolverEndpoint>

Read-only array of endpoints for the resolver.

FreeformTags Dictionary<string, object>

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 OCID of the resolver.

IsProtected bool

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

ResolverId string
Rules List<GetResolverRule>

Rules for the resolver. Rules are evaluated in order.

Self string

The canonical absolute URL of the resource.

State string

The current state of the resource.

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
AttachedVcnId string

The OCID of the attached VCN.

AttachedViews []GetResolverAttachedView

The attached views. Views are evaluated in order.

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.

DefaultViewId string

The OCID of the default view.

DefinedTags map[string]interface{}

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

DisplayName string

The display name of the resolver.

Endpoints []GetResolverEndpointType

Read-only array of endpoints for the resolver.

FreeformTags map[string]interface{}

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 OCID of the resolver.

IsProtected bool

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

ResolverId string
Rules []GetResolverRule

Rules for the resolver. Rules are evaluated in order.

Self string

The canonical absolute URL of the resource.

State string

The current state of the resource.

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
attachedVcnId String

The OCID of the attached VCN.

attachedViews List<GetResolverAttachedView>

The attached views. Views are evaluated in order.

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.

defaultViewId String

The OCID of the default view.

definedTags Map<String,Object>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

displayName String

The display name of the resolver.

endpoints List<GetResolverEndpoint>

Read-only array of endpoints for the resolver.

freeformTags Map<String,Object>

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 OCID of the resolver.

isProtected Boolean

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

resolverId String
rules List<GetResolverRule>

Rules for the resolver. Rules are evaluated in order.

self String

The canonical absolute URL of the resource.

state String

The current state of the resource.

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
attachedVcnId string

The OCID of the attached VCN.

attachedViews GetResolverAttachedView[]

The attached views. Views are evaluated in order.

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.

defaultViewId string

The OCID of the default view.

definedTags {[key: string]: any}

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

displayName string

The display name of the resolver.

endpoints GetResolverEndpoint[]

Read-only array of endpoints for the resolver.

freeformTags {[key: string]: any}

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 OCID of the resolver.

isProtected boolean

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

resolverId string
rules GetResolverRule[]

Rules for the resolver. Rules are evaluated in order.

self string

The canonical absolute URL of the resource.

state string

The current state of the resource.

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
attached_vcn_id str

The OCID of the attached VCN.

attached_views GetResolverAttachedView]

The attached views. Views are evaluated in order.

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.

default_view_id str

The OCID of the default view.

defined_tags Mapping[str, Any]

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

display_name str

The display name of the resolver.

endpoints GetResolverEndpoint]

Read-only array of endpoints for the resolver.

freeform_tags Mapping[str, Any]

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 OCID of the resolver.

is_protected bool

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

resolver_id str
rules GetResolverRule]

Rules for the resolver. Rules are evaluated in order.

self str

The canonical absolute URL of the resource.

state str

The current state of the resource.

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
attachedVcnId String

The OCID of the attached VCN.

attachedViews List<Property Map>

The attached views. Views are evaluated in order.

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.

defaultViewId String

The OCID of the default view.

definedTags Map<Any>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

displayName String

The display name of the resolver.

endpoints List<Property Map>

Read-only array of endpoints for the resolver.

freeformTags Map<Any>

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 OCID of the resolver.

isProtected Boolean

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

resolverId String
rules List<Property Map>

Rules for the resolver. Rules are evaluated in order.

self String

The canonical absolute URL of the resource.

state String

The current state of the resource.

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

Supporting Types

GetResolverAttachedView

ViewId string

The OCID of the view.

ViewId string

The OCID of the view.

viewId String

The OCID of the view.

viewId string

The OCID of the view.

view_id str

The OCID of the view.

viewId String

The OCID of the view.

GetResolverEndpoint

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

GetResolverRule

Action string

The action determines the behavior of the rule. If a query matches a supplied condition, the action will apply. If there are no conditions on the rule, all queries are subject to the specified action.

ClientAddressConditions List<string>

A list of CIDR blocks. The query must come from a client within one of the blocks in order for the rule action to apply.

DestinationAddresses List<string>

IP addresses to which queries should be forwarded. Currently limited to a single address.

QnameCoverConditions List<string>

A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.

SourceEndpointName string

Case-insensitive name of an endpoint, that is a sub-resource of the resolver, to use as the forwarding interface. The endpoint must have isForwarding set to true.

Action string

The action determines the behavior of the rule. If a query matches a supplied condition, the action will apply. If there are no conditions on the rule, all queries are subject to the specified action.

ClientAddressConditions []string

A list of CIDR blocks. The query must come from a client within one of the blocks in order for the rule action to apply.

DestinationAddresses []string

IP addresses to which queries should be forwarded. Currently limited to a single address.

QnameCoverConditions []string

A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.

SourceEndpointName string

Case-insensitive name of an endpoint, that is a sub-resource of the resolver, to use as the forwarding interface. The endpoint must have isForwarding set to true.

action String

The action determines the behavior of the rule. If a query matches a supplied condition, the action will apply. If there are no conditions on the rule, all queries are subject to the specified action.

clientAddressConditions List<String>

A list of CIDR blocks. The query must come from a client within one of the blocks in order for the rule action to apply.

destinationAddresses List<String>

IP addresses to which queries should be forwarded. Currently limited to a single address.

qnameCoverConditions List<String>

A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.

sourceEndpointName String

Case-insensitive name of an endpoint, that is a sub-resource of the resolver, to use as the forwarding interface. The endpoint must have isForwarding set to true.

action string

The action determines the behavior of the rule. If a query matches a supplied condition, the action will apply. If there are no conditions on the rule, all queries are subject to the specified action.

clientAddressConditions string[]

A list of CIDR blocks. The query must come from a client within one of the blocks in order for the rule action to apply.

destinationAddresses string[]

IP addresses to which queries should be forwarded. Currently limited to a single address.

qnameCoverConditions string[]

A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.

sourceEndpointName string

Case-insensitive name of an endpoint, that is a sub-resource of the resolver, to use as the forwarding interface. The endpoint must have isForwarding set to true.

action str

The action determines the behavior of the rule. If a query matches a supplied condition, the action will apply. If there are no conditions on the rule, all queries are subject to the specified action.

client_address_conditions Sequence[str]

A list of CIDR blocks. The query must come from a client within one of the blocks in order for the rule action to apply.

destination_addresses Sequence[str]

IP addresses to which queries should be forwarded. Currently limited to a single address.

qname_cover_conditions Sequence[str]

A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.

source_endpoint_name str

Case-insensitive name of an endpoint, that is a sub-resource of the resolver, to use as the forwarding interface. The endpoint must have isForwarding set to true.

action String

The action determines the behavior of the rule. If a query matches a supplied condition, the action will apply. If there are no conditions on the rule, all queries are subject to the specified action.

clientAddressConditions List<String>

A list of CIDR blocks. The query must come from a client within one of the blocks in order for the rule action to apply.

destinationAddresses List<String>

IP addresses to which queries should be forwarded. Currently limited to a single address.

qnameCoverConditions List<String>

A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.

sourceEndpointName String

Case-insensitive name of an endpoint, that is a sub-resource of the resolver, to use as the forwarding interface. The endpoint must have isForwarding set to true.

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes

This Pulumi package is based on the oci Terraform Provider.