Expand description
When you create a VPC using Amazon VPC, you automatically get DNS resolution within the VPC from Route 53 Resolver. By default, Resolver answers DNS queries for VPC domain names such as domain names for EC2 instances or Elastic Load Balancing load balancers. Resolver performs recursive lookups against public name servers for all other domain names.
You can also configure DNS resolution between your VPC and your network over a Direct Connect or VPN connection:
Forward DNS queries from resolvers on your network to Route 53 Resolver
DNS resolvers on your network can forward DNS queries to Resolver in a specified VPC. This allows your DNS resolvers to easily resolve domain names for AWS resources such as EC2 instances or records in a Route 53 private hosted zone. For more information, see How DNS Resolvers on Your Network Forward DNS Queries to Route 53 Resolver in the Amazon Route 53 Developer Guide.
Conditionally forward queries from a VPC to resolvers on your network
You can configure Resolver to forward queries that it receives from EC2 instances in your VPCs to DNS resolvers on your network. To forward selected queries, you create Resolver rules that specify the domain names for the DNS queries that you want to forward (such as example.com), and the IP addresses of the DNS resolvers on your network that you want to forward the queries to. If a query matches multiple rules (example.com, acme.example.com), Resolver chooses the rule with the most specific match (acme.example.com) and forwards the query to the IP addresses that you specified in that rule. For more information, see How Route 53 Resolver Forwards DNS Queries from Your VPCs to Your Network in the Amazon Route 53 Developer Guide.
Like Amazon VPC, Resolver is Regional. In each Region where you have VPCs, you can choose whether to forward queries from your VPCs to your network (outbound queries), from your network to your VPCs (inbound queries), or both.
If you’re using the service, you’re probably looking for Route53ResolverClient and Route53Resolver.
Structs§
- Associate
Firewall Rule Group Request - Associate
Firewall Rule Group Response - Associate
Resolver Endpoint IpAddress Request - Associate
Resolver Endpoint IpAddress Response - Associate
Resolver Query LogConfig Request - Associate
Resolver Query LogConfig Response - Associate
Resolver Rule Request - Associate
Resolver Rule Response - Create
Firewall Domain List Request - Create
Firewall Domain List Response - Create
Firewall Rule Group Request - Create
Firewall Rule Group Response - Create
Firewall Rule Request - Create
Firewall Rule Response - Create
Resolver Endpoint Request - Create
Resolver Endpoint Response - Create
Resolver Query LogConfig Request - Create
Resolver Query LogConfig Response - Create
Resolver Rule Request - Create
Resolver Rule Response - Delete
Firewall Domain List Request - Delete
Firewall Domain List Response - Delete
Firewall Rule Group Request - Delete
Firewall Rule Group Response - Delete
Firewall Rule Request - Delete
Firewall Rule Response - Delete
Resolver Endpoint Request - Delete
Resolver Endpoint Response - Delete
Resolver Query LogConfig Request - Delete
Resolver Query LogConfig Response - Delete
Resolver Rule Request - Delete
Resolver Rule Response - Disassociate
Firewall Rule Group Request - Disassociate
Firewall Rule Group Response - Disassociate
Resolver Endpoint IpAddress Request - Disassociate
Resolver Endpoint IpAddress Response - Disassociate
Resolver Query LogConfig Request - Disassociate
Resolver Query LogConfig Response - Disassociate
Resolver Rule Request - Disassociate
Resolver Rule Response - Filter
For Resolver list operations (ListResolverEndpoints, ListResolverRules, ListResolverRuleAssociations, ListResolverQueryLogConfigs, ListResolverQueryLogConfigAssociations), and ListResolverDnssecConfigs), an optional specification to return a subset of objects.
To filter objects, such as Resolver endpoints or Resolver rules, you specify
NameandValues. For example, to list only inbound Resolver endpoints, specifyDirectionforNameand specifyINBOUNDforValues.- Firewall
Config Configuration of the firewall behavior provided by DNS Firewall for a single VPC from Amazon Virtual Private Cloud (Amazon VPC).
- Firewall
Domain List High-level information about a list of firewall domains for use in a FirewallRule. This is returned by GetFirewallDomainList.
To retrieve the domains that are defined for this domain list, call ListFirewallDomains.
- Firewall
Domain List Metadata Minimal high-level information for a firewall domain list. The action ListFirewallDomainLists returns an array of these objects.
To retrieve full information for a firewall domain list, call GetFirewallDomainList and ListFirewallDomains.
- Firewall
Rule A single firewall rule in a rule group.
- Firewall
Rule Group High-level information for a firewall rule group. A firewall rule group is a collection of rules that DNS Firewall uses to filter DNS network traffic for a VPC. To retrieve the rules for the rule group, call ListFirewallRules.
- Firewall
Rule Group Association An association between a firewall rule group and a VPC, which enables DNS filtering for the VPC.
- Firewall
Rule Group Metadata Minimal high-level information for a firewall rule group. The action ListFirewallRuleGroups returns an array of these objects.
To retrieve full information for a firewall rule group, call GetFirewallRuleGroup and ListFirewallRules.
- GetFirewall
Config Request - GetFirewall
Config Response - GetFirewall
Domain List Request - GetFirewall
Domain List Response - GetFirewall
Rule Group Association Request - GetFirewall
Rule Group Association Response - GetFirewall
Rule Group Policy Request - GetFirewall
Rule Group Policy Response - GetFirewall
Rule Group Request - GetFirewall
Rule Group Response - GetResolver
Dnssec Config Request - GetResolver
Dnssec Config Response - GetResolver
Endpoint Request - GetResolver
Endpoint Response - GetResolver
Query LogConfig Association Request - GetResolver
Query LogConfig Association Response - GetResolver
Query LogConfig Policy Request - GetResolver
Query LogConfig Policy Response - GetResolver
Query LogConfig Request - GetResolver
Query LogConfig Response - GetResolver
Rule Association Request - GetResolver
Rule Association Response - GetResolver
Rule Policy Request - GetResolver
Rule Policy Response - GetResolver
Rule Request - GetResolver
Rule Response - Import
Firewall Domains Request - Import
Firewall Domains Response - IpAddress
Request In a CreateResolverEndpoint request, the IP address that DNS queries originate from (for outbound endpoints) or that you forward DNS queries to (for inbound endpoints).
IpAddressRequestalso includes the ID of the subnet that contains the IP address.- IpAddress
Response In the response to a GetResolverEndpoint request, information about the IP addresses that the Resolver endpoint uses for DNS queries.
- IpAddress
Update In an UpdateResolverEndpoint request, information about an IP address to update.
- List
Firewall Configs Request - List
Firewall Configs Response - List
Firewall Domain Lists Request - List
Firewall Domain Lists Response - List
Firewall Domains Request - List
Firewall Domains Response - List
Firewall Rule Group Associations Request - List
Firewall Rule Group Associations Response - List
Firewall Rule Groups Request - List
Firewall Rule Groups Response - List
Firewall Rules Request - List
Firewall Rules Response - List
Resolver Dnssec Configs Request - List
Resolver Dnssec Configs Response - List
Resolver Endpoint IpAddresses Request - List
Resolver Endpoint IpAddresses Response - List
Resolver Endpoints Request - List
Resolver Endpoints Response - List
Resolver Query LogConfig Associations Request - List
Resolver Query LogConfig Associations Response - List
Resolver Query LogConfigs Request - List
Resolver Query LogConfigs Response - List
Resolver Rule Associations Request - List
Resolver Rule Associations Response - List
Resolver Rules Request - List
Resolver Rules Response - List
Tags ForResource Request - List
Tags ForResource Response - PutFirewall
Rule Group Policy Request - PutFirewall
Rule Group Policy Response - PutResolver
Query LogConfig Policy Request - PutResolver
Query LogConfig Policy Response The response to a
PutResolverQueryLogConfigPolicyrequest.- PutResolver
Rule Policy Request - PutResolver
Rule Policy Response The response to a
PutResolverRulePolicyrequest.- Resolver
Dnssec Config A complex type that contains information about a configuration for DNSSEC validation.
- Resolver
Endpoint In the response to a CreateResolverEndpoint, DeleteResolverEndpoint, GetResolverEndpoint, ListResolverEndpoints, or UpdateResolverEndpoint request, a complex type that contains settings for an existing inbound or outbound Resolver endpoint.
- Resolver
Query LogConfig In the response to a CreateResolverQueryLogConfig, DeleteResolverQueryLogConfig, GetResolverQueryLogConfig, or ListResolverQueryLogConfigs request, a complex type that contains settings for one query logging configuration.
- Resolver
Query LogConfig Association In the response to an AssociateResolverQueryLogConfig, DisassociateResolverQueryLogConfig, GetResolverQueryLogConfigAssociation, or ListResolverQueryLogConfigAssociations, request, a complex type that contains settings for a specified association between an Amazon VPC and a query logging configuration.
- Resolver
Rule For queries that originate in your VPC, detailed information about a Resolver rule, which specifies how to route DNS queries out of the VPC. The
ResolverRuleparameter appears in the response to a CreateResolverRule, DeleteResolverRule, GetResolverRule, ListResolverRules, or UpdateResolverRule request.- Resolver
Rule Association In the response to an AssociateResolverRule, DisassociateResolverRule, or ListResolverRuleAssociations request, provides information about an association between a Resolver rule and a VPC. The association determines which DNS queries that originate in the VPC are forwarded to your network.
- Resolver
Rule Config In an UpdateResolverRule request, information about the changes that you want to make.
- Route53
Resolver Client - A client for the Route53Resolver API.
- Tag
One tag that you want to add to the specified resource. A tag consists of a
Key(a name for the tag) and aValue.- TagResource
Request - TagResource
Response - Target
Address In a CreateResolverRule request, an array of the IPs that you want to forward DNS queries to.
- Untag
Resource Request - Untag
Resource Response - Update
Firewall Config Request - Update
Firewall Config Response - Update
Firewall Domains Request - Update
Firewall Domains Response - Update
Firewall Rule Group Association Request - Update
Firewall Rule Group Association Response - Update
Firewall Rule Request - Update
Firewall Rule Response - Update
Resolver Dnssec Config Request - Update
Resolver Dnssec Config Response - Update
Resolver Endpoint Request - Update
Resolver Endpoint Response - Update
Resolver Rule Request - Update
Resolver Rule Response
Enums§
- Associate
Firewall Rule Group Error - Errors returned by AssociateFirewallRuleGroup
- Associate
Resolver Endpoint IpAddress Error - Errors returned by AssociateResolverEndpointIpAddress
- Associate
Resolver Query LogConfig Error - Errors returned by AssociateResolverQueryLogConfig
- Associate
Resolver Rule Error - Errors returned by AssociateResolverRule
- Create
Firewall Domain List Error - Errors returned by CreateFirewallDomainList
- Create
Firewall Rule Error - Errors returned by CreateFirewallRule
- Create
Firewall Rule Group Error - Errors returned by CreateFirewallRuleGroup
- Create
Resolver Endpoint Error - Errors returned by CreateResolverEndpoint
- Create
Resolver Query LogConfig Error - Errors returned by CreateResolverQueryLogConfig
- Create
Resolver Rule Error - Errors returned by CreateResolverRule
- Delete
Firewall Domain List Error - Errors returned by DeleteFirewallDomainList
- Delete
Firewall Rule Error - Errors returned by DeleteFirewallRule
- Delete
Firewall Rule Group Error - Errors returned by DeleteFirewallRuleGroup
- Delete
Resolver Endpoint Error - Errors returned by DeleteResolverEndpoint
- Delete
Resolver Query LogConfig Error - Errors returned by DeleteResolverQueryLogConfig
- Delete
Resolver Rule Error - Errors returned by DeleteResolverRule
- Disassociate
Firewall Rule Group Error - Errors returned by DisassociateFirewallRuleGroup
- Disassociate
Resolver Endpoint IpAddress Error - Errors returned by DisassociateResolverEndpointIpAddress
- Disassociate
Resolver Query LogConfig Error - Errors returned by DisassociateResolverQueryLogConfig
- Disassociate
Resolver Rule Error - Errors returned by DisassociateResolverRule
- GetFirewall
Config Error - Errors returned by GetFirewallConfig
- GetFirewall
Domain List Error - Errors returned by GetFirewallDomainList
- GetFirewall
Rule Group Association Error - Errors returned by GetFirewallRuleGroupAssociation
- GetFirewall
Rule Group Error - Errors returned by GetFirewallRuleGroup
- GetFirewall
Rule Group Policy Error - Errors returned by GetFirewallRuleGroupPolicy
- GetResolver
Dnssec Config Error - Errors returned by GetResolverDnssecConfig
- GetResolver
Endpoint Error - Errors returned by GetResolverEndpoint
- GetResolver
Query LogConfig Association Error - Errors returned by GetResolverQueryLogConfigAssociation
- GetResolver
Query LogConfig Error - Errors returned by GetResolverQueryLogConfig
- GetResolver
Query LogConfig Policy Error - Errors returned by GetResolverQueryLogConfigPolicy
- GetResolver
Rule Association Error - Errors returned by GetResolverRuleAssociation
- GetResolver
Rule Error - Errors returned by GetResolverRule
- GetResolver
Rule Policy Error - Errors returned by GetResolverRulePolicy
- Import
Firewall Domains Error - Errors returned by ImportFirewallDomains
- List
Firewall Configs Error - Errors returned by ListFirewallConfigs
- List
Firewall Domain Lists Error - Errors returned by ListFirewallDomainLists
- List
Firewall Domains Error - Errors returned by ListFirewallDomains
- List
Firewall Rule Group Associations Error - Errors returned by ListFirewallRuleGroupAssociations
- List
Firewall Rule Groups Error - Errors returned by ListFirewallRuleGroups
- List
Firewall Rules Error - Errors returned by ListFirewallRules
- List
Resolver Dnssec Configs Error - Errors returned by ListResolverDnssecConfigs
- List
Resolver Endpoint IpAddresses Error - Errors returned by ListResolverEndpointIpAddresses
- List
Resolver Endpoints Error - Errors returned by ListResolverEndpoints
- List
Resolver Query LogConfig Associations Error - Errors returned by ListResolverQueryLogConfigAssociations
- List
Resolver Query LogConfigs Error - Errors returned by ListResolverQueryLogConfigs
- List
Resolver Rule Associations Error - Errors returned by ListResolverRuleAssociations
- List
Resolver Rules Error - Errors returned by ListResolverRules
- List
Tags ForResource Error - Errors returned by ListTagsForResource
- PutFirewall
Rule Group Policy Error - Errors returned by PutFirewallRuleGroupPolicy
- PutResolver
Query LogConfig Policy Error - Errors returned by PutResolverQueryLogConfigPolicy
- PutResolver
Rule Policy Error - Errors returned by PutResolverRulePolicy
- TagResource
Error - Errors returned by TagResource
- Untag
Resource Error - Errors returned by UntagResource
- Update
Firewall Config Error - Errors returned by UpdateFirewallConfig
- Update
Firewall Domains Error - Errors returned by UpdateFirewallDomains
- Update
Firewall Rule Error - Errors returned by UpdateFirewallRule
- Update
Firewall Rule Group Association Error - Errors returned by UpdateFirewallRuleGroupAssociation
- Update
Resolver Dnssec Config Error - Errors returned by UpdateResolverDnssecConfig
- Update
Resolver Endpoint Error - Errors returned by UpdateResolverEndpoint
- Update
Resolver Rule Error - Errors returned by UpdateResolverRule
Traits§
- Route53
Resolver - Trait representing the capabilities of the Route53Resolver API. Route53Resolver clients implement this trait.