oci.Dns.Resolver
Explore with Pulumi AI
This resource provides the Resolver resource in Oracle Cloud Infrastructure DNS service.
Updates the specified resolver with your new information.
Note: Resolvers are associated with VCNs and created when a VCN is created. Wait until created VCN’s state shows as Available in OCI console before updating DNS resolver properties. Also 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 the rules from a resolver user needs to update the resolver resource. Since DNS Resolver gets deleted when VCN is deleted there is no support for Delete for DNS Resolver.
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[_dns.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[_dns.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:
- Resolver
Id string - The OCID of the target resolver.
- Attached
Views List<ResolverAttached View> - (Updatable) The attached views. Views are evaluated in order.
- Compartment
Id string - (Updatable) The OCID of the owning compartment.
- 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"}}
- Display
Name string - (Updatable) The display name of the resolver.
- 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<Resolver
Rule> - (Updatable) Rules for the resolver. Rules are evaluated in order.
- Scope string
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Resolver
Id string - The OCID of the target resolver.
- Attached
Views []ResolverAttached View Args - (Updatable) The attached views. Views are evaluated in order.
- Compartment
Id string - (Updatable) The OCID of the owning compartment.
- 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"}}
- Display
Name string - (Updatable) The display name of the resolver.
- 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
[]Resolver
Rule Args - (Updatable) Rules for the resolver. Rules are evaluated in order.
- Scope string
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- resolver
Id String - The OCID of the target resolver.
- attached
Views List<ResolverAttached View> - (Updatable) The attached views. Views are evaluated in order.
- compartment
Id String - (Updatable) The OCID of the owning compartment.
- 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"}}
- display
Name String - (Updatable) The display name of the resolver.
- 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<Resolver
Rule> - (Updatable) Rules for the resolver. Rules are evaluated in order.
- scope String
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- resolver
Id string - The OCID of the target resolver.
- attached
Views ResolverAttached View[] - (Updatable) The attached views. Views are evaluated in order.
- compartment
Id string - (Updatable) The OCID of the owning compartment.
- {[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"}}
- display
Name string - (Updatable) The display name of the resolver.
- {[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
Resolver
Rule[] - (Updatable) Rules for the resolver. Rules are evaluated in order.
- scope string
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- resolver_
id str - The OCID of the target resolver.
- attached_
views Sequence[dns.Resolver Attached View Args] - (Updatable) The attached views. Views are evaluated in order.
- compartment_
id str - (Updatable) The OCID of the owning compartment.
- 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.
- 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[dns.
Resolver Rule Args] - (Updatable) Rules for the resolver. Rules are evaluated in order.
- scope str
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- resolver
Id String - The OCID of the target resolver.
- attached
Views List<Property Map> - (Updatable) The attached views. Views are evaluated in order.
- compartment
Id String - (Updatable) The OCID of the owning compartment.
- 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"}}
- display
Name String - (Updatable) The display name of the resolver.
- 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.
- scope String
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
Outputs
All input properties are implicitly available as output properties. Additionally, the Resolver resource produces the following output properties:
- Attached
Vcn stringId - The OCID of the attached VCN.
- Default
View stringId - The OCID of the default view.
- Endpoints
List<Resolver
Endpoint> - Read-only array of endpoints for the resolver.
- Id string
- 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 string
- The canonical absolute URL of the resource.
- State string
- The current state of the resource.
- Time
Created string - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- Time
Updated string - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- Attached
Vcn stringId - The OCID of the attached VCN.
- Default
View stringId - The OCID of the default view.
- Endpoints
[]Resolver
Endpoint Type - Read-only array of endpoints for the resolver.
- Id string
- 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 string
- The canonical absolute URL of the resource.
- State string
- The current state of the resource.
- Time
Created string - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- Time
Updated string - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- attached
Vcn StringId - The OCID of the attached VCN.
- default
View StringId - The OCID of the default view.
- endpoints
List<Resolver
Endpoint> - Read-only array of endpoints for the resolver.
- id String
- The provider-assigned unique ID for this managed resource.
- is
Protected 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.
- time
Created String - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- time
Updated String - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- attached
Vcn stringId - The OCID of the attached VCN.
- default
View stringId - The OCID of the default view.
- endpoints
Resolver
Endpoint[] - Read-only array of endpoints for the resolver.
- id string
- The provider-assigned unique ID for this managed resource.
- is
Protected 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.
- time
Created string - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- time
Updated string - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- attached_
vcn_ strid - The OCID of the attached VCN.
- default_
view_ strid - The OCID of the default view.
- endpoints
Sequence[dns.
Resolver Endpoint] - 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.
- attached
Vcn StringId - The OCID of the attached VCN.
- default
View StringId - 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.
- is
Protected 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.
- time
Created String - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- time
Updated String - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
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[_dns.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[_dns.ResolverEndpointArgs]] = None,
freeform_tags: Optional[Mapping[str, str]] = None,
is_protected: Optional[bool] = None,
resolver_id: Optional[str] = None,
rules: Optional[Sequence[_dns.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)
Resource lookup is not supported in YAML
- 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.
- Attached
Vcn stringId - The OCID of the attached VCN.
- Attached
Views List<ResolverAttached View> - (Updatable) The attached views. Views are evaluated in order.
- Compartment
Id string - (Updatable) The OCID of the owning compartment.
- Default
View stringId - The OCID of the default view.
- 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"}}
- Display
Name string - (Updatable) The display name of the resolver.
- Endpoints
List<Resolver
Endpoint> - Read-only array of endpoints for the resolver.
- 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"}
- Is
Protected bool - A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
- Resolver
Id string - The OCID of the target resolver.
- Rules
List<Resolver
Rule> - (Updatable) Rules for the resolver. Rules are evaluated in order.
- Scope string
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Self string
- The canonical absolute URL of the resource.
- State string
- The current state of the resource.
- Time
Created string - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- Time
Updated string - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- Attached
Vcn stringId - The OCID of the attached VCN.
- Attached
Views []ResolverAttached View Args - (Updatable) The attached views. Views are evaluated in order.
- Compartment
Id string - (Updatable) The OCID of the owning compartment.
- Default
View stringId - The OCID of the default view.
- 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"}}
- Display
Name string - (Updatable) The display name of the resolver.
- Endpoints
[]Resolver
Endpoint Type Args - Read-only array of endpoints for the resolver.
- 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"}
- Is
Protected bool - A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
- Resolver
Id string - The OCID of the target resolver.
- Rules
[]Resolver
Rule Args - (Updatable) Rules for the resolver. Rules are evaluated in order.
- Scope string
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Self string
- The canonical absolute URL of the resource.
- State string
- The current state of the resource.
- Time
Created string - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- Time
Updated string - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- attached
Vcn StringId - The OCID of the attached VCN.
- attached
Views List<ResolverAttached View> - (Updatable) The attached views. Views are evaluated in order.
- compartment
Id String - (Updatable) The OCID of the owning compartment.
- default
View StringId - The OCID of the default view.
- 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"}}
- display
Name String - (Updatable) The display name of the resolver.
- endpoints
List<Resolver
Endpoint> - Read-only array of endpoints for the resolver.
- 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"}
- is
Protected Boolean - A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
- resolver
Id String - The OCID of the target resolver.
- rules
List<Resolver
Rule> - (Updatable) Rules for the resolver. Rules are evaluated in order.
- scope String
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- self String
- The canonical absolute URL of the resource.
- state String
- The current state of the resource.
- time
Created String - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- time
Updated String - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- attached
Vcn stringId - The OCID of the attached VCN.
- attached
Views ResolverAttached View[] - (Updatable) The attached views. Views are evaluated in order.
- compartment
Id string - (Updatable) The OCID of the owning compartment.
- default
View stringId - The OCID of the default view.
- {[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"}}
- display
Name string - (Updatable) The display name of the resolver.
- endpoints
Resolver
Endpoint[] - Read-only array of endpoints for the resolver.
- {[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"}
- is
Protected boolean - A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
- resolver
Id string - The OCID of the target resolver.
- rules
Resolver
Rule[] - (Updatable) Rules for the resolver. Rules are evaluated in order.
- scope string
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- self string
- The canonical absolute URL of the resource.
- state string
- The current state of the resource.
- time
Created string - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- time
Updated string - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- attached_
vcn_ strid - The OCID of the attached VCN.
- attached_
views Sequence[dns.Resolver Attached View Args] - (Updatable) The attached views. Views are evaluated in order.
- compartment_
id str - (Updatable) The OCID of the owning compartment.
- default_
view_ strid - The OCID of the default view.
- 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[dns.
Resolver Endpoint Args] - Read-only array of endpoints for the resolver.
- 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[dns.
Resolver Rule Args] - (Updatable) Rules for the resolver. Rules are evaluated in order.
- scope str
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- 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.
- attached
Vcn StringId - The OCID of the attached VCN.
- attached
Views List<Property Map> - (Updatable) The attached views. Views are evaluated in order.
- compartment
Id String - (Updatable) The OCID of the owning compartment.
- default
View StringId - The OCID of the default view.
- 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"}}
- display
Name String - (Updatable) The display name of the resolver.
- endpoints List<Property Map>
- Read-only array of endpoints for the resolver.
- 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"}
- is
Protected Boolean - A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
- resolver
Id String - The OCID of the target resolver.
- rules List<Property Map>
- (Updatable) Rules for the resolver. Rules are evaluated in order.
- scope String
Specifies to operate only on resources that have a matching DNS scope.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- self String
- The canonical absolute URL of the resource.
- state String
- The current state of the resource.
- time
Created String - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- time
Updated String - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
Supporting Types
ResolverAttachedView, ResolverAttachedViewArgs
- View
Id string - (Updatable) The OCID of the view.
- View
Id string - (Updatable) The OCID of the view.
- view
Id String - (Updatable) The OCID of the view.
- view
Id string - (Updatable) The OCID of the view.
- view_
id str - (Updatable) The OCID of the view.
- view
Id String - (Updatable) The OCID of the view.
ResolverEndpoint, ResolverEndpointArgs
- Compartment
Id string - (Updatable) The OCID of the owning compartment.
- Endpoint
Type string - The type of resolver endpoint. VNIC is currently the only supported type.
- Forwarding
Address string - An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
- Is
Forwarding bool - A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
- Is
Listening bool - A Boolean flag indicating whether or not the resolver endpoint is for listening.
- Listening
Address string - An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
- Name string
- The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
- Self string
- The canonical absolute URL of the resource.
- State string
- The current state of the resource.
- Subnet
Id string - The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
- Time
Created string - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- Time
Updated string - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- Compartment
Id string - (Updatable) The OCID of the owning compartment.
- Endpoint
Type string - The type of resolver endpoint. VNIC is currently the only supported type.
- Forwarding
Address string - An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
- Is
Forwarding bool - A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
- Is
Listening bool - A Boolean flag indicating whether or not the resolver endpoint is for listening.
- Listening
Address string - An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
- Name string
- The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
- Self string
- The canonical absolute URL of the resource.
- State string
- The current state of the resource.
- Subnet
Id string - The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
- Time
Created string - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- Time
Updated string - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- compartment
Id String - (Updatable) The OCID of the owning compartment.
- endpoint
Type String - The type of resolver endpoint. VNIC is currently the only supported type.
- forwarding
Address String - An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
- is
Forwarding Boolean - A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
- is
Listening Boolean - A Boolean flag indicating whether or not the resolver endpoint is for listening.
- listening
Address String - An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
- name String
- The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
- self String
- The canonical absolute URL of the resource.
- state String
- The current state of the resource.
- subnet
Id String - The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
- time
Created String - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- time
Updated String - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- compartment
Id string - (Updatable) The OCID of the owning compartment.
- endpoint
Type string - The type of resolver endpoint. VNIC is currently the only supported type.
- forwarding
Address string - An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
- is
Forwarding boolean - A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
- is
Listening boolean - A Boolean flag indicating whether or not the resolver endpoint is for listening.
- listening
Address string - An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
- name string
- The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
- self string
- The canonical absolute URL of the resource.
- state string
- The current state of the resource.
- subnet
Id string - The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
- time
Created string - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- time
Updated string - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- 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.
- compartment
Id String - (Updatable) The OCID of the owning compartment.
- endpoint
Type String - The type of resolver endpoint. VNIC is currently the only supported type.
- forwarding
Address String - An IP address from which forwarded queries may be sent. For VNIC endpoints, this IP address must be part of the subnet and will be assigned by the system if unspecified when isForwarding is true.
- is
Forwarding Boolean - A Boolean flag indicating whether or not the resolver endpoint is for forwarding.
- is
Listening Boolean - A Boolean flag indicating whether or not the resolver endpoint is for listening.
- listening
Address String - An IP address to listen to queries on. For VNIC endpoints this IP address must be part of the subnet and will be assigned by the system if unspecified when isListening is true.
- name String
- The name of the resolver endpoint. Must be unique, case-insensitive, within the resolver.
- self String
- The canonical absolute URL of the resource.
- state String
- The current state of the resource.
- subnet
Id String - The OCID of a subnet. Must be part of the VCN that the resolver is attached to.
- time
Created String - The date and time the resource was created in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
- time
Updated String - The date and time the resource was last updated in "YYYY-MM-ddThh:mm:ssZ" format with a Z offset, as defined by RFC 3339.
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.
- Destination
Addresses List<string> - (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
- Source
Endpoint stringName - (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 List<string>Conditions - (Updatable) 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.
- Qname
Cover List<string>Conditions - (Updatable) A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.
- 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.
- Destination
Addresses []string - (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
- Source
Endpoint stringName - (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 []stringConditions - (Updatable) 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.
- Qname
Cover []stringConditions - (Updatable) A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.
- 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.
- destination
Addresses List<String> - (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
- source
Endpoint StringName - (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 List<String>Conditions - (Updatable) 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.
- qname
Cover List<String>Conditions - (Updatable) A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.
- 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.
- destination
Addresses string[] - (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
- source
Endpoint stringName - (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 string[]Conditions - (Updatable) 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.
- qname
Cover string[]Conditions - (Updatable) A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.
- 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_ strname - (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_ Sequence[str]conditions - (Updatable) 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.
- qname_
cover_ Sequence[str]conditions - (Updatable) A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.
- 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.
- destination
Addresses List<String> - (Updatable) IP addresses to which queries should be forwarded. Currently limited to a single address.
- source
Endpoint StringName - (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 List<String>Conditions - (Updatable) 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.
- qname
Cover List<String>Conditions - (Updatable) A list of domain names. The query must be covered by one of the domains in order for the rule action to apply.
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.