Creates transcoding configurations for a streaming domain.

Usage note

This operation only supports the Standard and Narrowband HD™ transcoding templates.

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 AddLiveStreamTranscode

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

App String Yes liveApp****

The name of the application to which the live stream belongs.

Domain String Yes example.com

The main streaming domain.

Template String Yes lsd

The transcoding template. Valid values:

  • lld, lsd, lhd, and lud: standard-quality templates.
  • ld, sd, hd, and ud: Narrowband HD™ transcoding templates.
RegionId String No cn-shanghai

The ID of the region where the streaming domain resides.

EncryptParameters String No {"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"}

The encryption configurations. The value is a JSON-formatted string. The following fields are included in the syntax:

  • EncryptType: the type of the encryption. The value is aliyun.
  • KmsKeyID: the ID of the customer master key (CMK) in Key Management Service (KMS).
  • KmsKeyExpireInterval: the validity period of the encryption key. Valid values: 60 to 3600. Unit: seconds.
Lazy String No 1

Whether to use lazy loading mode for transcoding. The default value is yes.

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=AddLiveStreamTranscode
&App=liveApp****
&Domain=example.com
&Template=lsd
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

Error codes

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