Creates the mapping between a main streaming domain and a sub-streaming domain.
Usage note
Call the AddLiveDomain API to add the main streaming domain name and sub-streaming domain name before calling this API to create the mapping between them.
QPS limit
A single user can perform a maximum of 1000 queries per minute (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
Request parameters
Parameter | Type | Required | Example | Description |
Action | String | Yes | AddLiveDomainPlayMapping | The operation that you want to perform. Set the value to AddLiveDomainPlayMapping. |
PlayDomain | String | Yes | example.aliyundoc.com | The sub-streaming domain. |
PullDomain | String | Yes | example.com | The main streaming domain. |
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=AddLiveDomainPlayMapping
&PlayDomain=example.aliyundoc.com
&PullDomain=example.com
&<Common request parameters>Sample success responses
XML format
<AddLiveDomainPlayMappingResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddLiveDomainPlayMappingResponse>JSON format
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}Error codes
HTTP status code | Error code | Error message | Description |
400 | ConfigAlreadyExists | Config has already exist. | The error message returned because an existing mapping is found. |
For a list of error codes, visit the API Error Center.