最近更新时间: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
}
]
}
} |