Before You Start

Huawei Cloud Live helps you smoothly livestream content to global audience with low latency.

This document describes how to use application programming interfaces (APIs) to perform operations on Live resources, such as transcoding, managing, and recording livestreams. For details about all supported operations, see API Overview.

Before calling a Live API, ensure that you are familiar with Live concepts. For details, see Service Overview.

You can configure referer validation, URL validation, and access control lists (ACLs) on the Live console to implement access control on your content. Only users who meet the configured rules can play videos.

Live supports Representational State Transfer (REST) APIs, allowing you to call APIs using HTTPS.

Endpoints

An endpoint is the request address for calling an API. Endpoints vary depending on regions. For the endpoints of Live, see Table 1. You can also query the endpoints of services in Regions and Endpoints.

**Table 1** Live endpoints
Region Name	Region	Endpoint
CN North-Beijing4	cn-north-4	live.cn-north-4.myhuaweicloud.com
AP-Singapore	ap-southeast-3	live.ap-southeast-3.myhuaweicloud.com
AP-Bangkok	ap-southeast-2	live.ap-southeast-2.myhuaweicloud.com

Constraints

Live sets a limit on the number of API calls to prevent service interruption caused by repeated API calls in a short period of time.

**Table 2** API request throttling
API Category	API Name	Max. User Requests	Max. API Requests
Domain name management	Creating a domain name Querying domain names	300 times/minute	3,000 times/minute
	Deleting a domain name Modifying a domain name Mapping domain names Deleting a domain name mapping Configuring the domain name IPv6 switch Modifying the HLS configuration of a domain name Querying HLS configurations of domain names	100 times/minute	1,000 times/minute
	Modifying the streaming domain name delay Modifying origin pull settings	30 times/minute	100 times/minute
	Querying the streaming domain name delay Querying origin pull settings	30 times/minute	300 times/minute
Domain name management	Querying IP address information	5 times/second	5 times/second
Transcoding template management	Creating a transcoding template Deleting a transcoding template Modifying a transcoding template Querying transcoding templates	100 times/minute	1,000 times/minute
Stream management	Disabling stream push Modifying the attribute of a disabled stream	4,000 times/minute	12,000 times/minute
	Querying disabled streams Resuming stream push	3,000 times/minute	6,000 times/minute
	Pausing stream push	300 times/minute	3,000 times/minute
Notification management	Adding and modifying stream notification configurations Querying stream notification configurations Deleting stream notification configurations	300 times/minute	3,000 times/minute
Authentication	Configuring a referer validation ACL Deleting a referer validation ACL Querying referer validation ACLs Querying IP ACLs Modifying an IP ACL Generating a signed URL	300 times/minute	3,000 times/minute
	Querying supported areas of a streaming domain name	30 times/minute	300 times/minute
	Modifying supported areas of a streaming domain name	30 times/minute	100 times/minute
	Querying the URL validation configuration of a specified domain name Modifying the URL validation configuration of a specified domain name Deleting the URL validation configuration of a specified domain name	150 times/minute	300 times/minute
Snapshot management	Creating a snapshot capturing template Modifying a snapshot capturing template Querying snapshot capturing templates Deleting a snapshot capturing template	150 times/minute	300 times/minute
Log management	Obtaining livestreaming logs	300 times/minute	3,000 times/minute
Recording management	Creating a recording template Querying recording templates Modifying a recording template Deleting a recording template Querying recording template configurations Submitting a recording command	300 times/minute	3,000 times/minute
Recording management	Creating a video recording index	1,200 times/minute	3,000 times/minute
Recording callback management	Creating a recording callback Querying recording callbacks Modifying a recording callback Querying a recording callback Deleting a recording callback	300 times/minute	300 times/minute
HTTPS certificate management	Modifying the HTTPS certificate configuration of a specified domain name Querying the HTTPS certificate configuration of a specified domain name Deleting the HTTPS certificate configuration of a specified domain name	150 times/minute	300 times/minute
OBS bucket management	Granting or canceling authorization of accessing OBS buckets	150 times/minute	300 times/minute
Livestreaming watermark management	Creating a watermark template Modifying a watermark template Deleting a watermark template Creating a watermark rule Modifying a watermark rule Deleting a watermark rule Querying watermark rule configurations	50 times/minute	200 times/minute
Livestreaming watermark management	Querying watermark templates Querying watermark template configurations Querying watermark rules	300 times/minute	3,000 times/minute
Statistical analysis	Querying bandwidth utilization	100 times/second	600 times/second
	Querying traffic utilization	20 times/second	200 times/second
	Querying the number of viewers	20 times/second	200 times/second
Statistical analysis	Querying the peak bandwidth	20 times/second	200 times/second
	Querying the total playback traffic	20 times/second	300 times/second
	Querying HTTP status codes	30 times/second	300 times/second
	Querying the duration of transcoded outputs	20 times/second	200 times/second
	Querying upstream bandwidth	20 times/second	300 times/second
	Querying the number of streams by domain name	20 times/second	300 times/second
	Querying historical streams	30 times/second	300 times/second
	Querying playback profiles	10 times/second	100 times/second
	Querying the distribution of livestreaming metrics by region	50 times/second	150 times/second
Statistical analysis	Querying the duration of recorded outputs	20 times/second	200 times/second
	Querying the number of snapshots	20 times/second	200 times/second
	Querying stream data of a streaming domain name	20 times/second	50 times/second
Stream analytics	Querying the stream frame rate	10 times/second	200 times/second
	Querying the stream bitrate	10 times/second	200 times/second
	Querying stream analytics data	10 times/second	200 times/second
	Querying CDN upstream quality data	30 times/second	300 times/second

Concepts

Account
An account is created upon successful registration with the cloud platform. The account has full access permissions for all of its cloud services and resources. It can be used to reset user passwords and grant user permissions. An account is a payment entity. Accounts should not be used directly to perform routine management. For security purposes, create IAM users and grant them permissions for routine management.
IAM user
An IAM user is created using an account to use cloud services. Each IAM user has its own identity credentials (password and access keys).

An IAM user can view the account ID and user ID on the My Credentials page of the console. The account, username, and password will be required for API authentication.
Region
A region is a physical location where cloud resources are deployed. Availability zones (AZs) in the same region can communicate with each other over an intranet, but AZs in different regions cannot. Deploying cloud resources in different regions can better suit certain user requirements or comply with local laws or regulations.
AZ
An AZ contains one or more physical data centers equipped with independent ventilation, fire, water, and electricity facilities. Compute, networking, storage, and other resources in an AZ are logically divided into multiple clusters. AZs within a region are interconnected using high-speed optical fibers to allow you to build cross-AZ, high-availability systems.
Project
Projects group and isolate resources (including compute, storage, and networking resources) across physical regions. A default project is provided for each region, and subprojects can be created under each default project. Users can be granted permissions to access all resources in a specific project. For more refined access control, create subprojects under a project and purchase resources in the subprojects. Users can then be assigned permissions to access only specific resources in the subprojects.

Figure 1 Project isolating model