Updates a Live-to-VOD configuration.
QPS limit
You can call this operation up to 1,000 times per minute per account. Requests that exceed this limit are dropped and you may experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.
Debugging
Request parameters
Parameter |
Type |
Required |
Example |
Description |
Action | String | Yes | UpdateLiveRecordVodConfig | The operation that you want to perform. Set the value to UpdateLiveRecordVodConfig. |
DomainName | String | Yes | example.com | The main streaming domain. |
AppName | String | Yes | testName | The name of the application to which the live stream belongs. |
StreamName | String | No | stream | The name of the live stream. |
VodTranscodeGroupId | String | Yes | e2d796d3bb5fd8049d32bff62f94**** | The ID of the transcoding template group in ApsaraVideo VOD. |
CycleDuration | Integer | No | 300 | The recording cycle. Unit: seconds. Valid values: 300 to 21600. Default value: 3600. |
AutoCompose | String | No | OFF | Specifies whether to enable automatic merging. Valid values:
|
ComposeVodTranscodeGroupId | String | No | ***** | The ID of the transcoding template group in ApsaraVideo VOD. The template group is used to transcode the video file that is automatically generated by merging the VOD files created from live streams. Note To query transcoding template groups, call the ListTranscodeTemplateGroup operation. |
OnDemand | Integer | No | 0 | Specifies whether to enable on-demand recording. Valid values:
|
Response parameters
Parameter |
Type |
Example |
Description |
RequestId | String | 61C96B9A-F203-4EC5-8E43-CB92E68F67DF | The ID of the request. |
Examples
Sample request
http(s)://live.aliyuncs.com/?Action=UpdateLiveRecordVodConfig
&DomainName=example.com
&AppName=testName
&StreamName=stream
&VodTranscodeGroupId=e2d796d3bb5fd8049d32bff62f94****
&CycleDuration=300
&AutoCompose=OFF
&ComposeVodTranscodeGroupId=*****
&OnDemand=0
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateLiveRecordVodConfigResponse>
<RequestId>61C96B9A-F203-4EC5-8E43-CB92E68F67DF</RequestId>
</UpdateLiveRecordVodConfigResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "61C96B9A-F203-4EC5-8E43-CB92E68F67DF"
}
Error codes
HTTP status code |
Error code |
Error message |
Description |
400 | ConfigAlreadyExists | Config has already exist. | The configuration already exists. |
For a list of error codes, see Service error codes.