ListStreams - 视频流列表--慢直播-火山引擎

文档中心

立即注册

导航

ListStreams - 视频流列表

最近更新时间：2025.06.06 14:20:32首次发布时间：2021.11.25 17:21:46

查询指定空间内已创建的视频流列表。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	ListStreams	要执行的操作，取值：ListStreams。
Version	String	是	2021-01-01	API的版本，取值：2021-01-01。
PageNumber	String	否	1	每页数量
PageSize	String	否	10	页数
SpaceID	String	是	517ff7ec-7700-4862-b1e7-7967a4xxxxxx	空间 ID，可通过调用 ListSpaces 接口获取
StreamName	String	否	demo_stream	筛选条件，视频流名称，支持模糊查询，可通过调用 CreateStream 接口获取

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
PageNumber	Integer	1	PageNumber
PageSize	Integer	20	PageSize
TotalCount	Integer	10	TotalCount
Streams	Array of Object		查询到的设备信息列表，参考以下 `List<Stream>` 结构说明

请求示例

GET https://open.volcengineapi.com?Action=ListStreams&Version=2021-01-01&SpaceID=517ff7ec-7700-4862-b1e7-7967a4xxxxxx&StreamName=

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021120815283601021117309810012896",
        "Action": "ListStreams",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "PageNumber": 1,
        "PageSize": 20,
        "TotalCount": 10,
        "Streams": [
            {
                "SpaceID": "517ff7ec-7700-4862-b1e7-7967a4xxxxxx",
                "SIPID": "34020000002000xxxxxx",
                "StreamName": "34020033991320xxxxxx_34020033991320384963",
                "StreamID": "4b9ee060-9fed-4c0e-aaa4-283b17xxxxxx",
                "SpaceAccessType": "gb28181",
                "DeviceID": "0a32c128-c89c-4f39-aa60-66e5f1xxxxxx",
                "DeviceNSID": "34020033991320xxxxxx",
                "ChannelID": "34020033991320xxxxxx",
                "Status": "online",
                "StreamingType": "main_stream",
                "Description": "channel: 34020033991320xxxxxx@device: 34020033991320xxxxxx",
                "Screenshot": {
                    "TemplateName": "",
                    "TemplateID": ""
                },
                "Record": {
                    "TemplateName": "online-record-1022",
                    "TemplateID": "1f5704dc-8d31-4547-9534-1ac40bxxxxxx"
                },
                "AI": {
                    "TemplateName": "car0121",
                    "TemplateID": "1c443146-8d6a-44d5-baf8-5efafcxxxxxx"
                },
                "CreatedAt": "2023-06-13T16:20:28+08:00",
                "UpdatedAt": "2023-06-13T16:22:28+08:00",
                "PushUrlDDL": 1687383521,
                "RTMPushUrl": "https://xxx-push.xx/xxx.sdp?Time=123&Secret=xxx",
                "PullUrls": [
                    "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx",
                    "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv",
                    "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8"
                ],
                "TransPullUrls": {
                    "flv": [
                        "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv",
                        "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv",
                        "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv",
                        "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.flv"
                    ],
                    "hls": [
                        "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8",
                        "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8",
                        "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8",
                        "https://prcldt8wqxxxxxx.pull.xxx.com/xxx.m3u8"
                    ],
                    "rtmp": [
                        "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx",
                        "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx",
                        "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx",
                        "rtmp://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx_xxx"
                    ],
                    "webrtc": [
                        "https://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx.sdp",
                        "https://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx.sdp",
                        "https://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx.sdp",
                        "https://m8v21xhnuzxxxxxx.pull.xxx.com/xxx/xxx_xxx.sdp"
                    ]
                },
                "FailedTimes": 0,
                "RecentPushTs": "2021-11-30T17:07:35+08:00",
                "RtpTransportTcp": true,
                "Resolution": "6",
                "Logs": [
                    {
                        "LogTime": 1638603119124,
                        "LogLevel": 2,
                        "Message": "invite message send failed"
                    }
                ]
            }
        ]
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。