更新实时打包服务中的频道配置,包括协议、时长与切片数量等。
接口说明
请求说明
通过此 API,您可以修改实时打包服务中指定频道的配置信息。需要提供频道所在的频道组名称、频道名称,以及要更新的协议类型、分段时长和分段数量。此外,您还可以选择性地添加或修改频道的描述信息。请确保提供的频道组名称与频道名称符合规范要求。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ice:UpdateLivePackageChannel |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| GroupName |
string |
是 |
频道组名称,字符必须为大小写英文字母、数字、短横线、下划线。1 ~ 200 个字符。格式:[A-Za-z0-9_-]+ |
channel-group-1 |
| Description |
string |
否 |
描述,最大 1000 个字符 |
This is a test channel. |
| Protocol |
string |
是 |
输入协议,目前仅支持 HLS |
HLS |
| SegmentCount |
integer |
否 |
输入流 m3u8 切片个数,2~100 |
3 |
| SegmentDuration |
integer |
否 |
输入流切片时长,1~30 |
6 |
| ChannelName |
string |
是 |
频道名称,字符必须为大小写英文字母、数字、短横线、下划线。1 ~ 200 个字符。格式:[A-Za-z0-9_-]+ |
channel-1 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回的数据对象,包含更新后的实时打包频道信息及请求 ID |
||
| LivePackageChannel |
object |
实时打包频道的具体信息 |
|
| ChannelName |
string |
频道名称 |
channel-1 |
| CreateTime |
string |
创建时间 |
2024-07-16T02:24:42Z |
| Description |
string |
最大 1000 个字符的描述信息 |
This is a test channel. |
| GroupName |
string |
频道组名称 |
channel-group-1 |
| IngestEndpoints |
array<object> |
输入端点数组 |
|
|
object |
输入端点 |
||
| Id |
string |
输入端点 ID |
ingest1 |
| Password |
string |
密码 |
2F9e******b569c8 |
| Url |
string |
输入端点 URL |
http://xxx-1.packagepush-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest |
| Username |
string |
用户名 |
us12******das |
| LastModified |
string |
最后修改时间 |
2024-07-16T02:24:42Z |
| Protocol |
string |
输入流协议,支持 HLS |
HLS |
| SegmentCount |
integer |
输入流切片个数 |
3 |
| SegmentDuration |
integer |
输入流切片时长 |
5 |
| RequestId |
string |
请求 ID |
771A1414-27BF-53E6-AB73-EFCB*****ACF |
示例
正常返回示例
JSON格式
{
"LivePackageChannel": {
"ChannelName": "channel-1",
"CreateTime": "2024-07-16T02:24:42Z",
"Description": "This is a test channel.",
"GroupName": "channel-group-1",
"IngestEndpoints": [
{
"Id": "ingest1",
"Password": "2F9e******b569c8",
"Url": "http://xxx-1.packagepush-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest",
"Username": "us12******das"
}
],
"LastModified": "2024-07-16T02:24:42Z",
"Protocol": "HLS",
"SegmentCount": 3,
"SegmentDuration": 5
},
"RequestId": "771A1414-27BF-53E6-AB73-EFCB*****ACF"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。