查询通道的云端录像列表(好望云平台)(API名称:getCloudRecords)
功能介绍
该接口用于查询通道的云端录像列表。
相关API
调用流程
![点击放大](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000001748565461.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中获取的access_token的值 |
请求参数
参数 |
类型 |
是否必填 |
描述 |
---|---|---|---|
channelId |
String |
是 |
通道ID 获取通道ID API请参见:摄像头列表查询(好望云平台)(API名称:getDeviceList) |
deviceId |
String |
是 |
设备编号 获取设备编号API请参见:摄像头列表查询(好望云平台)(API名称:getDeviceList) |
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", } ], }
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。