Add a CNAME record

Prerequisites

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

You have verified the ownership of your domain name by configuring a TXT record. For more information, see Verify domain name ownership.

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.

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

      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 maps a domain name to another domain name.
   Hostname	Enter a prefix for your domain name. The following table lists common prefixes and examples.
   Query Source	Keep the default value.
   Record Values	Enter the CNAME record that you obtained from ApsaraVideo Live.
   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. Click the domain name that you want to configure in My Domains.

3. Click Add Records and configure the following parameters:

   Parameter	Description
   Host	Enter a prefix for your domain name. See the table below for common prefixes and examples.
   Type	Select CNAME. This maps a domain name to another domain name.
   Split Zone	Keep the default value.
   Value	Enter the CNAME that you obtained from ApsaraVideo Live.
   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 CNAME record, wait for its Time to Live (TTL) to expire before the change takes effect globally. The default TTL is 10 minutes, but the actual duration depends on your configuration.

  • ApsaraVideo Live checks DNS propagation globally. The status may show an exception if the record has not yet propagated in all regions. It updates to normal after worldwide propagation completes.

Related topics

• Resolve access failures after CNAME configuration

• CNAME record FAQ