最近更新时间:2022-06-15
录像查询,返回录像列表。查询时间跨度R = [StartTime, EndTime],云存储最大值31天,设备本地录像最大7天。
参数 | 是否必选 | 参数类型 | 描述 |
---|---|---|---|
Action | 是 | String | 系统指定参数。取值:QueryRecord |
DeviceId | 是 | String | 设备ID |
StartTime | 是 | String | 开始时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间 |
EndTime | 是 | String | 结束时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间 |
StorageType | 是 | String | 存储类型。取值:device(设备端录像)、cloud(云存储) |
RecordType | 是 | String | 录像类型,取值:all、manu(手动)、time(定时)、alarm(告警)、local_upload(本地录像上传的录像,仅对云存储类型有效)。StorageType为device(设备端录像)时,该字段只支持all。 |
PageSize | 否 | Integer | 分页大小,默认为20 |
PageNum | 否 | Integer | 第几分页,默认为1 |
OrderBy | 否 | String | 排序类型:asc(正序) desc(倒序:默认) |
参数 | 是否必选 | 参数类型 | 描述 |
---|---|---|---|
RequestId | 是 | String | 该条接口请求ID |
Code | 是 | String | 错误码 0:表示成功 |
Message | 否 | String | 提示信息 |
Data | 否 | object | 返回数据 |
├─PageSize | 是 | Integer | 分页大小,默认为20 |
├─PageNum | 是 | Integer | 第几分页,默认为1 |
├─PageTotal | 否 | Integer | 分页总数 |
├─TotalCount | 是 | Integer | 录像数量 |
├─RecordList | 是 | array of record objects | 录像列表 |
record结构定义
参数 | 是否必选 | 参数类型 | 描述 |
---|---|---|---|
RecordType | 是 | String | 录像类型,取值:all、manu(手动)、time(定时)、alarm(告警) |
StartTime | 是 | String | 录像文件开始时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间 |
EndTime | 是 | String | 录像文件结束时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间 |
Duration | 是 | Long | 时长,单位是秒 |
请求示例:
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 } ] } } |