Amazon Route 53
Developer Guide (API Version 2013-04-01)

Managing Forwarding Rules

If you want Resolver to forward queries for specified domain names to your network, you create one forwarding rule for each domain name and specify the name of the domain for which you want to forward queries.

Viewing and Editing Forwarding Rules

To view and edit settings for a forwarding rule, perform the following procedure.

To view and edit settings for a forwarding rule

  1. Sign in to the AWS Management Console and open the Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the navigation pane, choose Rules.

  3. On the navigation bar, choose the Region where you created the rule.

  4. Choose the option for the rule that you want to view settings for or want to edit.

  5. Choose View details or Edit.

    For information about the values for forwarding rules, see Values That You Specify When You Create or Edit Rules.

  6. If you chose Edit, enter the applicable values, and then choose Save.

Creating Forwarding Rules

To create one or more forwarding rules, perform the following procedure.

To create forwarding rules and associate the rules with one or more VPCs

  1. Sign in to the AWS Management Console and open the Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the navigation pane, choose Rules.

  3. On the navigation bar, choose the Region where you want to create the rule.

  4. Choose Create rule.

  5. Enter the applicable values. For more information, see Values That You Specify When You Create or Edit Rules.

  6. Choose Save.

  7. To add another rule, repeat steps 4 through 6.

Associating Forwarding Rules with a VPC

After you create a forwarding rule, you must associate the rule with one or more VPCs. When you associate a rule with a VPC, Resolver starts to forward DNS queries for the domain name that's specified in the rule to the DNS resolvers that you specified in the rule. The queries pass through the outbound endpoint that you specified when you created the rule.

To associate a forwarding rule with one or more VPCs

  1. Sign in to the AWS Management Console and open the Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the navigation pane, choose Rules.

  3. On the navigation bar, choose the Region where you created the rule.

  4. Choose the option for the rule (not the name of the rule) that you want to associate with one or more VPCs.

  5. Choose Edit.

  6. Under Select a VPC in the region: region-name, choose the VPCs that you want to associate the rule with.

  7. Choose Submit.

Disassociating Forwarding Rules from a VPC

You disassociate a forwarding rule from a VPC in the following circumstances:

  • For DNS queries that originate in this VPC, you want Resolver to stop forwarding queries for the domain name specified in the rule to your network.

  • You want to delete the forwarding rule. If a rule is currently associated with one or more VPCs, you must disassociate the rule from all VPCs before you can delete it.

If you want to disassociate a forwarding rule from one or more VPCs, perform the following procedure.

To disassociate a forwarding rule from a VPC

  1. Sign in to the AWS Management Console and open the Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the navigation pane, choose Rules.

  3. On the navigation bar, choose the Region where you created the rule.

  4. Choose the option for the rule that you want to disassociate from one or more VPCs.

  5. Choose Edit.

  6. Under Select a VPC in the region: region-name, choose the X for each VPC that you want to disassociate the rule from.

  7. Choose Submit.

Sharing Forwarding Rules with Other AWS Accounts and Using Shared Rules

You can share the forwarding rules that you created using one AWS account with other AWS accounts. To share rules, the Route 53 Resolver console integrates with AWS Resource Access Manager. For more information about Resource Access Manager, see the Resource Access Manager User Guide.

Note the following:

Associating shared rules with VPCs

If another AWS account has shared one or more rules with your account, you can associate the rules with your VPCs the same way that you associate rules that you created with your VPCs. For more information, see Associating Forwarding Rules with a VPC.

Deleting or unsharing a rule

If you share a rule with other accounts and then either delete the rule or stop sharing it, and if the rule was associated with one or more VPCs, Route 53 Resolver starts to process DNS queries for those VPCs based on the remaining rules. The behavior is the same as if you disassociate the rule from the VPC.

Limits on rules

When an account creates a rule and shares it with one or more other accounts, the limit on the number of rules per AWS Region applies to the account that created the rule.

When an account that a rule is shared with associates the rule with one or more VPCs, the limit on the number of associations between rules and VPCs per Region applies to the account that the rule is shared with.

For the current limits on Resolver, see Limits on Route 53 Resolver.

Permissions

To share a rule with another AWS account, you must have permission to use the PutResolverRulePolicy action.

Restrictions on the AWS account that a rule is shared with

The account that a rule is shared with can't change or delete the rule.

Tagging

Only the account that created a rule can add, delete, or see tags on the rule.

To view the current sharing status of a rule (including the account that shared the account or the account that a rule is shared with), and to share rules with another account, perform the following procedure.

To view sharing status and share rules with another AWS account

  1. Sign in to the AWS Management Console and open the Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the navigation pane, choose Rules.

  3. On the navigation bar, choose the Region where you created the rule.

    The Sharing status column shows the current sharing status of rules that were created by the current account or that are shared with the current account:

    • Not shared: The current AWS account created the rule, and the rule is not shared with any other accounts.

    • Shared by me: The current account created the rule and shared it with one or more accounts.

    • Shared with me: Another account created the rule and shared it with the current account.

  4. Choose the name of the rule that you want to display sharing information for or that you want to share with another account.

    On the Rule: rule name page, the value under Owner displays ID of the account that created the rule. That's the current account unless the value of Sharing status is Shared with me. In that case, Owner is the account that created the rule and shared it with the current account.

  5. Choose Share to view additional information or to share the rule with another account. A page in the Resource Access Manager console appears, depending on the value of Sharing status:

    • Not shared: The Create resource share page appears. For information about how to share the rule with another account, OU, or organization, skip to step 6.

    • Shared by me: The Shared resources page shows the rules and other resources that are owned by the current account and shared with other accounts.

    • Shared with me: The Shared resources page shows the rules and other resources that are owned by other accounts and shared with the current account.

  6. To share a rule with another AWS account, OU, or organization, specify the following values.

    Note

    You can't update sharing settings. If you want to change any of the following settings, you must reshare a rule with the new settings and then remove the old sharing settings.

    Description

    Enter a short description that helps you remember why you shared the rule.

    Resources

    Choose the check box for the rule that you want to share.

    Principals

    Enter the AWS account number, OU name, or organization name.

    Tags

    Specify one or more keys and the corresponding values. For example, you might specify Cost center for Key and specify 456 for Value.

    These are the tags that AWS Billing and Cost Management provides for organizing your AWS bill; you can use also tags for other purposes. For more information about using tags for cost allocation, see Use Cost Allocation Tags for Custom Billing Reports in the AWS Billing and Cost Management User Guide.

Deleting Forwarding Rules

To delete a forwarding rule, perform the following procedure.

Note

If the forwarding rule is associated with any VPCs, you must disassociate the rule from the VPCs before you can delete the rule. For more information, see Disassociating Forwarding Rules from a VPC.

To delete a forwarding rule

  1. Sign in to the AWS Management Console and open the Route 53 console at https://console.aws.amazon.com/route53/.

  2. In the navigation pane, choose Rules.

  3. On the navigation bar, choose the Region where you created the rule.

  4. Choose the option for the rule that you want to delete.

  5. Choose Delete.

  6. To confirm that you want to delete the rule, enter the name of the rule and choose Submit.