查询指定域名或者指定域名下某个应用的所有在线流信息。
接口说明
本接口目前支持以下几种流类型:
-
all:查询所有流。
-
raw:查询原始流。
-
trans:查询转码流。
QPS 限制
本接口的单用户 QPS 限制为 10000 次/分钟。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
live:DescribeLiveStreamsOnlineList |
get |
*全部资源
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
RegionId |
string |
否 |
地域 ID。 |
cn-shanghai |
DomainName |
string |
是 |
主播流域名。 说明
|
example.com |
AppName |
string |
否 |
播流所属应用名称。您可在流管理页面查看 AppName。 |
liveApp**** |
StreamName |
string |
否 |
播流名称,仅支持输入单个 StreamName。您可在流管理页面查看 StreamName。 |
liveStream**** |
OnlyStream |
string |
否 |
是否只返回指定字段。取值:
|
no |
PageSize |
integer |
否 |
每页大小。取值范围:1~3000,默认值为 2000。 |
1500 |
PageNum |
integer |
否 |
当前页码。默认值为 1。 |
1 |
StreamType |
string |
否 |
流类型。取值:
|
all |
QueryType |
string |
否 |
指定是否模糊匹配流名称。取值:
|
fuzzy |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
在线流信息。 |
||
RequestId |
string |
请求 ID。 |
5c6a2a0df228-4a64- af62-20e91b9676b3 |
TotalPage |
integer |
总页数。 |
2 |
PageNum |
integer |
分页的页码。 |
1 |
PageSize |
integer |
每页显示的条数。 |
10 |
TotalNum |
integer |
符合条件的总个数。 |
11 |
OnlineInfo |
object |
||
LiveStreamOnlineInfo |
array<object> |
正在推送流的信息。 |
|
object |
正在推送流的信息。 |
||
AudioDataRate |
integer |
直播流的音频码率。单位:Kbps。 说明
此参数需提交工单添加白名单配置后开启,关于如何提交工单,请参见联系我们。 |
600 |
FrameRate |
integer |
帧率。单位:FPS。 |
15 |
PublishUrl |
string |
推流完整 URL 地址。 |
rtmp://demo.aliyundoc.com/live/test**** |
StreamName |
string |
播流名称。 |
liveStream**** |
AudioCodecId |
integer |
音频 Codec ID。 |
10 |
Height |
integer |
视频分辨率高度。单位:pixel。 |
720 |
VideoDataRate |
integer |
直播流的视频码率。单位:Kbps。 说明
此参数需提交工单添加白名单配置后开启,关于如何提交工单,请参见联系我们。 |
600 |
DomainName |
string |
主播流域名。 |
example.com |
PublishDomain |
string |
推流域名,使用中心推流的可直接填写播流域名。 |
demo.aliyundoc.com |
PublishTime |
string |
开始推流时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。 |
2021-08-09T02:37:59Z |
AppName |
string |
播流所属应用名称。 |
liveApp**** |
PublishType |
string |
推流类型,取值:
|
edge |
VideoCodecId |
integer |
视频 Codec ID。 |
7 |
Transcoded |
string |
是否是转码流。取值:
|
no |
Width |
integer |
视频分辨率宽度。单位:pixel。 |
1280 |
ClientIp |
string |
推流客户端 IP。 |
106.11.XX.XX |
ServerIp |
string |
推流节点 IP。 |
120.221.XX.XX |
示例
正常返回示例
JSON
格式
{
"RequestId": "5c6a2a0df228-4a64- af62-20e91b9676b3",
"TotalPage": 2,
"PageNum": 1,
"PageSize": 10,
"TotalNum": 11,
"OnlineInfo": {
"LiveStreamOnlineInfo": [
{
"AudioDataRate": 600,
"FrameRate": 15,
"PublishUrl": "rtmp://demo.aliyundoc.com/live/test****",
"StreamName": "liveStream****",
"AudioCodecId": 10,
"Height": 720,
"VideoDataRate": 600,
"DomainName": "example.com",
"PublishDomain": "demo.aliyundoc.com",
"PublishTime": "2021-08-09T02:37:59Z",
"AppName": "liveApp****",
"PublishType": "edge",
"VideoCodecId": 7,
"Transcoded": "no",
"Width": 1280,
"ClientIp": "106.11.XX.XX",
"ServerIp": "120.221.XX.XX"
}
]
}
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | QpsOverLimit | Qps is over limit for this domainName. | |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | |
400 | InvalidEndTime.Mismatch | Specified end time does not match the specified start time. | |
400 | Duration.Exceed | Duration between StartTime and EndTime is too long. |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。