查询直播域名下所有APP录制配置。
接口说明
先获取主播流域名,再调用本接口查询直播域名下所有 APP 录制配置。
QPS 限制
本接口的单用户 QPS 限制为 100 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
live:DescribeLiveRecordConfig |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DomainName |
string |
是 |
主播流域名。 |
example.com |
| AppName |
string |
否 |
播流所属应用名称。 |
liveApp**** |
| StreamName |
string |
否 |
播流名称。 |
liveStream**** |
| PageNum |
integer |
否 |
当前页码。默认值:1。 |
1 |
| PageSize |
integer |
否 |
每页大小。默认值:10,取值范围:5~30。 |
5 |
| Order |
string |
否 |
按创建时间排序。取值:
|
asc |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| PageNum |
integer |
分页的页码。 |
5 |
| RequestId |
string |
请求 ID。 |
5056369B-D337-499E-B8B7-B761BD37B08A |
| Order |
string |
排序。 |
desc |
| TotalPage |
integer |
总页数。 |
20 |
| PageSize |
integer |
每页大小。 |
10 |
| TotalNum |
integer |
符合条件的总个数。 |
12 |
| LiveAppRecordList |
object |
||
| LiveAppRecord |
array<object> |
录制配置列表。 |
|
|
array<object> |
录制配置列表。 |
||
| EndTime |
string |
计划录制结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。 |
2018-11-08T03:49:18Z |
| StartTime |
string |
计划录制开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。 |
2018-11-08T02:49:18Z |
| AppName |
string |
播流所属应用名称。 |
liveApp**** |
| StreamName |
string |
直播流名称。 |
liveStream**** |
| DelayTime |
integer |
断流拼接时长。 直播断流时长超过设定的拼接时长后,将会生成新文件,断流拼接时长支持 15~21600 秒。 |
180 |
| CreateTime |
string |
创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。 |
2016-05-20T09:33:38Z |
| OnDemond |
integer |
按需录制。取值:
说明
当 OnDemand 取值为 1 时,需要先通过 AddLiveRecordNotifyConfig 接口配置 OnDemandUrl,否则默认不录制。 |
0 |
| OssBucket |
string |
OSS 存储 Bucket 名称。 |
liveBucket**** |
| DomainName |
string |
主播流域名。 |
example.com |
| OssEndpoint |
string |
OSS 存储的 Endpoint 名称。 |
cn-oss-****.aliyuncs.com |
| RecordFormatList |
object |
||
| RecordFormat |
array<object> |
格式列表。 |
|
|
object |
格式列表。 |
||
| SliceDuration |
integer |
转码流录制单个切片时长。单位:秒。 |
30 |
| CycleDuration |
integer |
周期录制时间。单位:秒。 |
3600 |
| SliceOssObjectPrefix |
string |
切片名称。 |
record/{liveApp****}/{liveStream****}/{UnixTimestamp} |
| OssObjectPrefix |
string |
录制文件名称。 |
record/{liveApp****}/{liveStream****} |
| Format |
string |
格式。 |
M3U8 |
| TranscodeRecordFormatList |
object |
||
| RecordFormat |
array<object> |
转码流录制格式列表。 |
|
|
object |
录制配置文件格式列表。 |
||
| SliceDuration |
integer |
转码流录制单个切片时长。单位:秒。 |
30 |
| CycleDuration |
integer |
周期录制时间。单位:秒。 |
3600 |
| SliceOssObjectPrefix |
string |
转码流录制切片名称。 |
record/{liveApp****}/{liveStream****}/{UnixTimestamp} |
| OssObjectPrefix |
string |
转码流录制文件名称。 |
record/{liveApp****}/{liveStream****} |
| Format |
string |
转码流录制格式。 |
M3U8 |
| TranscodeTemplates |
object |
||
| Templates |
array |
转码模板。 |
|
|
string |
转码流录制的转码模板。设置了录制所有转码流,则返回为["*"]。 |
["sd","hd"] |
示例
正常返回示例
JSON格式
{
"PageNum": 5,
"RequestId": "5056369B-D337-499E-B8B7-B761BD37B08A",
"Order": "desc",
"TotalPage": 20,
"PageSize": 10,
"TotalNum": 12,
"LiveAppRecordList": {
"LiveAppRecord": [
{
"EndTime": "2018-11-08T03:49:18Z",
"StartTime": "2018-11-08T02:49:18Z",
"AppName": "liveApp****",
"StreamName": "liveStream****",
"DelayTime": 180,
"CreateTime": "2016-05-20T09:33:38Z",
"OnDemond": 0,
"OssBucket": "liveBucket****",
"DomainName": "example.com",
"OssEndpoint": "cn-oss-****.aliyuncs.com",
"RecordFormatList": {
"RecordFormat": [
{
"SliceDuration": 30,
"CycleDuration": 3600,
"SliceOssObjectPrefix": "record/{liveApp****}/{liveStream****}/{UnixTimestamp}",
"OssObjectPrefix": "record/{liveApp****}/{liveStream****}",
"Format": "M3U8"
}
]
},
"TranscodeRecordFormatList": {
"RecordFormat": [
{
"SliceDuration": 30,
"CycleDuration": 3600,
"SliceOssObjectPrefix": "record/{liveApp****}/{liveStream****}/{UnixTimestamp}",
"OssObjectPrefix": "record/{liveApp****}/{liveStream****}",
"Format": "M3U8"
}
]
},
"TranscodeTemplates": {
"Templates": [
"[\"sd\",\"hd\"]"
]
}
}
]
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。