Configure a CNAME record for a domain name

Prerequisites

You have added an accelerated domain name. For more information, see Add an accelerated domain name.

Usage notes

• You must configure separate CNAME records for your streaming domain and ingest domain.

• If a conflict occurs when you add a CNAME record, you can use a different domain name or modify the DNS record. For more information, see DNS record conflict rules.

• A new CNAME record takes effect immediately. A modified CNAME record can take up to 72 hours to propagate globally.

Domain name concepts

A domain name consists of several levels separated by periods (.). The rightmost part is the top-level domain (TLD), such as .com, .org, .net, or .cn. Some TLDs have two levels, such as .com.cn and .org.cn.

• A root domain name consists of a unique name and a TLD, for example, aliyundoc.com or aliyundoc.com.cn.

• A subdomain adds another level to the left of a root domain name, for example, example.aliyundoc.com or example.aliyundoc.com.cn.

• You can add multiple levels of subdomains. For example, www.example.aliyundoc.com and www.example.aliyundoc.com.cn are third-level domains.

Second-level and third-level domains are considered subdomains. For information about other domain name concepts, see Basic concepts.

Procedure

1. Obtain the CNAME for your domain name.

   1. Log on to the ApsaraVideo Live console.

   2. In the navigation pane on the left, choose Domain Names to open the Domain Management page.

   3. Find the streaming or ingest domain and copy its CNAME.

      Save the CNAME for later use.

      Note

      An exclamation point (!) in the CNAME Status column means the CNAME record is not configured.

2. Add a CNAME record at your DNS provider.

   • DNS provider: Alibaba Cloud

   • DNS provider: DNSPod

DNS provider: Alibaba Cloud

If your DNS provider is Alibaba Cloud, follow these steps to configure the CNAME record.

1. Log on to the Alibaba Cloud DNS console.

2. In the navigation pane on the left, click Public Zone.

3. Find the domain name that you want to configure and click Settings in the Actions column.

4. Click Add Record and configure the following parameters.

   Parameter	Description
   Record type	Select CNAME. This record type maps a domain name to another domain name.
   Hostname	Enter a prefix for your domain name. The following table lists common prefixes and examples.
   DNS request source	Keep the default value.
   Record value	Enter the CNAME that you obtained from the ApsaraVideo Live console.
   TTL	Keep the default value.

   Prefix	Example domain name	Description
   demo	demo.aliyundoc.com	Resolves a subdomain.
   @	aliyundoc.com	Resolves the root domain name.
   *	*.aliyundoc.com	Wildcard domain name.

5. Click OK.

DNS provider: DNSPod

If your DNS provider is DNSPod, follow these steps to configure the CNAME record.

1. Log on to the DNSPod console.

2. Find the domain name that you want to configure and click Resolve.

3. Click Add Record and configure the following parameters:

   Parameter	Description
   Hostname	Enter a prefix for your domain name. See the table below for common prefixes and examples.
   Record type	Select CNAME. This record type maps a domain name to another domain name.
   Split zone	Keep the default value.
   Record value	Enter the CNAME that you obtained from the ApsaraVideo Live console.
   TTL	Keep the default value.

   Prefix	Example domain name	Description
   demo	demo.tencentdoc.com	Resolves a subdomain.
   @	tencentdoc.com	Resolves the root domain name.
   *	*.tencentdoc.com	Wildcard domain name.

4. Click Save.

Verify CNAME configuration

• Method 1: Run the dig command and check for the CNAME record in the output. If the result matches the CNAME from the ApsaraVideo Live console, the configuration is successful.

• Method 2: Go to the Domain Management page. If the CNAME Status for your domain name is Configured, the configuration is successful.

  Note

  If the CNAME status shows an exception, consider the following possible reasons:

  • After you configure a DNS record, you must wait for its Time to Live (TTL) to expire for the change to take effect globally. By default, the TTL is 10 minutes, but the actual time depends on the TTL value you configured.

  • ApsaraVideo Live checks for DNS propagation across the globe. The status may show an exception if the record has propagated in most regions but not all. The status updates to normal after the record propagates worldwide.

Related topics

• Troubleshoot access issues after configuring a CNAME record for ApsaraVideo Live

• CNAME record FAQ