Create the mapping between a streaming domain to an ingest domain.

Usage note

The mapping can only be created after the streaming domain and the ingest domain are added to ApsaraVideo Live. For how the domain names are added, see AddLiveDomain.

QPS limit

A single user can perform a maximum of 30 queries per second (QPS). Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes AddLiveDomainMapping

The operation that you want to perform. Set the value to AddLiveDomainMapping.

PullDomain String Yes example.com

The streaming domain. The type of the domain name is liveVideo.

PushDomain String Yes demo.aliyundoc.com

The ingest domain. The type of the domain name is liveEdge.

Response parameters

Parameter Type Example Description
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=AddLiveDomainMapping
&PullDomain=example.com
&PushDomain=demo.aliyundoc.com
&<Common request parameters>

Sample success responses

XML format 

<AddLiveDomainMappingResponse>
      <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddLiveDomainMappingResponse>

JSON format 

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Error codes

For a list of error codes, visit the API Error Center.