文档中心 > 查询录像
查询录像

最近更新时间:2022-06-15

1、功能介绍

录像查询,返回录像列表。查询时间跨度R = [StartTime, EndTime],云存储最大值31天,设备本地录像最大7天。

2、请求参数

参数

是否必选

参数类型

描述

ActionString系统指定参数。取值:QueryRecord

DeviceId

String

设备ID

StartTimeString开始时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间
EndTimeString结束时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间
StorageTypeString

存储类型。取值:device(设备端录像)、cloud(云存储)

RecordTypeString录像类型,取值:all、manu(手动)、time(定时)、alarm(告警)、local_upload(本地录像上传的录像,仅对云存储类型有效)。StorageType为device(设备端录像)时,该字段只支持all。
PageSizeInteger

分页大小,默认为20

PageNumInteger第几分页,默认为1
OrderByString排序类型:asc(正序) desc(倒序:默认)

3、响应参数

参数

是否必选

参数类型

描述

RequestId

String

该条接口请求ID

CodeString错误码 0:表示成功
MessageString提示信息
Dataobject返回数据

├─PageSize

Integer

分页大小,默认为20

├─PageNum

Integer

第几分页,默认为1
├─PageTotalInteger分页总数
├─TotalCount

Integer

录像数量
├─RecordListarray of record objects录像列表


record结构定义

参数是否必选参数类型描述

RecordType

String

录像类型,取值:all、manu(手动)、time(定时)、alarm(告警)

StartTimeString

录像文件开始时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间

EndTimeString录像文件结束时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间

Duration

Long时长,单位是秒


4、请求示例

请求示例:

GET https://api.unicloud.com/univms?

Action=QueryRecord

&DeviceID=gb763487hfdk8a

&StartTime=2021-02-10T11:12:08Z

&EndTime=2021-02-10T22:12:08Z

&RecordType=all

&StorageType=cloud

&公共请求参数

返回示例:

{
    "RequestId": "2766b7ef-7455-4d89-8ac0-de614d26b5c8",
    "Code": "0",
    "Data": {
        "PageSize": 1,
        "PageNum": 2,
        "TotalCount": 6,
        "RecordList": [
            {
                "RecordType": "manu",
                "StartTime": "2021-07-13T10:49:00Z",
                "EndTime": "2021-07-13T10:54:00Z",
                "Duration": 300
            }
        ]
    }
}