# 【旧】查询通道的云端录像列表 #### 功能介绍 查询通道的云端录像列表 #### URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cloud-records 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | user_id | 是 | String | 用户ID：由数字组成，长度范围\[15,25\]，获取方式参考[获取user ID与下载AK/SK](https://support.huaweicloud.com/api-ivm/ivm_03_0005.html#ZH-CN_TOPIC_0000001710465704__section1213543912215)章节 | | device_id | 是 | String | 设备ID： 好望设备：大小写字母、数字组成，长度范围\[8,32\]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度固定为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR），用来区分设备类型 | | channel_id | 是 | String | 通道ID： 好望设备：取值范围\[0,999\] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | start_time | 是 | String | 开始时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 | | end_time | 是 | String | 结束时间：格式如：yyyy-MM-dd HH:mm:ss，北京时间 | | limit | 否 | Integer | 单页数量：取值范围\[1,1000\]，不填写时默认值为 10 | | offset | 否 | Integer | 偏移量：offset为0时表示查询第一页的数据，取值范围\[0,1000000\]，不填写时默认为 0 | | record_type | 否 | String | 录像类型：枚举类型，不填则默认包含以下两种录像类型 枚举值： - **NORMAL_RECORD** 全量录像 - **MOTION_RECORD** 动检录像 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Access-Token | 是 | String | 用户认证AccessToken：从[获取用户北向接口认证AccessToken](https://support.huaweicloud.com/api-ivm/ivm_03_0002.html)中获取 | #### 响应参数 **状态码： 200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 录像列表总数 | | device_id | String | 设备ID：设备唯一标识，长度范围\[1,32\] | | channel_id | String | 通道ID：长度范围\[1,20\] | | records | Array of [Record] objects | 录像列表信息 | 表5Record | 参数 | 参数类型 | 描述 | |:---|:---|:---| | record_id | String | 录像ID：长度范围\[1,32\] | | record_name | String | 录像名称：长度范围\[1,32\] | | record_type | String | 录像类型：枚举类型 枚举值： - **NORMAL_RECORD** 全量录像 - **MOTION_RECORD** 动检录像 | | record_size | Integer | 录像文件大小：单位（字节） | | alarm_rec_type | String | 告警录像类型：枚举类型，非告警录像值为空（**null**） | | start_time | String | 录像开始时间：格式如：yyyy-MM-dd HH:mm:ss，2020-06-12 17:31:00 | | end_time | String | 录像结束时间：格式如：yyyy-MM-dd HH:mm:ss，2020-06-12 17:31:00 | #### 请求示例 查询云端的录像列表 ``` GET /v1/2562572829***/devices/952352LWXT***/channels/0/cloud-records?start_time=2020-07-15 14:32:00&end_time=2020-07-15 15:32:00&record_type=NORMAL_RECORD&limit=15&offset=10 ``` #### 响应示例 **状态码： 200** OK ``` { "total" : 1, "device_id" : "952352LWXT***", "channel_id" : "0", "records" : [ { "record_id" : "1000000", "start_time" : "2020-06-12 17:31:00", "end_time" : "2020-06-13 12:50:00", "record_name" : "录像1", "record_size" : 1024, "record_type" : "NORMAL_RECORD" } ] } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-ivm/ivm_03_0136.html) #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ivm/ivm_03_0137.html)