Updates a live stream encapsulation configuration.
Usage notes
You can call this operation to update a live stream encapsulation configuration. The update takes effect only after you re-ingest the stream.
QPS limit
You can call this operation up to 300 times per minute per account. Requests that exceed this limit are dropped and you will 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 | UpdateLivePackageConfig | The operation that you want to perform. Set the value to UpdateLivePackageConfig. |
DomainName | String | Yes | example.com | The main streaming domain. |
AppName | String | Yes | AppName | The application name. The value |
StreamName | String | Yes | StreamName | The stream name. The value |
Protocol | String | Yes | HLS_CMAF | The streaming protocol and encapsulation format. Valid values:
|
SegmentNum | Integer | Yes | 3 | The number of segments.
|
SegmentDuration | Integer | Yes | 5 | The segment length. Unit: seconds.
|
PartDuration | Integer | No | 350 | The part length. Unit: milliseconds.
|
IgnoreTranscode | Boolean | No | true | Specifies whether to ignore the transcoded stream. Valid values:
|
Response parameters
Parameter |
Type |
Example |
Description |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 | The request ID. |
Examples
Sample requests
http(s)://live.aliyuncs.com/?Action=UpdateLivePackageConfig
&DomainName=example.com
&AppName=AppName
&StreamName=StreamName
&Protocol=HLS_CMAF
&SegmentNum=3
&SegmentDuration=5
&PartDuration=350
&IgnoreTranscode=true
&Common request parameters
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateLivePackageConfigResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</UpdateLivePackageConfigResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
Error codes
For a list of error codes, see Service error codes.