1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Dns
  5. Resolver
Viewing docs for Oracle Cloud Infrastructure v4.2.0
published on Friday, Mar 6, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-oci

oci.Dns.Resolver

oci logo
Viewing docs for Oracle Cloud Infrastructure v4.2.0
published on Friday, Mar 6, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-oci

    This resource provides the Resolver resource in Oracle Cloud Infrastructure DNS service. Api doc link for the resource: https://docs.oracle.com/iaas/api/#/en/dns/latest/Resolver

    Example terraform configs related to the resource : https://github.com/oracle/terraform-provider-oci/tree/master/examples/dns

    Updates the specified resolver with your new information.

    Note: Resolvers are associated with VCNs and created when a VCN is created. Wait until the created VCN’s state shows as Available in the OCI Console before updating DNS resolver properties. A VCN cannot be deleted while its resolver has resolver endpoints. Additionally, a resolver endpoint cannot be deleted if it is referenced in the resolver’s rules. To remove rules from a resolver, update the resolver resource.

    Destroy behavior: This resource does not delete the underlying DNS Resolver. The resolver itself is deleted only when the attached VCN is deleted. When this Terraform resource is destroyed, managed properties on the resolver (for example, attached views and rules) are cleared so the VCN can be deleted.

    Default view behavior on VCN delete: If the resolver’s default view contains customer-created zones, deleting the VCN (which deletes the resolver) can convert that default view into a non-protected regular view. That view may persist even if it was never imported into Terraform state. To avoid orphaned resources, either delete the zones from the default view before deleting the VCN, or plan to clean up the resulting view afterward.

    Create Resolver Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Resolver(name: string, args: ResolverArgs, opts?: CustomResourceOptions);
    @overload
def Resolver(resource_name: str,
             args: ResolverArgs,
             opts: Optional[ResourceOptions] = None)

@overload
def Resolver(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             resolver_id: Optional[str] = None,
             attached_views: Optional[Sequence[ResolverAttachedViewArgs]] = None,
             compartment_id: Optional[str] = None,
             defined_tags: Optional[Mapping[str, str]] = None,
             display_name: Optional[str] = None,
             freeform_tags: Optional[Mapping[str, str]] = None,
             rules: Optional[Sequence[ResolverRuleArgs]] = None,
             scope: Optional[str] = None)
    func NewResolver(ctx *Context, name string, args ResolverArgs, opts ...ResourceOption) (*Resolver, error)
    public Resolver(string name, ResolverArgs args, CustomResourceOptions? opts = null)
    public Resolver(String name, ResolverArgs args)
public Resolver(String name, ResolverArgs args, CustomResourceOptions options)

    type: oci:Dns:Resolver
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args ResolverArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ResolverArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ResolverArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ResolverArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ResolverArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var resolverResource = new Oci.Dns.Resolver("resolverResource", new()
{
    ResolverId = "string",
    AttachedViews = new[]
    {
        new Oci.Dns.Inputs.ResolverAttachedViewArgs
        {
            ViewId = "string",
        },
    },
    CompartmentId = "string",
    DefinedTags = 
    {
        { "string", "string" },
    },
    DisplayName = "string",
    FreeformTags = 
    {
        { "string", "string" },
    },
    Rules = new[]
    {
        new Oci.Dns.Inputs.ResolverRuleArgs
        {
            Action = "string",
            DestinationAddresses = new[]
            {
                "string",
            },
            SourceEndpointName = "string",
            ClientAddressConditions = new[]
            {
                "string",
            },
            QnameCoverConditions = new[]
            {
                "string",
            },
        },
    },
    Scope = "string",
});

    example, err := dns.NewResolver(ctx, "resolverResource", &dns.ResolverArgs{
	ResolverId: pulumi.String("string"),
	AttachedViews: dns.ResolverAttachedViewArray{
		&dns.ResolverAttachedViewArgs{
			ViewId: pulumi.String("string"),
		},
	},
	CompartmentId: pulumi.String("string"),
	DefinedTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	DisplayName: pulumi.String("string"),
	FreeformTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Rules: dns.ResolverRuleArray{
		&dns.ResolverRuleArgs{
			Action: pulumi.String("string"),
			DestinationAddresses: pulumi.StringArray{
				pulumi.String("string"),
			},
			SourceEndpointName: pulumi.String("string"),
			ClientAddressConditions: pulumi.StringArray{
				pulumi.String("string"),
			},
			QnameCoverConditions: pulumi.StringArray{
				pulumi.String("string"),
			},
		},
	},
	Scope: pulumi.String("string"),
})

    var resolverResource = new Resolver("resolverResource", ResolverArgs.builder()
    .resolverId("string")
    .attachedViews(ResolverAttachedViewArgs.builder()
        .viewId("string")
        .build())
    .compartmentId("string")
    .definedTags(Map.of("string", "string"))
    .displayName("string")
    .freeformTags(Map.of("string", "string"))
    .rules(ResolverRuleArgs.builder()
        .action("string")
        .destinationAddresses("string")
        .sourceEndpointName("string")
        .clientAddressConditions("string")
        .qnameCoverConditions("string")
        .build())
    .scope("string")
    .build());

    resolver_resource = oci.dns.Resolver("resolverResource",
    resolver_id="string",
    attached_views=[{
        "view_id": "string",
    }],
    compartment_id="string",
    defined_tags={
        "string": "string",
    },
    display_name="string",
    freeform_tags={
        "string": "string",
    },
    rules=[{
        "action": "string",
        "destination_addresses": ["string"],
        "source_endpoint_name": "string",
        "client_address_conditions": ["string"],
        "qname_cover_conditions": ["string"],
    }],
    scope="string")

    const resolverResource = new oci.dns.Resolver("resolverResource", {
    resolverId: "string",
    attachedViews: [{
        viewId: "string",
    }],
    compartmentId: "string",
    definedTags: {
        string: "string",
    },
    displayName: "string",
    freeformTags: {
        string: "string",
    },
    rules: [{
        action: "string",
        destinationAddresses: ["string"],
        sourceEndpointName: "string",
        clientAddressConditions: ["string"],
        qnameCoverConditions: ["string"],
    }],
    scope: "string",
});

    type: oci:Dns:Resolver
properties:
    attachedViews:
        - viewId: string
    compartmentId: string
    definedTags:
        string: string
    displayName: string
    freeformTags:
        string: string
    resolverId: string
    rules:
        - action: string
          clientAddressConditions:
            - string
          destinationAddresses:
            - string
          qnameCoverConditions:
            - string
          sourceEndpointName: string
    scope: string

    Resolver Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Resolver resource accepts the following input properties:

    ResolverId string
    The OCID of the target resolver.
    AttachedViews List<ResolverAttachedView>
    (Updatable) The attached views. Views are evaluated in order.
    CompartmentId string
    (Updatable) The OCID of the owning compartment.
    DefinedTags Dictionary<string, string>

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

    Example: {"Operations": {"CostCenter": "42"}}

    DisplayName string
    (Updatable) The display name of the resolver.
    FreeformTags Dictionary<string, string>

    (Updatable) 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.

    Example: {"Department": "Finance"}

    Rules List<ResolverRule>
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    Scope string
    Specifies to operate only on resources that have a matching DNS scope.
    ResolverId string
    The OCID of the target resolver.
    AttachedViews []ResolverAttachedViewArgs
    (Updatable) The attached views. Views are evaluated in order.
    CompartmentId string
    (Updatable) The OCID of the owning compartment.
    DefinedTags map[string]string

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

    Example: {"Operations": {"CostCenter": "42"}}

    DisplayName string
    (Updatable) The display name of the resolver.
    FreeformTags map[string]string

    (Updatable) 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.

    Example: {"Department": "Finance"}

    Rules []ResolverRuleArgs
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    Scope string
    Specifies to operate only on resources that have a matching DNS scope.
    resolverId String
    The OCID of the target resolver.
    attachedViews List<ResolverAttachedView>
    (Updatable) The attached views. Views are evaluated in order.
    compartmentId String
    (Updatable) The OCID of the owning compartment.
    definedTags Map<String,String>

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

    Example: {"Operations": {"CostCenter": "42"}}

    displayName String
    (Updatable) The display name of the resolver.
    freeformTags Map<String,String>

    (Updatable) 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.

    Example: {"Department": "Finance"}

    rules List<ResolverRule>
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    scope String
    Specifies to operate only on resources that have a matching DNS scope.
    resolverId string
    The OCID of the target resolver.
    attachedViews ResolverAttachedView[]
    (Updatable) The attached views. Views are evaluated in order.
    compartmentId string
    (Updatable) The OCID of the owning compartment.
    definedTags {[key: string]: string}

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

    Example: {"Operations": {"CostCenter": "42"}}

    displayName string
    (Updatable) The display name of the resolver.
    freeformTags {[key: string]: string}

    (Updatable) 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.

    Example: {"Department": "Finance"}

    rules ResolverRule[]
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    scope string
    Specifies to operate only on resources that have a matching DNS scope.
    resolver_id str
    The OCID of the target resolver.
    attached_views Sequence[ResolverAttachedViewArgs]
    (Updatable) The attached views. Views are evaluated in order.
    compartment_id str
    (Updatable) The OCID of the owning compartment.
    defined_tags Mapping[str, str]

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

    Example: {"Operations": {"CostCenter": "42"}}

    display_name str
    (Updatable) The display name of the resolver.
    freeform_tags Mapping[str, str]

    (Updatable) 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.

    Example: {"Department": "Finance"}

    rules Sequence[ResolverRuleArgs]
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    scope str
    Specifies to operate only on resources that have a matching DNS scope.
    resolverId String
    The OCID of the target resolver.
    attachedViews List<Property Map>
    (Updatable) The attached views. Views are evaluated in order.
    compartmentId String
    (Updatable) The OCID of the owning compartment.
    definedTags Map<String>

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

    Example: {"Operations": {"CostCenter": "42"}}

    displayName String
    (Updatable) The display name of the resolver.
    freeformTags Map<String>

    (Updatable) 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.

    Example: {"Department": "Finance"}

    rules List<Property Map>
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    scope String
    Specifies to operate only on resources that have a matching DNS scope.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Resolver resource produces the following output properties:

    AttachedVcnId string
    The OCID of the attached VCN.
    DefaultViewId string
    The OCID of the default view.
    Endpoints List<ResolverEndpoint>
    Read-only array of endpoints for the resolver.
    Id string
    The provider-assigned unique ID for this managed resource.
    IsProtected bool
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    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.
    AttachedVcnId string
    The OCID of the attached VCN.
    DefaultViewId string
    The OCID of the default view.
    Endpoints []ResolverEndpointType
    Read-only array of endpoints for the resolver.
    Id string
    The provider-assigned unique ID for this managed resource.
    IsProtected bool
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    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.
    attachedVcnId String
    The OCID of the attached VCN.
    defaultViewId String
    The OCID of the default view.
    endpoints List<ResolverEndpoint>
    Read-only array of endpoints for the resolver.
    id String
    The provider-assigned unique ID for this managed resource.
    isProtected Boolean
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    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.
    attachedVcnId string
    The OCID of the attached VCN.
    defaultViewId string
    The OCID of the default view.
    endpoints ResolverEndpoint[]
    Read-only array of endpoints for the resolver.
    id string
    The provider-assigned unique ID for this managed resource.
    isProtected boolean
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    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.
    attached_vcn_id str
    The OCID of the attached VCN.
    default_view_id str
    The OCID of the default view.
    endpoints Sequence[ResolverEndpoint]
    Read-only array of endpoints for the resolver.
    id str
    The provider-assigned unique ID for this managed resource.
    is_protected bool
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    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.
    attachedVcnId String
    The OCID of the attached VCN.
    defaultViewId String
    The OCID of the default view.
    endpoints List<Property Map>
    Read-only array of endpoints for the resolver.
    id String
    The provider-assigned unique ID for this managed resource.
    isProtected Boolean
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    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.

    Look up Existing Resolver Resource

    Get an existing Resolver resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ResolverState, opts?: CustomResourceOptions): Resolver
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        attached_vcn_id: Optional[str] = None,
        attached_views: Optional[Sequence[ResolverAttachedViewArgs]] = None,
        compartment_id: Optional[str] = None,
        default_view_id: Optional[str] = None,
        defined_tags: Optional[Mapping[str, str]] = None,
        display_name: Optional[str] = None,
        endpoints: Optional[Sequence[ResolverEndpointArgs]] = None,
        freeform_tags: Optional[Mapping[str, str]] = None,
        is_protected: Optional[bool] = None,
        resolver_id: Optional[str] = None,
        rules: Optional[Sequence[ResolverRuleArgs]] = None,
        scope: Optional[str] = None,
        self: Optional[str] = None,
        state: Optional[str] = None,
        time_created: Optional[str] = None,
        time_updated: Optional[str] = None) -> Resolver
    func GetResolver(ctx *Context, name string, id IDInput, state *ResolverState, opts ...ResourceOption) (*Resolver, error)
    public static Resolver Get(string name, Input<string> id, ResolverState? state, CustomResourceOptions? opts = null)
    public static Resolver get(String name, Output<String> id, ResolverState state, CustomResourceOptions options)
    resources:  _:    type: oci:Dns:Resolver    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AttachedVcnId string
    The OCID of the attached VCN.
    AttachedViews List<ResolverAttachedView>
    (Updatable) The attached views. Views are evaluated in order.
    CompartmentId string
    (Updatable) The OCID of the owning compartment.
    DefaultViewId string
    The OCID of the default view.
    DefinedTags Dictionary<string, string>

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

    Example: {"Operations": {"CostCenter": "42"}}

    DisplayName string
    (Updatable) The display name of the resolver.
    Endpoints List<ResolverEndpoint>
    Read-only array of endpoints for the resolver.
    FreeformTags Dictionary<string, string>

    (Updatable) 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.

    Example: {"Department": "Finance"}

    IsProtected bool
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    ResolverId string
    The OCID of the target resolver.
    Rules List<ResolverRule>
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    Scope string
    Specifies to operate only on resources that have a matching DNS scope.
    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.
    AttachedVcnId string
    The OCID of the attached VCN.
    AttachedViews []ResolverAttachedViewArgs
    (Updatable) The attached views. Views are evaluated in order.
    CompartmentId string
    (Updatable) The OCID of the owning compartment.
    DefaultViewId string
    The OCID of the default view.
    DefinedTags map[string]string

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

    Example: {"Operations": {"CostCenter": "42"}}

    DisplayName string
    (Updatable) The display name of the resolver.
    Endpoints []ResolverEndpointTypeArgs
    Read-only array of endpoints for the resolver.
    FreeformTags map[string]string

    (Updatable) 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.

    Example: {"Department": "Finance"}

    IsProtected bool
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    ResolverId string
    The OCID of the target resolver.
    Rules []ResolverRuleArgs
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    Scope string
    Specifies to operate only on resources that have a matching DNS scope.
    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.
    attachedVcnId String
    The OCID of the attached VCN.
    attachedViews List<ResolverAttachedView>
    (Updatable) The attached views. Views are evaluated in order.
    compartmentId String
    (Updatable) The OCID of the owning compartment.
    defaultViewId String
    The OCID of the default view.
    definedTags Map<String,String>

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

    Example: {"Operations": {"CostCenter": "42"}}

    displayName String
    (Updatable) The display name of the resolver.
    endpoints List<ResolverEndpoint>
    Read-only array of endpoints for the resolver.
    freeformTags Map<String,String>

    (Updatable) 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.

    Example: {"Department": "Finance"}

    isProtected Boolean
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    resolverId String
    The OCID of the target resolver.
    rules List<ResolverRule>
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    scope String
    Specifies to operate only on resources that have a matching DNS scope.
    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.
    attachedVcnId string
    The OCID of the attached VCN.
    attachedViews ResolverAttachedView[]
    (Updatable) The attached views. Views are evaluated in order.
    compartmentId string
    (Updatable) The OCID of the owning compartment.
    defaultViewId string
    The OCID of the default view.
    definedTags {[key: string]: string}

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

    Example: {"Operations": {"CostCenter": "42"}}

    displayName string
    (Updatable) The display name of the resolver.
    endpoints ResolverEndpoint[]
    Read-only array of endpoints for the resolver.
    freeformTags {[key: string]: string}

    (Updatable) 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.

    Example: {"Department": "Finance"}

    isProtected boolean
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    resolverId string
    The OCID of the target resolver.
    rules ResolverRule[]
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    scope string
    Specifies to operate only on resources that have a matching DNS scope.
    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.
    attached_vcn_id str
    The OCID of the attached VCN.
    attached_views Sequence[ResolverAttachedViewArgs]
    (Updatable) The attached views. Views are evaluated in order.
    compartment_id str
    (Updatable) The OCID of the owning compartment.
    default_view_id str
    The OCID of the default view.
    defined_tags Mapping[str, str]

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

    Example: {"Operations": {"CostCenter": "42"}}

    display_name str
    (Updatable) The display name of the resolver.
    endpoints Sequence[ResolverEndpointArgs]
    Read-only array of endpoints for the resolver.
    freeform_tags Mapping[str, str]

    (Updatable) 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.

    Example: {"Department": "Finance"}

    is_protected bool
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    resolver_id str
    The OCID of the target resolver.
    rules Sequence[ResolverRuleArgs]
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    scope str
    Specifies to operate only on resources that have a matching DNS scope.
    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.
    attachedVcnId String
    The OCID of the attached VCN.
    attachedViews List<Property Map>
    (Updatable) The attached views. Views are evaluated in order.
    compartmentId String
    (Updatable) The OCID of the owning compartment.
    defaultViewId String
    The OCID of the default view.
    definedTags Map<String>

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

    Example: {"Operations": {"CostCenter": "42"}}

    displayName String
    (Updatable) The display name of the resolver.
    endpoints List<Property Map>
    Read-only array of endpoints for the resolver.
    freeformTags Map<String>

    (Updatable) 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.

    Example: {"Department": "Finance"}

    isProtected Boolean
    A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
    resolverId String
    The OCID of the target resolver.
    rules List<Property Map>
    (Updatable) Rules for the resolver. Rules are evaluated in order, and only the first matching rule will have its action applied.
    scope String
    Specifies to operate only on resources that have a matching DNS scope.
    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.

    Supporting Types

    ResolverAttachedView, ResolverAttachedViewArgs

    ViewId string
    (Updatable) The OCID of the view.
    ViewId string
    (Updatable) The OCID of the view.
    viewId String
    (Updatable) The OCID of the view.
    viewId string
    (Updatable) The OCID of the view.
    view_id str
    (Updatable) The OCID of the view.
    viewId String
    (Updatable) The OCID of the view.

    ResolverEndpoint, ResolverEndpointArgs

    CompartmentId string
    (Updatable) The OCID of the owning compartment.
    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
    (Updatable) The OCID of the owning compartment.
    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
    (Updatable) The OCID of the owning compartment.
    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
    (Updatable) The OCID of the owning compartment.
    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
    (Updatable) The OCID of the owning compartment.
    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
    (Updatable) The OCID of the owning compartment.
    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.

    ResolverRule, ResolverRuleArgs

    Action string
    (Updatable) 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.

    • FORWARD - Matching requests will be forwarded from the source interface to the destination address.
    DestinationAddresses List<string>
    (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
    SourceEndpointName string
    (Updatable) 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.
    ClientAddressConditions List<string>
    (Updatable) A list of CIDR blocks. In order for the rule action to apply, the query must come from a client within one of the CIDR blocks.
    QnameCoverConditions List<string>
    (Updatable) A list of domain names. In order for the rule action to apply, the query must either match or be a subdomain of one of the listed domains.
    Action string
    (Updatable) 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.

    • FORWARD - Matching requests will be forwarded from the source interface to the destination address.
    DestinationAddresses []string
    (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
    SourceEndpointName string
    (Updatable) 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.
    ClientAddressConditions []string
    (Updatable) A list of CIDR blocks. In order for the rule action to apply, the query must come from a client within one of the CIDR blocks.
    QnameCoverConditions []string
    (Updatable) A list of domain names. In order for the rule action to apply, the query must either match or be a subdomain of one of the listed domains.
    action String
    (Updatable) 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.

    • FORWARD - Matching requests will be forwarded from the source interface to the destination address.
    destinationAddresses List<String>
    (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
    sourceEndpointName String
    (Updatable) 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.
    clientAddressConditions List<String>
    (Updatable) A list of CIDR blocks. In order for the rule action to apply, the query must come from a client within one of the CIDR blocks.
    qnameCoverConditions List<String>
    (Updatable) A list of domain names. In order for the rule action to apply, the query must either match or be a subdomain of one of the listed domains.
    action string
    (Updatable) 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.

    • FORWARD - Matching requests will be forwarded from the source interface to the destination address.
    destinationAddresses string[]
    (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
    sourceEndpointName string
    (Updatable) 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.
    clientAddressConditions string[]
    (Updatable) A list of CIDR blocks. In order for the rule action to apply, the query must come from a client within one of the CIDR blocks.
    qnameCoverConditions string[]
    (Updatable) A list of domain names. In order for the rule action to apply, the query must either match or be a subdomain of one of the listed domains.
    action str
    (Updatable) 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.

    • FORWARD - Matching requests will be forwarded from the source interface to the destination address.
    destination_addresses Sequence[str]
    (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
    source_endpoint_name str
    (Updatable) 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.
    client_address_conditions Sequence[str]
    (Updatable) A list of CIDR blocks. In order for the rule action to apply, the query must come from a client within one of the CIDR blocks.
    qname_cover_conditions Sequence[str]
    (Updatable) A list of domain names. In order for the rule action to apply, the query must either match or be a subdomain of one of the listed domains.
    action String
    (Updatable) 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.

    • FORWARD - Matching requests will be forwarded from the source interface to the destination address.
    destinationAddresses List<String>
    (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
    sourceEndpointName String
    (Updatable) 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.
    clientAddressConditions List<String>
    (Updatable) A list of CIDR blocks. In order for the rule action to apply, the query must come from a client within one of the CIDR blocks.
    qnameCoverConditions List<String>
    (Updatable) A list of domain names. In order for the rule action to apply, the query must either match or be a subdomain of one of the listed domains.

    Import

    Resolvers can be imported using their OCID, e.g.

    $ pulumi import oci:Dns/resolver:Resolver test_resolver "id"

    To learn more about importing existing cloud resources, see Importing resources.

    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.2.0
    published on Friday, Mar 6, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-oci
      Try Pulumi Cloud free. Your team will thank you.