CreateResolverRuleRequest
¶
Source code in docs_src/capo_route53resolver/types/create_resolver_rule_request.py
creator_request_id
instance-attribute
¶
creator_request_id: CreatorRequestId
A unique string that identifies the request and that allows failed requests to be retried without the risk of running the operation twice. CreatorRequestId can be any unique string, for example, a date/time stamp.
delegation_record
instance-attribute
¶
delegation_record: NotRequired[DelegationRecord]
DNS queries with the delegation records that match this domain name are forwarded to the resolvers on your network.
domain_name
instance-attribute
¶
domain_name: NotRequired[DomainName]
DNS queries for this domain name are forwarded to the IP addresses that you specify in TargetIps. If a query matches multiple Resolver rules (example.com and www.example.com), outbound DNS queries are routed using the Resolver rule that contains the most specific domain name (www.example.com).
name
instance-attribute
¶
name: NotRequired[Name]
A friendly name that lets you easily find a rule in the Resolver dashboard in the Route 53 console.
The name can be up to 64 characters long and can contain letters (a-z, A-Z), numbers (0-9), hyphens (-), underscores (_), and spaces. The name cannot consist of only numbers.
resolver_endpoint_id
instance-attribute
¶
resolver_endpoint_id: NotRequired[ResourceId]
The ID of the outbound Resolver endpoint that you want to use to route DNS queries to the IP addresses that you specify in TargetIps.
rule_type
instance-attribute
¶
rule_type: RuleTypeOption
When you want to forward DNS queries for specified domain name to resolvers on your network, specify FORWARD or DELEGATE.
When you have a forwarding rule to forward DNS queries for a domain to your network and you want Resolver to process queries for a subdomain of that domain, specify SYSTEM.
For example, to forward DNS queries for example.com to resolvers on your network, you create a rule and specify FORWARD for RuleType. To then have Resolver process queries for apex.example.com, you create a rule and specify SYSTEM for RuleType.
Currently, only Resolver can create rules that have a value of RECURSIVE for RuleType.
tags
instance-attribute
¶
tags: NotRequired[TagList]
A list of the tag keys and values that you want to associate with the endpoint.
target_ips
instance-attribute
¶
target_ips: NotRequired[TargetList]
The IPs that you want Resolver to forward DNS queries to. You can specify either Ipv4 or Ipv6 addresses but not both in the same rule. Separate IP addresses with a space.
TargetIps is available only when the value of Rule type is FORWARD. You should not provide TargetIps when the Rule type is DELEGATE.
when creating a DELEGATE rule, you must not provide the TargetIps parameter. If you provide the TargetIps, you may receive an ERROR message similar to "Delegate resolver rules need to specify a nameserver name". This error means you should not provide TargetIps.