Configures the Live to VOD feature to store recordings to a media library of ApsaraVideo VOD.

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

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 AddLiveRecordVodConfig

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

AppName String Yes testName

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

DomainName String Yes www.yourdomain.com

The streaming domain.

VodTranscodeGroupId String Yes e2d796d3bb5fd8049d32bff62f94****

The ID of the transcoding template group.

StreamName String No stream

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 ****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com

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.

Examples

Sample requests

http(s)://live.aliyuncs.com/? Action=AddLiveRecordVodConfig
&AppName=AppName
&DomainName=www.yourdomain.com
&VodTranscodeGroupId=e2d796d3bb5fd8049d32bff62f94****
&<Common request parameters>

Sample success responses

XML format

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

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 Live to VOD feature configuration is found.

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