Values that are common for alias records for all routing policies - Amazon Route 53
Record nameValue/route traffic to

Values that are common for alias records for all routing policies

These are the common alias values that you can specify when you create or edit Amazon Route 53 records. These values are used by all routing policies.

Record name

Enter the name of the domain or subdomain that you want to route traffic for. The default value is the name of the hosted zone.

Note

If you're creating a record that has the same name as the hosted zone, don't enter a value (for example, an @ symbol) in the Name field.

CNAME records

If you're creating a record that has a value of CNAME for Type, the name of the record can't be the same as the name of the hosted zone.

Aliases to CloudFront distributions and Amazon S3 buckets

The value that you specify depends in part on the AWS resource that you're routing traffic to:

  • CloudFront distribution – Your distribution must include an alternate domain name that matches the name of the record. For example, if the name of the record is acme.example.com, your CloudFront distribution must include acme.example.com as one of the alternate domain names. For more information, see Using alternate domain names (CNAMEs) in the Amazon CloudFront Developer Guide.

  • Amazon S3 bucket – The name of the record must match the name of your Amazon S3 bucket. For example, if the name of your bucket is acme.example.com, the name of this record must also be acme.example.com.

    In addition, you must configure the bucket for website hosting. For more information, see Configure a bucket for website hosting in the Amazon Simple Storage Service User Guide.

Special characters

For information about how to specify characters other than a-z, 0-9, and - (hyphen) and how to specify internationalized domain names, see DNS domain name format.

Wildcard characters

You can use an asterisk (*) character in the name. DNS treats the * character either as a wildcard or as the * character (ASCII 42), depending on where it appears in the name. For more information, see Using an asterisk (*) in the names of hosted zones and records.

Value/route traffic to

The value that you choose from the list or that you type in the field depends on the AWS resource that you're routing traffic to.

For more information about how to configure Route 53 to route traffic to specific AWS resources, see Routing internet traffic to your AWS resources.

Important

If you used the same AWS account to create your hosted zone and the resource that you're routing traffic to, and if your resource doesn't appear in the Endpoint list, check the following:

  • Confirm that you chose a supported value for Record type. Supported values are specific to the resource that you're routing traffic to. For example, to route traffic to an S3 bucket, you must choose A — IPv4 address for Record type.

  • Confirm that the account has the IAM permissions that are required to list the applicable resources. For example, for CloudFront distributions to appear in the Endpoint list, the account must have permission to perform the following action: cloudfront:ListDistributions.

    For an example IAM policy, see Permissions required to use the Amazon Route 53 console.

If you used different AWS accounts to create the hosted zone and the resource, the Endpoint list doesn't display your resource. See the following documentation for your resource type to determine what value to type in Endpoint.

API Gateway custom regional APIs and edge-optimized APIs

For API Gateway custom regional APIs and edge-optimized APIs, do one of the following:

  • If you used the same account to create your Route 53 hosted zone and your API – Choose Endpoint, and then choose an API from the list. If you have a lot of APIs, you can enter the first few characters of the API endpoint to filter the list.

    Note

    The name of this record must match a custom domain name for your API, such as api.example.com.

  • If you used different accounts to create your Route 53 hosted zone and your API – Enter the API endpoint for the API, such as api.example.com.

    If you used one AWS account to create the current hosted zone and a different account to create an API, the API won't appear in the Endpoints list under API Gateway APIs.

    If you used one account to create the current hosted zone and one or more different accounts to create all of your APIs, the Endpoints list shows No targets available under API Gateway APIs. For more information, see Routing traffic to an Amazon API Gateway API by using your domain name.

CloudFront distributions

For CloudFront distributions, do one of the following:

  • If you used the same account to create your Route 53 hosted zone and your CloudFront distribution – Choose Endpoint and choose a distribution from the list. If you have a lot of distributions, you can enter the first few characters of the domain name for your distribution to filter the list.

    If your distribution doesn't appear in the list, note the following:

    • The name of this record must match an alternate domain name in your distribution.

    • If you just added an alternate domain name to your distribution, it may take 15 minutes for your changes to propagate to all CloudFront edge locations. Until changes have propagated, Route 53 can't know about the new alternate domain name.

  • If you used different accounts to create your Route 53 hosted zone and your distribution – Enter the CloudFront domain name for the distribution, such as d111111abcdef8.cloudfront.net.

    If you used one AWS account to create the current hosted zone and a different account to create a distribution, the distribution will not appear in the Endpoints list.

    If you used one account to create the current hosted zone and one or more different accounts to create all of your distributions, the Endpoints list shows No targets available under CloudFront distributions.

Important

Do not route queries to a CloudFront distribution that has not propagated to all edge locations, or your users won't be able to access the applicable content.

Your CloudFront distribution must include an alternate domain name that matches the name of the record. For example, if the name of the record is acme.example.com, your CloudFront distribution must include acme.example.com as one of the alternate domain names. For more information, see Using alternate domain names (CNAMEs) in the Amazon CloudFront Developer Guide.

If IPv6 is enabled for the distribution, create two records, one with a value of A — IPv4 address for Record type, and one with a value of AAAA — IPv6 address. For more information, see Routing traffic to an Amazon CloudFront distribution by using your domain name.

Elastic Beanstalk environments that have regionalized subdomains

If the domain name for your Elastic Beanstalk environment includes the Region that you deployed the environment in, you can create an alias record that routes traffic to the environment. For example, the domain name my-environment.us-west-2.elasticbeanstalk.com is a regionalized domain name.

Important

For environments that were created before early 2016, the domain name doesn't include the Region. To route traffic to these environments, you must create a CNAME record instead of an alias record. Note that you can't create a CNAME record for the root domain name. For example, if your domain name is example.com, you can create a record that routes traffic for acme.example.com to your Elastic Beanstalk environment, but you can't create a record that routes traffic for example.com to your Elastic Beanstalk environment.

For Elastic Beanstalk environments that have regionalized subdomains, do one of the following:

  • If you used the same account to create your Route 53 hosted zone and your Elastic Beanstalk environment – Choose Endpoint, and then choose an environment from the list. If you have a lot of environments, you can enter the first few characters of the CNAME attribute for the environment to filter the list.

  • If you used different accounts to create your Route 53 hosted zone and your Elastic Beanstalk environment – Enter the CNAME attribute for the Elastic Beanstalk environment.

For more information, see Routing traffic to an AWS Elastic Beanstalk environment.

ELB Load Balancers

For ELB load balancers, do one of the following:

  • If you used the same account to create your Route 53 hosted zone and your load balancer – Choose Endpoint and choose a load balancer from the list. If you have a lot of load balancers, you can enter the first few characters of the DNS name to filter the list.

  • If you used different accounts to create your Route 53 hosted zone and your load balancer – Enter the value that you got in the procedure Getting the DNS name for an Elastic Load Balancing load balancer.

    If you used one AWS account to create the current hosted zone and a different account to create a load balancer, the load balancer will not appear in the Endpoints list.

    If you used one account to create the current hosted zone and one or more different accounts to create all of your load balancers, the Endpoints list shows No targets available under Elastic Load Balancers.

The console prepends dualstack. for Application and Classic Load Balancer from a different account. When a client, such as a web browser, requests the IP address for your domain name (example.com) or subdomain name (www.example.com), the client can request an IPv4 address (an A record), an IPv6 address (a AAAA record), or both IPv4 and IPv6 addresses (in separate requests). The dualstack. designation allows Route 53 to respond with the appropriate IP address for your load balancer based on which IP address format the client requested.

For more information, see Routing traffic to an ELB load balancer.

AWS Global Accelerator accelerators

For AWS Global Accelerator accelerators, enter the DNS name for the accelerator. You can enter the DNS name of an accelerator that you created using the current AWS account or using a different AWS account.

Amazon S3 Buckets

For Amazon S3 buckets that are configured as website endpoints, do one of the following:

  • If you used the same account to create your Route 53 hosted zone and your Amazon S3 bucket – Choose Endpoint and choose a bucket from the list. If you have a lot of buckets, you can enter the first few characters of the DNS name to filter the list.

    The value of Endpoint changes to the Amazon S3 website endpoint for your bucket.

  • If you used different accounts to create your Route 53 hosted zone and your Amazon S3 bucket – Enter the name of the Region that you created your S3 bucket in. Use the value that appears in the Website endpoint column in the table Amazon S3 website endpoints in the Amazon Web Services General Reference.

    If you used AWS accounts other than the current account to create your Amazon S3 buckets, the bucket won't appear in the Endpoints list.

You must configure the bucket for website hosting. For more information, see Configure a bucket for website hosting in the Amazon Simple Storage Service User Guide.

The name of the record must match the name of your Amazon S3 bucket. For example, if the name of your Amazon S3 bucket is acme.example.com, the name of this record must also be acme.example.com.

In a group of weighted alias, latency alias, failover alias, or geolocation alias records, you can create only one record that routes queries to an Amazon S3 bucket because the name of the record must match the name of the bucket and bucket names must be globally unique.

Amazon VPC interface endpoints

For Amazon VPC interface endpoints, do one of the following:

  • If you used the same account to create your Route 53 hosted zone and your interface endpoint – Choose Endpoint, and then choose an interface endpoint from the list. If you have a lot of interface endpoints, you can enter the first few characters of the DNS hostname to filter the list.

  • If you used different accounts to create your Route 53 hosted zone and your interface endpoint – Enter the DNS hostname for the interface endpoint, such as vpce-123456789abcdef01-example-us-east-1a.elasticloadbalancing.us-east-1.vpce.amazonaws.com.

    If you used one AWS account to create the current hosted zone and a different account to create an interface endpoint, the interface endpoint won't appear in the Endpoint list under VPC endpoints.

    If you used one account to create the current hosted zone and one or more different accounts to create all of your interface endpoints, the Endpoint list shows No targets available under VPC endpoints.

    For more information, see Routing traffic to an Amazon Virtual Private Cloud interface endpoint by using your domain name.

Records in this Hosted Zone

For records in this hosted zone, choose Endpoint and choose the applicable record. If you have a lot of records, you can enter the first few characters of the name to filter the list.

If the hosted zone contains only the default NS and SOA records, the Endpoints list shows No targets available.

Note

If you're creating an alias record that has the same name as the hosted zone (known as the zone apex), you can't choose a record for which the value of Record type is CNAME. This is because the alias record must have the same type as the record you're routing traffic to, and creating a CNAME record for the zone apex isn't supported even for an alias record.