调用UpdateLivePackageConfig更新直播封装配置。
接口说明
调用本接口更新直播封装配置,重新推流后生效。
QPS 限制
本接口的单用户 QPS 限制为 300 次/分钟。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
live:UpdateLivePackageConfig |
*Domain
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
||
| DomainName |
string |
是 |
直播域名(主播放域名)。 |
example.com |
| AppName |
string |
是 |
AppName 名称与推流地址中的 AppName 名称对应,模板才能生效。不超过 255 字符,支持数字、大小写字母、短横线(-)、下划线(_),短横线、下划线不能位于首位。也支持取值为单个星号(*)字符,即可匹配所有 AppName。 |
AppName |
| StreamName |
string |
是 |
StreamName 名称与推流地址中的 StreamName 名称对应,模板才能生效。不超过 255 字符,支持数字、大小写字母、短横线(-)、下划线(_),短横线、下划线不能位于首位。也支持取值为单个星号(*)字符,即可匹配所有 StreamName。 |
StreamName |
| Protocol |
string |
是 |
直播协议与封装格式。取值:
|
HLS_CMAF |
| SegmentNum |
integer |
是 |
直播 M3U8 切片个数。取值范围:3~10。 |
3 |
| SegmentDuration |
integer |
是 |
切片时长,单位:秒。
|
5 |
| PartDuration |
integer |
否 |
Part 切片时长,单位:毫秒。 说明
当 Protocol 为 LLHLS_*时,该参数为必填项。
|
350 |
| IgnoreTranscode |
boolean |
否 |
是否忽略转码流,取值:
|
true |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
示例
正常返回示例
JSON格式
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | MissingParam | %s | |
| 400 | InvalidParams | %s | |
| 400 | InvalidProtocol | %s | |
| 400 | InvalidSegmentNum | %s | |
| 400 | InvalidSegmentDuration | %s | |
| 400 | InvalidPartDuration | %s | |
| 500 | InternalErr | %s | |
| 404 | ConfigNotFound | %s | |
| 409 | ConfigConflicts | %s |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。