All Products
Search
Document Center

ApsaraVideo Live:Associate a streaming domain with an ingest domain

Last Updated:Jun 20, 2026

After adding an ingest domain and a streaming domain, you must associate them to enable live stream ingest and playback.

Prerequisites

You must have at least one main streaming domain and one ingest domain. For more information, see Add an accelerated domain name.

Background

Edge ingest improves the reliability of your live stream ingest by routing your stream to the optimal point of presence (PoP). This approach minimizes issues like buffering and high latency resulting from poor upstream network conditions. ApsaraVideo Live no longer supports the legacy live center ingest method. Streaming domains added after February 21, 2019, must use edge ingest, which requires you to associate your main streaming domain with an ingest domain.

You can associate one main streaming domain with multiple ingest domains.

Note
  • An ingest domain can be associated with only one streaming domain at a time. If you attempt to associate an ingest domain that is already linked to another streaming domain, the action will fail. For example, if the ingest domain demo.aliyundoc.com is already associated with the streaming domain example.aliyundoc.com, you cannot associate demo.aliyundoc.com with a different streaming domain, such as learn.aliyundoc.com.

  • You can associate multiple sub-streaming domains with a main streaming domain to play the same live stream. For more information, see Associate a main streaming domain with a sub-streaming domain.

  • You can associate an ingest domain with a streaming domain only if their live centers are in the same region.

  • You can configure a domain name as either an ingest domain or a streaming domain, but not both simultaneously.

Procedure

  1. Log on to the ApsaraVideo Live console.

  2. In the navigation pane on the left, choose Domain Names > Domain Management.

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

  4. In Basic Settings, click the Stream Ingest Information tab, and then click Not Configured or Add Stream Ingest Information.

  5. Select the desired Ingest Domain and click OK.

    If the domain you need is not in the drop-down list, go to the Domain Management page to add a new ingest domain.

Next steps

To remove an associated ingest domain, click its delete icon, and then click OK.

API reference

AddLiveDomainPlayMapping