You need to enable JavaScript to run this app.
慢直播

慢直播

请输入
  • 文档首页
    • 慢直播API 参考录制管理ListDeviceRecords - 云端回放列表
复制全文
我的收藏
录制管理
ListDeviceRecords - 云端回放列表
复制全文
我的收藏
ListDeviceRecords - 云端回放列表

查询指定设备在云端保存的视频回放列表。

请求说明

  • 请求方式：POST
  • 请求地址：https://open.volcengineapi.com?Action=ListDeviceRecords&Version=2021-01-01

请求参数

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

Query

参数类型是否必选示例值描述
ActionString是ListDeviceRecords接口名称。当前 API 的名称为 ListDeviceRecords。
VersionString是2021-01-01接口版本。当前 API 的版本为 2021-01-01。
SpaceIDString是cd9fa8a7-12a2-405b-a5f1-faaddfxxxxxx空间 ID，可通过调用 ListSpaces 接口获取

StreamID

String

否

b7a20edd-8e60-4f46-b4a9-6ae079xxxxxx

视频流 ID，可通过调用 ListStreams 接口获取

说明：与 “DeviceNSID+ ChannelID+ StreamingIndex+ Resolution” 组合二选一

DeviceNSIDString否设备国标 ID，说明：“DeviceNSID+ ChannelID+ StreamingIndex+ Resolution” 组合中，DeviceNSID 和 ChannelID 必传，StreamingIndex 和Resolution 选传
ChannelIDString否通道 ID，undefined

StreamingIndex

Integer

否

主子码流编号：

  • 0：主码流
  • 1~n: 子码流，undefined
ResolutionString否分辨率编码（可参考 GB28181-2022 协议附录G中的定义），undefined
ReqTypeString否请求类型，支持 record_metadata，用于查询ts文件

Body

参数类型是否必选示例值描述
StartTsString是2023-07-01T17:49:30+08:00查询的起始时间，例如：2023-07-03T18:30:00+08:00
EndTsString是2023-07-02T16:20:00+08:00查询的结束时间，例如：2023-07-03T18:40:00+08:00

返回参数

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

参数类型示例值描述

Type

String

查询对象的类型：

  • record：视频
  • record_metadata：元数据

Path

String

文件路径：

  • record 和 screenshot 查询对象返回完整的 URL
  • record_metadata 查询对象返回对象存储中的 key，结合 RecordMeta 中的 bucket 可以定位文件
RecordObject of Record视频信息，参考以下 Record 数据结构说明
RecordMetaObject of RecordMeta元数据信息，参考以下 RecordMeta 数据结构说明

Record

参数类型示例值描述
StartTsString视频开始时间，例如：2021-12-06T17:49:32+08:00
EndTsString视频结束时间，例如：2021-12-06T17:59:32+08:00
DurationFloat视频时长，单位：毫秒
CoverString视频封面地址
FormatString文件格式：mp4/hls

RecordMeta

参数类型示例值描述
StartTsString视频开始时间，例如：2021-12-06T17:49:32+08:00
EndTsString视频结束时间，例如：2021-12-06T17:59:32+08:00
DurationFloat视频时长，单位：毫秒
FormatString视频格式：ts
BucketString对象存储中的存储桶名称

StorageType

String

在对象存储中保存录像文件的类型：

  • STANDARD（标准存储）
  • IA（低频存储）
  • ARCHIVE_FR（归档闪回存储）
  • COLD_ARCHIVE（冷归档存储）
  • NOT_FOUND（文件被删除）
  • UNKNOWN（未知状态）

请求示例 

POST https://open.volcengineapi.com?Action=ListDeviceRecords&Version=2021-01-01&SpaceID=cd9fa8a7-12a2-405b-a5f1-faaddfxxxxxx&StreamID=b7a20edd-8e60-4f46-b4a9-6ae079xxxxxx&DeviceNSID=&ChannelID=&StreamingIndex=&Resolution=&ReqType=
{
    "StartTs": "2023-07-01T17:49:30+08:00",
    "EndTs": "2023-07-02T16:20:00+08:00"
}

返回示例 

{
    "ResponseMetadata": {
        "RequestId": "20211208184328010211197144090010CF",
        "Action": "ListDeviceRecords",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": [
        {
            "Type": "record",
            "Path": "https://xxx.xxx.com/api/top/aiotvideo/PlayStreamRes/2021-01-01/?PlayUrl=UmVzUGF0aD1VR0ZuWlU1MWJUMHhKbEJoWjJWVGFYcGxQVEl3Sms5bVpuTmxkRDB5TUNaRVlYUmxSbkp2YlQweU1ESXhMVEV5TFRBMlZERTNPalE1T2pNeWZEQTRPakF3SmtSaGRHVlViejB5TURJeExURXlMVEEyVkRFM09qVTVPak15ZkRBNE9qQXdKa1IxY21GMGFXOXVQVFl3TUE9PSZSZXFUeXBlPXJlY29yZCZSZXNPd25lcj1iN2EyMGVkZC04ZTYwLTRmNDYtYjRhOS02YWUwNzkxNzQyZmUmTTNVOD0x",
            "Record": {
                "StartTs": "2021-12-06T17:49:32+08:00",
                "EndTs": "2021-12-06T17:59:32+08:00",
                "Duration": 6000,
                "Cover": "https://xxx.xxx.com/push-rtmp-2100053143-gb-1026.push.bfcdnbf.com/2100053143-gb-1026/34020084991320545039_34020084991320545039/20211206095924318.jpeg",
                "Format": "mp4"
            }
        },
        {
            "Type": "record_metadata",
            "Path": "tos_key",
            "RecordMeta": {
                "StartTs": "2021-12-06T17:59:32+08:00",
                "EndTs": "2021-12-06T18:09:32+08:00",
                "Duration": 4000,
                "Format": "ts",
                "Bucket": "test-zh",
                "StorageType": "STANDARD"
            }
        }
    ]
}

错误码

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

最近更新时间：2026.03.30 15:21:33
这个页面对您有帮助吗？
有用
有用
无用
无用