Before You Start
Huawei Cloud Live helps you smoothly deliver livestreaming 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 live video streams. For details about all supported operations, see API Overview.
If you plan to access Live through an API, ensure that you are familiar with Live concepts. For details, see Service Overview.
You can configure referer validation and access control lists (ACLs) on the Live console to determine who can and cannot access your content. Only users who meet the configured rules can play videos. For details, see Access Control.
Live supports Representational State Transfer (REST) APIs, allowing you to call APIs using HTTPS. For details about API calling, see Calling APIs.
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.
Constraints
API Category |
API Name |
Max. User Requests |
Max. API Requests |
---|---|---|---|
Domain name management |
|
300 times/minute |
3000 times/minute |
|
100 times/minute |
1000 times/minute |
|
Querying IP address information |
5 times/second |
5 times/second |
|
|
30 times/minute |
100 times/minute |
|
|
30 times/minute |
300 times/minute |
|
Transcoding template management |
|
100 times/minute |
1000 times/minute |
Stream management |
|
4000 times/minute |
12,000 times/minute |
|
3000 times/minute |
6000 times/minute |
|
Querying ongoing streams |
1000 times/minute |
2000 times/minute |
|
Notification management |
|
300 times/minute |
3000 times/minute |
Authentication |
|
300 times/minute |
3000 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 |
|
|
150 times/minute |
300 times/minute |
|
Snapshot management |
|
150 times/minute |
300 times/minute |
Log management |
Obtaining livestreaming logs |
300 times/minute |
3000 times/minute |
Recording management |
|
300 times/minute |
3000 times/minute |
Creating a video recording index |
1200 times/minute |
3000 times/minute |
|
Recording callback management |
|
300 times/minute |
300 times/minute |
HTTPS certificate management |
|
150 times/minute |
300 times/minute |
OBS bucket management |
Granting or canceling authorization of accessing OBS buckets |
150 times/minute |
300 times/minute |
Statistical analysis |
|
60 times/minute |
5000 times/minute |
|
20 times/minute |
5000 times/minute |
|
Querying the distribution of livestreaming metrics by region |
50 times/second |
150 times/second |
|
Statistical analysis |
Querying stream data of a streaming domain name |
20 times/second |
50 times/second |
Stream analytics |
|
20 times/minute |
5000 times/minute |
Querying stream analytics |
Once per second |
5 times/second |
|
Querying CDN upstream streaming quality data |
60 times/second |
300 times/second |
Concepts
- Account
A domain is created upon successful registration. The domain has full access permissions for all of its cloud services and resources. It can be used to reset user passwords and grant user permissions. The account is a payment entity and should not be used 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 domain name, 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 communicate with each other. For low network latency and quick resource access, select the nearest region. The choice of regions may also be subject to legal compliance requirements.
- AZ
An AZ is one or more physical data centers within a region. It has independent cooling, fire extinguishing, moisture-proof, and electricity facilities. Within an AZ, compute, networking, storage, and other resources are logically divided into multiple clusters. AZs within a region are connected using high-speed optical fibers for high availability.
- Project
Projects group and isolate resources (including compute, storage, and network 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
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot