» Resource: aws_route53_resolver_rule
Provides a Route53 Resolver rule.
» Example Usage
» System rule
resource "aws_route53_resolver_rule" "sys" {
domain_name = "subdomain.example.com"
rule_type = "SYSTEM"
}
» Forward rule
resource "aws_route53_resolver_rule" "fwd" {
domain_name = "example.com"
name = "example"
rule_type = "FORWARD"
resolver_endpoint_id = "${aws_route53_resolver_endpoint.foo.id}"
target_ip {
ip = "123.45.67.89"
}
tags {
Environment = "Prod"
}
}
» Argument Reference
The following arguments are supported:
-
domain_name
- (Required) DNS queries for this domain name are forwarded to the IP addresses that are specified usingtarget_ip
. -
rule_type
- (Required) The rule type. Valid values areFORWARD
,SYSTEM
andRECURSIVE
. -
name
- (Optional) A friendly name that lets you easily find a rule in the Resolver dashboard in the Route 53 console. -
resolver_endpoint_id
(Optional) The ID of the outbound resolver endpoint that you want to use to route DNS queries to the IP addresses that you specify usingtarget_ip
. This argument should only be specified forFORWARD
type rules. -
target_ip
- (Optional) Configuration block(s) indicating the IPs that you want Resolver to forward DNS queries to (documented below). This argument should only be specified forFORWARD
type rules. -
tags
- (Optional) A mapping of tags to assign to the resource.
The target_ip
object supports the following:
-
ip
- (Required) One IP address that you want to forward DNS queries to. You can specify only IPv4 addresses. -
port
- (Optional) The port atip
that you want to forward DNS queries to. Default value is53
» Attributes Reference
In addition to all arguments above, the following attributes are exported:
-
id
- The ID of the resolver rule. -
arn
- The ARN (Amazon Resource Name) for the resolver rule. -
owner_id
- When a rule is shared with another AWS account, the account ID of the account that the rule is shared with. -
share_status
- Whether the rules is shared and, if so, whether the current account is sharing the rule with another account, or another account is sharing the rule with the current account. Values areNOT_SHARED
,SHARED_BY_ME
orSHARED_WITH_ME
» Import
Route53 Resolver rules can be imported using the id
, e.g.
$ terraform import aws_route53_resolver_rule.sys rslvr-rr-0123456789abcdef0