ApsaraVideo Live provides a variety of features for you to manage live streams. You can disable stream ingest, resume a live stream, and view active ingest endpoints, activity logs, and disabled ingest endpoints and their details. This topic describes the features of stream management and how to use these features.

Disable stream ingest

ApsaraVideo Live provides a variety of features for you to manage live streams. In the following scenarios, you can disable the ingest URL of a live stream:
  • The ingest URL is leaked.
  • Users use the ingest URL for malicious stream ingest.
  • You must meet specific business requirements.

Usage instructions

  • The ApsaraVideo Live console: In the ApsaraVideo Live console, you can view a disabled ingest endpoint, configure a disabled ingest endpoint, and resume a live stream. You can manage live streams on the Stream Management page in the ApsaraVideo Live console. For more information, see Manage streams.
  • API
    Operation Description Reference
    ForbidLiveStream Disables the ingest URL of a live stream.

    You can call this operation to interrupt a stream ingest without adding the ingest URL to the blacklist and enable stream ingest again at a preset point in time.

    Note You can disable the ingest of a maximum of 10,000 live streams. If the limit is exceeded, you are unable to disable the ingest of excess live streams. You can call this operation up to 20 times per second.
    ForbidLiveStream
    ResumeLiveStream Resumes a live stream.
    Note You can call this operation up to 30 times per second.
    ResumeLiveStream

View live streams

  • The ApsaraVideo Live console

    ApsaraVideo Live classifies live streams into the following types: active ingest endpoints, activity logs, and disabled ingest endpoints. You can view live streams on the Ingest Endpoints page under Stream Management in the ApsaraVideo Live console.

    You can view the application name, stream name, start time and end time of stream ingest, ingest mode, transcoding template, stream monitoring, and streaming URL of a live stream.

  • API
    Operation Description Reference
    DescribeLiveStreamsOnlineList Queries the information about all live streams that are being ingested for a specified domain name or for a specified application under the specified domain name. DescribeLiveStreamsOnlineList
    DescribeLiveStreamsPublishList Queries the stream ingest records of a specified domain name within a specified duration or a specified application or stream under the domain name within a specified duration. DescribeLiveStreamsPublishList
    DescribeLiveStreamsBlockList Queries the blacklist of ingest URLs for a specified domain name. DescribeLiveStreamsBlockList
    DescribeLiveStreamsControlHistory Queries the operation records of live streams for a specified domain name or application. DescribeLiveStreamsControlHistory
    DescribeLiveDomainOnlineUserNum Queries the number of online users at a specified point in time for all live streams in a streaming domain. DescribeLiveDomainOnlineUserNum

Monitor the status of live streaming

During live streaming, the playback stuttering affects user experience most.

Stuttering may occur during the playback of a live stream due to many causes, one of which is the upstream condition. Poor upstream may cause the playback stuttering on the audience side. This has a great impact on the viewing experience. ApsaraVideo Live allows you to monitor the upstream traffic. You can check the upstream status of a live stream at the earliest opportunity.

  • The ApsaraVideo Live console

    ApsaraVideo Live allows you to view the basic information, video and audio frame rates at different points in time, and bitrates at different points in time of a live stream. You can log on to the ApsaraVideo Live console and choose Stream Management > Ingest Endpoints. Then, you can find the live stream that you want to view and click Stream Monitoring.

  • API
    Operation Description Reference
    DescribeLiveDomainFrameRateAndBitRateData Queries the frame rates and bitrates of all live streams in an ingest domain. DescribeLiveDomainFrameRateAndBitRateData
    DescribeLiveStreamBitRateData Queries the frame rate and bitrate of an RTMP-based live stream within a specified duration. You can call this operation to query historical data. DescribeLiveStreamBitRateData