Configures the Live to VOD feature.

Usage note

The Live to VOD configuration helps store recordings to a media library of ApsaraVideo VOD.

Note You cannot configure this feature by using a Finance Cloud account.

QPS limit

A single user can perform a maximum of 1000 queries per minute. 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.


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 AddLiveRecordVodConfig

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

AppName String Yes liveApp****

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

DomainName String Yes

The main streaming domain.

VodTranscodeGroupId String Yes e2d796d3bb5fd8049d32bff62f94****

The ID of the transcoding template group.

StreamName String No liveStream****

The name of the live stream.

CycleDuration Integer No 300

The duration of the periodically recorded video. Unit: seconds. Valid values: 300 to 21600. Default value: 3600.

AutoCompose String No OFF

Specifies whether to automatically merge the VOD files created from live streams. Valid values:

  • ON: The VOD files are automatically merged.
  • OFF: The VOD files are not automatically merged.
StorageLocation String No ****

The domain name of the Object Storage Service (OSS) bucket where the VOD files created from live streams are stored.

ComposeVodTranscodeGroupId String No *****

The ID of the transcoding template group to be used to automatically merge the VOD files created from the live streams.

Note You must specify this parameter if you set the AutoCompose parameter to ON.

Response parameters

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

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format


JSON format


Error codes

HTTP status code Error code Error message Description
400 ConfigAlreadyExists Config has already exist. The error message returned because an existing Live to VOD feature configuration is found.

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