All Products
Search
Document Center

ApsaraVideo Live:Associate main and sub-stream domains

Last Updated:Jun 20, 2026

This topic describes how to associate a sub-streaming domain with a main streaming domain, and how to view or remove this association. Use this feature to support multiple streaming domains with a single ingest domain.

Prerequisites

You have at least two streaming domains. For more information, see Add a domain name.

Background information

Associating a sub-streaming domain with a main streaming domain allows you to use a single ingest domain for multiple streaming domains.

An ingest domain can be associated with only one main streaming domain. If you need to use multiple streaming domains to play the same ingested stream, you must designate one as the main streaming domain and associate the others as sub-streaming domains.

image
Important
  • A sub-streaming domain inherits configurations, such as stream ingest and transcoding settings, from its main streaming domain. Settings configured directly on the sub-streaming domain do not take effect. For example, transcoding templates must be configured on the main streaming domain.

  • You cannot nest sub-streaming domains.

  • Before you proceed, ensure the domain is not used for any critical online services. To prevent service disruptions, use a new domain as the sub-streaming domain.

Add a sub-stream domain

  1. Log on to the ApsaraVideo Live console.

  2. In the left navigation pane, click Domain Names. The Domain Management page appears.

  3. On the Domains page, find the target main streaming domain and click Domain Settings in the Actions column.

  4. On the Basic Settings page, click the Streaming Information tab, and then click Configure Sub-streaming Information.

  5. Select the Streaming Domain to associate and click OK.

View the association

  1. Log on to the ApsaraVideo Live console.

  2. In the left navigation pane, click Domain Names. The Domain Management page appears.

  3. On the Domains page, find the target main streaming domain and click Domain Settings in the Actions column.

  4. On the Basic Settings page, click the Streaming Information tab to view the configurations.

    This page displays information about the main streaming domain. You can view all streaming information for the main streaming domain and its sub-streaming domains. The page contains the Main Streaming Information and Sub-streaming Information sections. Each section displays the streaming domain and its streaming URLs in RTMP, FLV, M3U8, and UDP formats. A URL Signing link appears to the right of each URL. You can click Remove Association to remove a sub-streaming domain. At the bottom of the page, click Configure Sub-streaming Information to add more sub-streaming domains. A blue notification box at the top of the page explains the association rules and the StreamName matching logic.

Remove an association

  1. Log on to the ApsaraVideo Live console.

  2. In the left navigation pane, click Domain Names. The Domain Management page appears.

  3. On the Domains page, find the target main streaming domain and click Domain Settings in the Actions column.

  4. On the Basic Settings page, click the Streaming Information tab, find the sub-streaming domain to disassociate, and then click Unbind.

Feature support for streaming domains

Feature

Main streaming domain

Sub-stream domain

Stream management

View active streams

View historical streams

View forbidden streams

Forbid streams

Recording file management

Query recording files

Clip recording index files

Snapshot management

Query snapshot files

Domain management

Modify acceleration region

Add ingest information

Delete ingest information

Add a sub-streaming domain

Nesting sub-streaming domains is not allowed.

HLS back-to-origin host

The back-to-origin Host header of the sub-streaming domain must be set to the main streaming domain.

Latency configuration (high, medium, and low)

HTTP header configuration

HTTPS configuration

Referer-based hotlink protection

URL signing

IP address blacklist/whitelist

Peak bandwidth monitoring

IPv6 configuration

Transcoding template configuration

Recording template configuration

Recording callback configuration

Snapshot configuration

Snapshot callback configuration

Censorship configuration

Censorship callback configuration

Time shifting

Live stream latency configuration

Stream pulling configuration

Data monitoring

Resource monitoring: Downstream bandwidth and traffic

Resource monitoring: Back-to-origin statistics

Resource monitoring: HTTP status codes

Real-time monitoring - Traffic and bandwidth

Real-time monitoring - Quality monitoring

Access statistics

Unique visitors

User distribution

Usage data

Streaming bandwidth and traffic

Number of ingested streams

Transcoding duration

Number of snapshots

Time shifting

Log management

Log download

Real-time log delivery