# 查询通道的云端录像列表（好望云平台）（API名称：getCloudRecords）
#### 功能介绍
该接口用于查询通道的云端录像列表。
#### 相关API
| **接口名称**                                                             | **调用说明**                                                                                                 |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。                                             |
| [获取设备列表](https://support.huaweicloud.com/api-isdp/api_01_0135.html)  | 调用该接口获取设备编号和通道ID。 查询通道的云端录像列表时，需要输入设备编号和通道ID。 |
   
#### 调用流程
图1查询通道的云端录像列表流程   
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002522854527.png "点击放大")
#### URL
| **请求方式** | **HTTPS地址**                                                | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/ivmRemote/getCloudRecords | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| **参数**     | **类型** | **是否必填** | **描述**                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| channelId  | String | 是        | 通道ID 获取通道ID API请参见：[摄像头列表查询（好望云平台）（API名称：getDeviceList）](https://support.huaweicloud.com/api-isdp/api_01_0135.html)                                                                                   |
| deviceId   | String | 是        | 设备编号 获取设备编号API请参见：[摄像头列表查询（好望云平台）（API名称：getDeviceList）](https://support.huaweicloud.com/api-isdp/api_01_0135.html)                                                                                     |
| endTime    | String | 是        | 结束时间，格式如：yyyy-MM-dd HH:mm:ss，北京时间                                                                                                                                                                                                                                 |
| limit      | int    | 否        | 单页数量，取值范围\[1,1000\]，不填写时默认值为10 最小值：1 最大值：1000 缺省值：10                             |
| offset     | int    | 否        | 偏移量，offset为0时表示查询第一页的数据，取值范围\[0,2147483646\]，不填写时默认为0 最小值：0 最大值：2147483646 缺省值：0 |
| recordType | String | 否        | 录像类型，全量录像：NORMAL_RECORD 动检录像：MOTION_RECORD 不传，则默认两种类型                                                                                                                                                  |
| startTime  | String | 是        | 开始时间，格式如：yyyy-MM-dd HH:mm:ss，北京时间                                                                                                                                                                                                                                 |
   
#### 响应参数
| **参数**     | **类型**                  | **描述** |
|:---|:---|:---|
| total      | int                     | 录像列表总数 |
| device_id  | String                  | 设备ID   |
| channel_id | String                  | 通道ID   |
| records    | Array of Record objects | 录像列表信息 |
   
records出参：
| **参数**      | **类型** | **描述**                                                                                                                                                           |
|:---|:---|:---|
| record_id   | String | 录像ID                                                                                                                                                             |
| record_name | String | 录像名称                                                                                                                                                             |
| record_type | String | 录像类型： 全量录像：ALL_RECORD 动检录像：MOTION_RECORD |
| record_size | int    | 录像文件大小，单位（字节）                                                                                                                                                    |
| start_time  | String | 录像开始时间                                                                                                                                                           |
| end_time    | String | 录像结束时间                                                                                                                                                           |
   
#### 请求示例
```
{
    " deviceId ": " D2102412469WLL3000011",
    " channelId ": "1",
    " endTime ": "2021-2-2 15:30:30",
    " startTime ": "2021-2-1 00:30:30"
}
```
#### 响应示例
```
{
    "total": 1,
    "device_id": "D2102412469WLL3000011",
    "channel_id": "1",
    "records": [
        {
            "record_id": "1000000",
            "start_time": "2020-2-1 17:31:00",
            "end_time": "2020-2-2 12:50:00",
            "record_name": "录像1",
            "record_size": 1024,
            "record_type": "NORMAL_RECORD",
        }
    ],
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。