Updated on 2023-10-16 GMT+08:00

Configuring Domain Names

You can use your own domain names to accelerate media file distribution.

Notes

  • If you have enabled the enterprise project management service, you can categorize domain names by enterprise project when adding domain names. The default enterprise project is default. You can add enterprise project types by referring to Creating an Enterprise Project.
  • The system automatically checks all domain names under your name and deletes domain names that have been idle for a long time. The details are as follows:
    • Disabling a domain name: If no downstream traffic is generated for a domain name within one month, the domain name will be disabled and in the Disabled status on the VOD console.
    • Deleting a domain name: If no downstream traffic is generated for a domain name within two months, the domain name will be deleted.
  • After a domain name is disabled or deleted, the domain name cannot be used to distribute or play media files, but can be used to upload or process media files.

    If a domain name is in an abnormal status such as being disabled and media files are deleted, the CDN cache cannot be cleared. After the domain name works again, the user triggers the operation of clearing the media file cache again.

  • Restoring a domain name: If a domain name is disabled, you can manually enable it on the Domain Name Management page of the VOD console. If the domain name has been deleted, you need to add the domain name again and configure the CNAME so that the domain name can be used again. The acceleration domain name allocated by the system (all domain names have been allocated) when VOD is subscribed cannot be restored after being deleted.

Domain Admission Process

Figure 1 shows the process of using your own domain names for VOD acceleration.

Figure 1 Domain admission process
  1. Register a domain name: If you do not have a domain name, you can purchase or register a domain name at the cloud service provider.
  2. Add your own domain names. You can add a maximum of five domain names to the VOD service. For details, see Adding Domain Names.
  3. Add a CNAME record to your domain's DNS records. For details, see Configuring CNAME Records.
  4. Configure HTTPS secure acceleration. The default playback URL of VOD content is HTTPS. If you do not upload the HTTPS certificate of the added domain name, the uploaded media files cannot be played. For details, see Configuring HTTPS Secure Acceleration.

After your domain name is added, VOD will review the content on your site. If your site violates related laws and regulations, for example, pornography, gambling, and drug abuse–related content are found, domain resolution will be terminated.

Adding Domain Names

  1. Log in to the VOD console.
  2. In the navigation pane, choose Domain Name Management.
  3. Click Add Domain Name. The Add Domain Name page is displayed.

    Table 1 describes the required parameters.

    Table 1 Adding a domain name

    Parameter

    Description

    Domain Name

    Enter a licensed domain name.

    • You can add a maximum of five domain names. Wildcard domains such as *.example.com are not allowed.
    • You are advised to use a domain name higher than second level, for example, example.yourdomain.com.

    Enterprise Project

    If you have enabled the enterprise project function, you need to select Enterprise Project to categorize new domain names.

    Service Scope

    Service scope of the current domain name.

    The options are as follows:

    • Chinese mainland: Only users in the Chinese mainland can access the VOD content of the current domain name.
    • Outside China: Only users outside the Chinese mainland can access the VOD content of the current domain name.
    • Global: Global users can access the VOD content of the current domain name.

  4. Click OK.

    A domain name whose Status is Configuring is displayed in the domain name list. If Status becomes Enabled in 3 to 5 minutes, the domain name has been added.

    After a domain name is added, the system assigns a CNAME value to the domain name.

    Figure 2 Domain name added

  5. Add a CNAME record to your domain's DNS records by referring to Configuring CNAME Records and verify whether the CNAME record has taken effect.

    If the CNAME has not been configured and the domain name is enabled by default after it is added, media files in VOD may fail to be played and the thumbnail may fail to be displayed.

  6. Click Set as Default next to an added domain name to set the domain name to the default one.

    Each account can only have one default domain in the Enabled state. You need to enable HTTPS secure acceleration for the domain name and upload the HTTPS certificate so that the domain name can be used to provide the VOD functions.

Managing Domain Names

After a self-owned domain name is added, you can view basic information about the domain name on the Domain Name Management page. You can also disable, enable, or delete the domain name. If you have enabled the enterprise project management service, you can also view the name of the enterprise project to which a domain name belongs.

  1. Log in to the VOD console.
  2. In the navigation pane, choose Domain Name Management.
  3. You can perform the following operations as required:

    • Viewing domain information

      In the domain name list, you can view the CNAME value and status of the added domain name.

      Figure 3 Domain information

      Click Configure in the Operation column on the right to view the basic configuration of the target domain name. You can also configure HTTPS secure acceleration and Referer validation for the domain name.

      Figure 4 Domain name security configuration
    • Disabling a domain name

      To disable a domain name, click Disable in the row that contains the target domain name. If the Status changes to Disabled, the domain name has been disabled.

      Ensure that the default domain name has been enabled. Otherwise, media file playback will fail.

      Figure 5 Disabling a domain name
    • Enabling a domain name

      To enable a disabled domain name, click Enable in the Operation column. If the Status changes to Enabled, the domain name has been enabled.

      Figure 6 Enabling a domain name
    • Deleting a domain name

      Only a domain name in the Disabled status can be deleted. After disabling a domain name, click Delete in the row containing the domain name to delete it.

      Figure 7 Deleting a domain name

Follow-up Operations

After the domain name is added, you can configure the domain name on the VOD console. The details are as follows: