All Products
Search
Document Center

ApsaraVideo Live:AddLiveDomainPlayMapping

Last Updated:Jan 25, 2024

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

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

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.