有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

AIConfig

AI分析配置

被如下接口引用:AddAITask, UpdateAITask。

名称 类型 必选 描述
DetectType String AI 分析类型。可选值为 Facemask(口罩识别)、Chefhat(厨师帽识别)、Smoking(抽烟检测)、Chefcloth(厨师服识别)、PhoneCall(接打电话识别)、Pet(宠物识别)、Body(人体识别)和Car(车辆车牌识别)等
示例值:Pet
TimeInterval Integer 截图频率。可选值1~20秒
示例值:10
OperTimeSlot Array of OperTimeSlot 模板生效的时间段。最多包含5组时间段

AITaskInfo

AI任务信息

被如下接口引用:AddAITask, DescribeAITask, ListAITasks, UpdateAITask。

名称 类型 必选 描述
TaskId String AI 任务 ID
示例值:at0251f55fd5fe4adba237a44f****
Name String AI 任务名称
示例值:测试任务1
Desc String AI 任务描述
示例值:用于测试
Status String AI 任务状态。"on"代表开启了 AI 分析任务,"off"代表停止 AI 分析任务
示例值:on
ChannelList Array of String 通道 ID 列表
示例值:f7ca505f-be1b-4ce8-849b-****
CallbackUrl String AI 结果回调地址
示例值:https://**
Templates Array of AITemplates AI 配置列表
CreatedTime String 创建时间
示例值:2023-06-07 10:35:36
UpdatedTime String 更新时间
示例值:2023-06-07 10:35:36

AITaskResultData

AI识别结果

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
TaskId String AI 任务 ID
示例值:at0251f55fd5fe4adba237**
AIResultCount Integer 在 BeginTime 和 EndTime 时间之内,有识别结果的 AI 调用次数(分页依据此数值)
示例值:10
AIResults AITaskResultInfo AI 任务执行结果详情
注意:此字段可能返回 null,表示取不到有效值。

AITaskResultInfo

AI分析结果详情

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Body Array of BodyAIResultInfo 人体识别结果列表
注意:此字段可能返回 null,表示取不到有效值。
Pet Array of PetAIResultInfo 宠物识别结果列表
注意:此字段可能返回 null,表示取不到有效值。
Car Array of CarAIResultInfo 车辆车牌识别结果列表
注意:此字段可能返回 null,表示取不到有效值。
ChefHat Array of ChefHatAIResultInfo 厨师帽结果列表
注意:此字段可能返回 null,表示取不到有效值。
ChefCloth Array of ChefClothAIResultInfo 厨师服结果列表
注意:此字段可能返回 null,表示取不到有效值。
FaceMask Array of FaceMaskAIResultInfo 口罩识别结果列表
注意:此字段可能返回 null,表示取不到有效值。
Smoking Array of SmokingAIResultInfo 抽烟检测结果列表
注意:此字段可能返回 null,表示取不到有效值。
PhoneCall Array of PhoneCallAIResultInfo 接打电话识别结果列表
注意:此字段可能返回 null,表示取不到有效值。

AITemplates

AI模板信息

被如下接口引用:AddAITask, DescribeAITask, ListAITasks, UpdateAITask。

名称 类型 必选 描述
Tag String AI 类别。可选值 AI(AI 分析)和 Snapshot(截图),Templates 列表中只能出现一种类型。
示例值:AI
AIConfig AIConfig AI 分析配置。和"SnapshotConfig"二选一。
SnapshotConfig SnapshotConfig 截图配置。和"AIConfig"二选一。

AddDeviceData

增加设备接口返回数据

被如下接口引用:AddUserDevice。

名称 类型 描述
DeviceId String 设备iD
注意:此字段可能返回 null,表示取不到有效值。
示例值:f8656fa3-e7fa-4cad-a4cc-****
Code String 设备编码(国标设备即我们为设备生成的20位国标编码,rtmp 设备为10 位设备编码)
注意:此字段可能返回 null,表示取不到有效值。
示例值:6101320000132000****
Name String 设备名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:设备1
AccessProtocol Integer 设备接入协议,1:RTMP,2:GB,3:GW
注意:此字段可能返回 null,表示取不到有效值。
示例值:3
Type Integer 设备类型,1:IPC,2:NVR
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
ClusterId String 设备接入服务节点ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:b2181417-03ce-4ea3-ae39-****
ClusterName String 设备接入服务节点名称

注意:此字段可能返回 null,表示取不到有效值。
示例值:上海1
TransportProtocol Integer 设备流传输协议,1:UDP,2:TCP
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Password String 设备密码
注意:此字段可能返回 null,表示取不到有效值。
示例值:111111
Description String 设备描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:这个是gw设备
Status Integer 设备状态,0:未注册,1:在线,2:离线,3:禁用
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
OrganizationId Integer 设备所属组织ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:237
GatewayId String 设备接入网关ID,从查询网关列表接口中获取(仅网关接入需要)
注意:此字段可能返回 null,表示取不到有效值。
示例值:f6d2540d-1d13-4873-b10e-****
ProtocolType Integer 网关接入协议类型,1.海康SDK,2.大华SDK,3.宇视SDK,4.Onvif(仅网关接入需要)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Ip String 设备接入IP(仅网关接入需要)
注意:此字段可能返回 null,表示取不到有效值。
示例值:192.168.**.1
Port Integer 设备Port(仅网关接入需要)
注意:此字段可能返回 null,表示取不到有效值。
示例值:9000
Username String 设备用户名(仅网关接入需要)
注意:此字段可能返回 null,表示取不到有效值。
示例值:admin
AppId Integer 用户ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:130****012

AddOrgData

增加组织接口返回数据

被如下接口引用:AddOrganization。

名称 类型 描述
OrganizationId String 组织 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:237
Name String 组织名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:组织1
ParentId String 组织父节点 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:236
Level Integer 组织层级
注意:此字段可能返回 null,表示取不到有效值。
示例值:3
AppId Integer 用户ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:1300***012
ParentIds String 组织结构
注意:此字段可能返回 null,表示取不到有效值。
示例值:0,236
Total Integer 设备总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
Online Integer 设备在线数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:6

AddRecordBackupPlanData

新增录像上云计划返回数据

被如下接口引用:AddRecordBackupPlan。

名称 类型 描述
PlanId String 录像上云计划ID
示例值:f06d500f-64fb-42c0-b804-****
PlanName String 录像上云计划名称
示例值:录像上云计划1
TemplateId String 录像上云模板ID
示例值:584fd9d0-569c-4153-aff7-****
Describe String 录像上云计划描述
示例值:这是计划1
LifeCycle LifeCycleData 云文件生命周期
Status Integer 录像上云计划状态,1:正常使用中,0:删除中,无法使用
示例值:1
ChannelCount Integer 通道数量
示例值:10
CreateAt String 创建时间
示例值:2023-09-06 15:52:34
UpdateAt String 修改时间
示例值:2023-09-06 15:52:34

AddRecordBackupTemplateData

新增录像上云模板返回数据

被如下接口引用:AddRecordBackupTemplate。

名称 类型 描述
TemplateId String 模板ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:584fd9d0-569c-4153-aff7-****
TemplateName String 模板名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:模板1
TimeSections Array of RecordTemplateTimeSections 上云时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
注意:此字段可能返回 null,表示取不到有效值。
DevTimeSections Array of RecordTemplateTimeSections 录像时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
注意:此字段可能返回 null,表示取不到有效值。
Scale Integer 上云倍速(支持1,2,4倍速)
注意:此字段可能返回 null,表示取不到有效值。
示例值:2
CreateAt String 创建时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:52:34
UpdateAt String 更新时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:52:34

AddRecordRetrieveTaskData

查询取回任务详情返回数据

被如下接口引用:AddRecordRetrieveTask。

名称 类型 描述
TaskId String 任务ID
示例值:d00a3e6f9b9*40cebcee7a6
TaskName String 任务名称
示例值:1月23号取回
StartTime Integer 取回录像的开始时间
示例值:1687688595
EndTime Integer 取回录像的结束时间
示例值:1687692195
Mode Integer 取回模式,1:极速模式,其他暂不支持
示例值:1
Expiration Integer 副本有效期
示例值:3
Status Integer 任务状态,0:已取回,1:取回中,2:待取回
示例值:0
Capacity Float 取回容量,单位MB
示例值:100
Describe String 任务描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:大门口通道取回

AddStreamAuthData

设置推拉流鉴权返回数据结构

被如下接口引用:AddStreamAuth。

名称 类型 描述
Id String 鉴权配置ID(uuid)
注意:此字段可能返回 null,表示取不到有效值。
示例值:e8317c5b-7087-4126-bca0-****
PullState Integer 是否开播放鉴权(1:开启,0:关闭)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
PullSecret String 播放密钥(仅支持字母数字,长度0-10位)
注意:此字段可能返回 null,表示取不到有效值。
示例值:aaaaaa
PullExpired Integer 播放过期时间(单位:分钟)
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
PushState Integer 是否开启推流鉴权(1:开启,0:关闭)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
PushSecret String 推流密钥(仅支持字母数字,长度0-10位)
注意:此字段可能返回 null,表示取不到有效值。
示例值:bbbbbb
PushExpired Integer 推流过期时间(单位:分钟)
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
AppId Integer 用户ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:1300***012

BaseAIResultInfo

通用AI识别结果信息

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Name String 名称。返回值有人体识别结果名称(person)、宠物识别结果名称(cat和dog) 、车辆车牌识别结果名称(vehicle)
示例值:pet
Score Integer 置信度
示例值:90
Location Location 截图中坐标信息

BatchOperateDeviceData

批量操作设备返回结果

被如下接口引用:BatchOperateDevice。

名称 类型 描述
TaskId String 任务 ID(用于在查询任务的子任务列表接口ListSubTasks中查询任务进度)
注意:此字段可能返回 null,表示取不到有效值。
示例值:**----****

BitRateInfo

视频通道码率返回结果

被如下接口引用:DescribeVideoBitRate。

名称 类型 描述
ChannelId String 通道Id
注意:此字段可能返回 null,表示取不到有效值。
示例值:"ffefbe2f-a5a2-4659-a56f-7596a0e13900"
Bitrate Float 码率,单位:kbps
注意:此字段可能返回 null,表示取不到有效值。
示例值:15.23

BodyAIResultInfo

人体识别结果详情

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Time String 时间字符串
示例值:2023-10-10 12:30:00
Url String 截图 URL
示例值:https://****
BodyInfo Array of BaseAIResultInfo 人体信息

CarAIResultInfo

车辆车牌识别结果信息

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Serial String 车系
示例值:奔驰S级
Brand String 车辆品牌
示例值:奔驰
Type String 车辆类型
示例值:轿车
Color String 车辆颜色
示例值:黑
Confidence Integer 置信度,0 - 100
示例值:98
Year Integer 年份,识别不出年份时返回0
示例值:0
PlateContent PlateContent 车牌信息
Location Location 截图中坐标信息

ChannelInfo

通道及通道所属设备信息

被如下接口引用:AddRecordBackupPlan, AddRecordPlan, AddRecordRetrieveTask, UpdateRecordBackupPlan, UpdateRecordPlan。

名称 类型 必选 描述
DeviceId String 通道所属的设备ID
示例值:f8656fa3-e7fa-4cad-a4cc-****
ChannelId String 设备通道ID,一个设备通道只允许被一个上云计划添加
示例值:f7ca505f-be1b-4ce8-849b-****

ChefClothAIResultInfo

厨师服识别结果详情

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Time String 时间字符串
示例值:2023-10-10 12:30:00
Url String 截图 URL
示例值:https://****
ChefClothInfoInfo Array of BaseAIResultInfo 厨师服信息

ChefHatAIResultInfo

厨师帽识别结果详情

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Time String 时间字符串
示例值:2023-10-10 12:30:00
Url String 截图 URL
示例值:https://****
ChefHatInfo Array of BaseAIResultInfo 厨师帽信息

ControlDeviceStreamData

获取开流地址返回数据

被如下接口引用:ControlDeviceStream。

名称 类型 描述
Flv String flv 流地址
注意:此字段可能返回 null,表示取不到有效值。
示例值:https://www.demo.com/live/f7ca505f-be1b-4ce8-849b-************.live.flv
Hls String hls 流地址
注意:此字段可能返回 null,表示取不到有效值。
示例值:https://www.demo.com/live/f7ca505f-be1b-4ce8-849b-************/hls.m3u8
Rtmp String rtmp 流地址
注意:此字段可能返回 null,表示取不到有效值。
示例值:rtmp://www.demo.com/live/f7ca505f-be1b-4ce8-849b-****

DescribeDeviceChannelData

查询设备通道信息返回结果

被如下接口引用:DescribeDeviceChannel。

名称 类型 描述
DeviceId String 设备 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f8656fa3-e7fa-4cad-a4cc-****
ChannelId String 通道 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f7ca505f-be1b-4ce8-849b-****
ChannelCode String 通道编码
注意:此字段可能返回 null,表示取不到有效值。
示例值:6101000000131000****
Name String 通道名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:通道1
Status Integer 流状态(0:未传输,1:传输中)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
PTZType Integer 是否可控 Ptz(0:不可控,1:可控)
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
Manufacturer String 通道厂商
注意:此字段可能返回 null,表示取不到有效值。
示例值:Hikvison
Resolution String 通道支持分辨率(分辨率列表由‘/’隔开,国标协议样例(6/3),自定义样例(12800960/640480))
注意:此字段可能返回 null,表示取不到有效值。
示例值:6/3
State Integer 通道在离线状态(0:离线,1:在线)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Region String 所在地域
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-shanghai

DescribeDeviceData

查询设备接口返回数据

被如下接口引用:DescribeUserDevice。

名称 类型 描述
DeviceId String 设备ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f8656fa3-e7fa-4cad-a4cc-****
Code String 设备编码(国标设备即我们为设备生成的20位国标编码,rtmp 设备为10 位设备编码)
注意:此字段可能返回 null,表示取不到有效值。
示例值:6101320000132000****
Name String 设备名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:设备1
AccessProtocol Integer 设备接入协议,1:RTMP,2:GB,3:GW
注意:此字段可能返回 null,表示取不到有效值。
示例值:2
Type Integer 设备类型,1:IPC,2:NVR
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
ClusterId String 设备接入服务节点id
注意:此字段可能返回 null,表示取不到有效值。
示例值:b2181417-03ce-4ea3-ae39-****
ClusterName String 设备接入服务节点名称

注意:此字段可能返回 null,表示取不到有效值。
示例值:上海1
TransportProtocol Integer 设备流传输协议,1:UDP,2:TCP
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Password String 设备密码
注意:此字段可能返回 null,表示取不到有效值。
示例值:111111
Description String 设备描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:这是个设备
SipId String sip服务ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:7101000000200000****
SipDomain String sip服务域
注意:此字段可能返回 null,表示取不到有效值。
示例值:7101000000
SipIp String sip服务IP地址
注意:此字段可能返回 null,表示取不到有效值。
示例值:88.88.88.88
SipPort Integer sip服务端口
注意:此字段可能返回 null,表示取不到有效值。
示例值:5870
PushStreamUrl String Rtmp设备推流地址(仅rtmp设备有效)
注意:此字段可能返回 null,表示取不到有效值。
示例值:rtmp://88.88.88.88/live/I3Pocd****
Status Integer 设备状态,0:未注册,1:在线,2:离线,3:禁用
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
OrganizationId String 设备所属组织ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:237
GatewayId String 设备接入网关ID,从查询网关列表接口中获取(仅网关接入需要)
注意:此字段可能返回 null,表示取不到有效值。
示例值:f6d2540d-1d13-4873-b10e-****
GatewayName String 设备所属网关名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:网关1
ProtocolTypeName String 设备网关协议名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:Onvif
ProtocolType Integer 网关接入协议类型,1.海康SDK,2.大华SDK,3.宇视SDK,4.Onvif(仅网关接入需要)
注意:此字段可能返回 null,表示取不到有效值。
示例值:4
Ip String 设备接入IP
注意:此字段可能返回 null,表示取不到有效值。
示例值:192.168.*.1
Port Integer 设备Port
注意:此字段可能返回 null,表示取不到有效值。
示例值:9000
Username String 设备用户名
注意:此字段可能返回 null,表示取不到有效值。
示例值:admin
Region String 设备地域
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-shanghai
Manufacturer String 设备厂商
注意:此字段可能返回 null,表示取不到有效值。
示例值:Hikvision
AudioSwitch Integer 音频关开(0:关闭;1:开启)关闭时丢弃音频
注意:此字段可能返回 null,表示取不到有效值。
示例值:0
SubscribeSwitch Integer 订阅开关(0:关闭;1:开启)默认开启,开启状态下会订阅设备通道变化,仅国标NVR设备有效
注意:此字段可能返回 null,表示取不到有效值。
示例值:1

DescribeDevicePresetData

查询设备预置位返回数据

被如下接口引用:DescribeDevicePreset。

名称 类型 描述
Index Integer 预置位索引 只支持1-10的索引
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Name String 预置位名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:预置位1

DescribeDeviceRegion

查询设备可接入集群信息

被如下接口引用:DescribeDeviceRegion。

名称 类型 描述
Label String 服务节点描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:上海1
Value String 服务节点 ID(对应为其他接口中所需的 ClusterId)
注意:此字段可能返回 null,表示取不到有效值。
示例值:b2181417-03ce-4ea3-ae39-****
Region String 地域信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-shanghai

DescribeDomainData

查询域名详情数据

被如下接口引用:DescribeDomain。

名称 类型 描述
Id String 域名ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:2d203ed6-c0e9-4ef0-817b-****
PlayDomain String 播放域名
注意:此字段可能返回 null,表示取不到有效值。
示例值:www.demo.com
InternalDomain String CNAME 记录值
注意:此字段可能返回 null,表示取不到有效值。
示例值:d0bf30383016f5ac52aff****.play-***.ap-shanghai.tencentiss.cn
HaveCert Integer 是否上传证书(0:否,1:是)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
ClusterId String 服务节点 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:b2181417-03ce-4ea3-ae39-****
ClusterName String 服务节点名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:上海1
AppId Integer 用户ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:130****012

DescribeDomainRegionData

查询域名可绑定集群数据

被如下接口引用:DescribeDomainRegion。

名称 类型 描述
Label String 服务节点描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:上海1
Value String 服务节点 ID(对应为其他接口中所需的 ClusterId)
注意:此字段可能返回 null,表示取不到有效值。
示例值:b2181417-03ce-4ea3-ae39-****
Region String 地域信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-shanghai

DescribeGatewayData

查询网关信息返回结果

被如下接口引用:DescribeGateway。

名称 类型 描述
GatewayId String 网关索引ID,用于网关查询,更新,删除操作
注意:此字段可能返回 null,表示取不到有效值。
示例值:f6d2540d-1d13-4873-b10e-****
GwId String 网关编码,由网关设备生成的唯一编码
注意:此字段可能返回 null,表示取不到有效值。
示例值:25f26da2bc3347f639e7****
Name String 网关名称,仅支持中文、英文、数字、_、-,长度不超过32个字符
注意:此字段可能返回 null,表示取不到有效值。
示例值:网关1
Description String 网关描述,仅支持中文、英文、数字、_、-,长度不超过128个字符
注意:此字段可能返回 null,表示取不到有效值。
示例值:这是一个网关
ClusterId String 服务节点id
注意:此字段可能返回 null,表示取不到有效值。
示例值:b2181417-03ce-4ea3-ae39-****
ClusterName String 服务节点名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:上海1
Status Integer 网关状态,0:离线,1:在线
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Version Array of GatewayVersion 网关版本
注意:此字段可能返回 null,表示取不到有效值。
示例值:
DeviceNum Integer 网关下挂设备数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
CreatedAt String 激活时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:52:34
Region String 所属地域
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-shanghai

DescribeGatewayMonitor

查询网关监控信息返回结果

被如下接口引用:DescribeGatewayMonitor。

名称 类型 描述
DeviceTotal Integer 设备接入总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
DeviceOnline Integer 设备在线数
注意:此字段可能返回 null,表示取不到有效值。
示例值:8
DeviceOffline Integer 设备离线数
注意:此字段可能返回 null,表示取不到有效值。
示例值:2
ChannelTotal Integer 视频通道总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:30
ChannelOnline Integer 视频通道在线数
注意:此字段可能返回 null,表示取不到有效值。
示例值:18
ChannelOffline Integer 视频通道离线数
注意:此字段可能返回 null,表示取不到有效值。
示例值:12
UpFlow Integer 网关上行流量,单位kbps
注意:此字段可能返回 null,表示取不到有效值。
示例值:1024
ChannelPull Integer 流在传输中的通道数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
ChannelUnPull Integer 流未传输中的通道数
注意:此字段可能返回 null,表示取不到有效值。
示例值:20

DescribeGatewayProtocolData

查询网关所支持的接入协议

被如下接口引用:DescribeGatewayProtocol。

名称 类型 描述
TypeCode String 接入协议的字典码
注意:此字段可能返回 null,表示取不到有效值。
示例值:10001
Value Integer 接入协议类型值
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Label String 接入协议的类型描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:海康SDK

DescribeGatewayVersion

查询网关服务版本信息返回数据

被如下接口引用:DescribeGatewayVersion。

名称 类型 描述
Name String 服务名
注意:此字段可能返回 null,表示取不到有效值。
示例值:管理服务
Version String 服务版本
注意:此字段可能返回 null,表示取不到有效值。
示例值:v1.0.0.1
LatestVersion String 服务最新版本
注意:此字段可能返回 null,表示取不到有效值。
示例值:v1.0.0.31
IsUpdate Boolean 是否需要更新
注意:此字段可能返回 null,表示取不到有效值。
示例值:true
UpgradeInfo Array of String 升级信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:新增网关功能

DescribeGatewayVersionData

查询网关服务版本信息返回数据

被如下接口引用:DescribeGatewayVersion。

名称 类型 描述
Services Array of DescribeGatewayVersion 网关服务列表
注意:此字段可能返回 null,表示取不到有效值。

DescribeOrganizationData

查询组织数据返回结果

被如下接口引用:DescribeOrganization。

名称 类型 描述
OrganizationId String 组织 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:237
Name String 组织名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:组织237
ParentId String 组织父节点 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:236
Level Integer 组织层级
注意:此字段可能返回 null,表示取不到有效值。
示例值:3
AppId Integer 用户id
注意:此字段可能返回 null,表示取不到有效值。
示例值:1300***012
ParentIds String 组织结构
注意:此字段可能返回 null,表示取不到有效值。
示例值:0,236
Total Integer 设备总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
Online Integer 设备在线数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:8

DescribeRecordBackupPlanData

查询录像上云计划返回数据

被如下接口引用:DescribeRecordBackupPlan。

名称 类型 描述
PlanId String 录像上云计划ID
示例值:f06d500f-64fb-42c0-b804-****
PlanName String 录像上云计划名称
示例值:计划1
TemplateId String 录像上云模板ID
示例值:584fd9d0-569c-4153-aff7-****
Describe String 录像上云计划描述
示例值:这是一个录像上云计划
LifeCycle LifeCycleData 云文件生命周期
Status Integer 录像上云计划状态,1:正常使用中,0:删除中,无法使用
示例值: 1
ChannelCount Integer 通道数量
示例值:10
CreateAt String 创建时间
示例值:2023-09-06 15:52:34
UpdateAt String 修改时间
示例值:2023-09-06 15:52:34

DescribeRecordBackupTemplateData

查询录像上云模板返回数据

被如下接口引用:DescribeRecordBackupTemplate。

名称 类型 描述
TemplateId String 模板ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:584fd9d0-569c-4153-aff7-****
TemplateName String 模板名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:录像备份模板1
TimeSections Array of RecordTemplateTimeSections 上云时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
注意:此字段可能返回 null,表示取不到有效值。
DevTimeSections Array of RecordTemplateTimeSections 录像时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
注意:此字段可能返回 null,表示取不到有效值。
Scale Integer 上云倍速(支持1,2,4倍速)
注意:此字段可能返回 null,表示取不到有效值。
示例值:2
CreateAt String 创建时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:52:34
UpdateAt String 更新时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:53:34

DescribeRecordFileData

用于查询设备云端录像时间轴信息返回数据

被如下接口引用:DescribeRecordFile。

名称 类型 描述
Tips Integer 提示类型,0:时间段内无归档录像,1:时间段内有归档录像
示例值:0
List Array of RecordTimeLine 存在为数组格式,不存在字段内容为空
注意:此字段可能返回 null,表示取不到有效值。

DescribeRecordRetrieveTaskData

查询云录像取回任务详情返回数据

被如下接口引用:DescribeRecordRetrieveTask。

名称 类型 描述
TaskId String 取回任务ID
示例值:d00a3e6f9b**040cebcee7a6
TaskName String 取回任务名称
示例值:mane2
StartTime Integer 取回录像的开始时间
示例值:1687688595
EndTime Integer 取回录像的结束时间
示例值:1687692195
Mode Integer 取回模式,1:极速模式,其他暂不支持
示例值:1
Expiration Integer 副本有效期
示例值:3
Status Integer 任务状态,0:已取回,1:取回中,2:待取回
示例值:0
Capacity Float 取回容量,单位MB
示例值:100
Channels Array of RecordRetrieveTaskChannelInfo 任务的设备通道id
Describe String 任务描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:取回8小时
ChannelCount Integer 任务通道数量
示例值:1

DescribeStreamAuthData

查询推拉流鉴权返回数据结构

被如下接口引用:DescribeStreamAuth。

名称 类型 描述
Id String 鉴权配置ID(uuid)
注意:此字段可能返回 null,表示取不到有效值。
示例值:e8317c5b-7087-4126-bca0-****
PullState Integer 是否开播放鉴权(1:开启,0:关闭)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
PullSecret String 播放密钥(仅支持字母数字,长度0-10位)
注意:此字段可能返回 null,表示取不到有效值。
示例值:abcdefg
PullExpired Integer 播放过期时间(单位:分钟)
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
PushState Integer 是否开启推流鉴权(1:开启,0:关闭)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
PushSecret String 推流密钥(仅支持字母数字,长度0-10位)
注意:此字段可能返回 null,表示取不到有效值。
示例值:abcdefg
PushExpired Integer 推流过期时间(单位:分钟)
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
AppId Integer 用户ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:1300***012

DescribeVideoBitRateList

查询视频通道码率的返回结果列表

被如下接口引用:DescribeVideoBitRate。

名称 类型 描述
BitRates Array of BitRateInfo 通道码率列表
注意:此字段可能返回 null,表示取不到有效值。

DescribeVideoDownloadUrlData

获取云录像下载URL返回的数据

被如下接口引用:DescribeVideoDownloadUrl。

名称 类型 描述
Url String 录像文件下载 URL
注意:
URL 有效期是10分钟,过期后将拒绝访问,若需再用请重新获取
录像文件下载采用分块传输编码,响应头Transfer-Encoding:chunked
下载文件命名格式为{ChannelId}-{BeginTime}-{EndTime}.{FileType}
示例值:https://**.cn/vds/video.mp4?source=00037e5f-2aaa---f30b13a86b02%3B1700546401%3B1700546461%3Bmp4&res=**7f4f9b9d635fad97c589bc1e02&expires=600&signTime=1706151234&sign=*959fc5de6afe16
ActualBeginTime String 实际下载录像的开始时间
注意:当请求中指定IsRespActualTime参数为true时,才有该字段
示例值:1700546401
ActualEndTime String 实际下载录像的结束时间
注意:当请求中指定IsRespActualTime参数为true时,才有该字段
示例值:1700546461

FaceMaskAIResultInfo

口罩识别结果详情

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Time String 时间字符串
示例值:2023-10-10 12:30:00
Url String 截图 URL
示例值:https://****
FaceMaskInfo Array of BaseAIResultInfo 口罩信息

GatewayDevice

网关设备数据

被如下接口引用:ListGatewayDevices。

名称 类型 描述
DeviceId String 设备ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f8656fa3-e7fa-4cad-a4cc-****
ProtocolType Integer 网关接入协议类型
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
ProtocolTypeName String 网关接入协议名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:海康SDK
Name String 设备名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:设备1
Type Integer 设备类型
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Ip String 设备内网IP
注意:此字段可能返回 null,表示取不到有效值。
示例值:192.168.*.1
Port Integer 设备端口
注意:此字段可能返回 null,表示取不到有效值。
示例值:9000
ChannelNum Integer 设备下通道数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
Status Integer 设备状态
注意:此字段可能返回 null,表示取不到有效值。
示例值:1

GatewayVersion

网关详情版本信息

被如下接口引用:DescribeGateway。

名称 类型 描述
Name String 服务名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:网关服务
Version String 服务版本
注意:此字段可能返回 null,表示取不到有效值。
示例值:v1.1.1.1

GatewaysData

查询网关列表返回结果

被如下接口引用:ListGateways。

名称 类型 描述
GatewayId String 网关索引ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f6d2540d-1d13-4873-b10e-****
GwId String 网关编码
注意:此字段可能返回 null,表示取不到有效值。
示例值:f6d2540d-1d13-4873-b10e-****
Name String 网关名称,仅支持中文、英文、数字、_、-,长度不超过32个字符
注意:此字段可能返回 null,表示取不到有效值。
示例值:网关1
Description String 网关描述,仅支持中文、英文、数字、_、-,长度不超过128个字符
注意:此字段可能返回 null,表示取不到有效值。
示例值:这是一个网关
ClusterId String 网关所属服务节点ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:b2181417-03ce-4ea3-ae39-****
ClusterName String 网关所属服务节点名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:上海1
Region String 网关所属地域
注意:此字段可能返回 null,表示取不到有效值。
示例值:ap-shanghai
Status Integer 网关状态,0:离线,1:在线
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
CreatedAt String 网关激活时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:52:34
DeviceNum Integer 所属网关设备数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:10

LifeCycleData

生命周期,云文件生命周期设置,管理文件冷、热存储的时间

被如下接口引用:AddRecordBackupPlan, AddRecordPlan, DescribeRecordBackupPlan, DescribeRecordPlan, ListRecordBackupPlans, ListRecordPlans, UpdateRecordBackupPlan, UpdateRecordPlan。

名称 类型 必选 描述
Transition Integer 云文件热存储时长,单位天,最小1天,最大3650天
示例值:7
Expiration Integer 云文件冷存储时长, 单位天,0表示不设置,设置时最小60天,Expiration字段加Transition字段不超过3650天
示例值:90

ListAITaskData

获取AI任务列表的数据

被如下接口引用:ListAITasks。

名称 类型 描述
List Array of AITaskInfo AI任务列表
注意:此字段可能返回 null,表示取不到有效值。

ListDeviceInfo

获取设备列表的响应

被如下接口引用:ListDevices。

名称 类型 描述
DeviceId String 设备 ID
示例值:f8656fa3-e7fa-4cad-a4cc-****
Code String 设备编码
示例值:6101320000132000****
Status Integer 设备状态。0:未注册,1:在线,2:离线,3:禁用
示例值:1
TransportProtocol Integer 设备流传输协议。1:UDP,2:TCP
示例值:2
Name String 设备名称
示例值:设备1
Type Integer 设备类型。1:IPC,2:NVR
示例值:2
Password String 设备密码
示例值:111111
Description String 描述
示例值:这个是GB设备
ClusterId String 设备接入服务节点 ID
示例值:b2181417-03ce-4ea3-ae39-****
ClusterName String 服务节点名称
示例值:上海1
AccessProtocol Integer 接入协议。1:RTMP,2:GB,3:GW
示例值:2
OrganizationId String 设备所属组织 ID
示例值:123
ChannelNum Integer 通道数量
示例值:2

ListGatewayDevicesData

查询网关设备列表返回数据

被如下接口引用:ListGatewayDevices。

名称 类型 描述
List Array of GatewayDevice 网关下设备列表
注意:此字段可能返回 null,表示取不到有效值。
TotalCount Integer 网关下设备总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10

ListGatewaysData

查询网关列表返回结果

被如下接口引用:ListGateways。

名称 类型 描述
List Array of GatewaysData 网关列表
注意:此字段可能返回 null,表示取不到有效值。
TotalCount Integer 网关数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:10

ListOrganizationChannelNumbersData

组织目录下的未添加到实时上云计划中的通道数量返回数据

被如下接口引用:ListOrganizationChannelNumbers。

名称 类型 描述
TotalCount Integer 组织下通道总数
示例值:20
NotInPlanCount Integer 组织下未添加到计划的通道总数
示例值:5

ListOrganizationChannelsData

查询组织目录下的通道列表返回数据

被如下接口引用:ListOrganizationChannels。

名称 类型 描述
PageNumber Integer 第几页
示例值:1
PageSize Integer 当前页的设备数量
示例值:10
TotalCount Integer 本次查询的设备通道总数
示例值:100
List Array of OrganizationChannelInfo 设备通道信息列表
注意:此字段可能返回 null,表示取不到有效值。

ListRecordBackupPlanData

查询录像上云计划列表返回数据

被如下接口引用:ListRecordBackupPlans。

名称 类型 描述
PlanId String 录像上云计划ID
示例值:f06d500f-64fb-42c0-b804-****
PlanName String 录像上云计划名称
示例值:录像上云计划1
TemplateId String 录像上云模板ID
示例值:584fd9d0-569c-4153-aff7-****
Describe String 录像上云计划描述
示例值:这是计划的一部分
LifeCycle LifeCycleData 云文件生命周期
Status Integer 录像上云计划状态,1:正常使用中,0:删除中,无法使用
示例值: 1
ChannelCount Integer 通道数量
示例值:10
CreateAt String 创建时间
示例值:2023-09-06 15:52:34
UpdateAt String 修改时间
示例值:2023-09-06 15:52:34

ListRecordBackupPlanDevicesData

查询录像上云计划关联通道的返回数据

被如下接口引用:ListRecordBackupPlanDevices。

名称 类型 描述
PageNumber Integer 第几页
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
PageSize Integer 当前页的设备数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:20
TotalCount Integer 本次查询的设备通道总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
List Array of RecordPlanChannelInfo 设备通道信息列表
注意:此字段可能返回 null,表示取不到有效值。

ListRecordBackupTemplatesData

查询录像上云模板列表返回数据

被如下接口引用:ListRecordBackupTemplates。

名称 类型 描述
TemplateId String 模板ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:584fd9d0-569c-4153-aff7-****
TemplateName String 模板名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:录像上云模板1
TimeSections Array of RecordTemplateTimeSections 上云时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
注意:此字段可能返回 null,表示取不到有效值。
DevTimeSections Array of RecordTemplateTimeSections 录像时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
注意:此字段可能返回 null,表示取不到有效值。
Scale Integer 上云倍速(支持1,2,4倍速)
注意:此字段可能返回 null,表示取不到有效值。
示例值:2
CreateAt String 创建时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:52:34
UpdateAt String 更新时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:52:34

ListRecordPlanChannelsData

用户下所有实时上云计划中的通道id列表返回数据

被如下接口引用:ListRecordPlanChannels。

名称 类型 描述
List Array of String 用户所有计划下通道id,存在通道是为数组格式,不存在时,字段数据为空
注意:此字段可能返回 null,表示取不到有效值。
示例值:f7ca505f-be1b-4ce8-849b-****

ListRecordPlanDevicesData

云计划下的设备通道列表返回数据

被如下接口引用:ListRecordPlanDevices。

名称 类型 描述
PageNumber Integer 第几页
示例值:1
PageSize Integer 当前页的设备数量
示例值:10
TotalCount Integer 本次查询的设备通道总数
示例值:100
List Array of RecordPlanChannelInfo 设备通道信息列表
注意:此字段可能返回 null,表示取不到有效值。

ListSubTasksData

列举子任务列表

被如下接口引用:ListSubTasks。

名称 类型 描述
List Array of SubTaskData 子任务列表
TotalCount Integer 子任务数量
示例值:10

ListTasksData

查询任务列表

被如下接口引用:ListTasks。

名称 类型 描述
List Array of TaskData 任务列表
注意:此字段可能返回 null,表示取不到有效值。
TotalCount Integer 任务数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:10

Location

AI识别结果在画面中坐标

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
X Integer 左上角 X 坐标轴
示例值:854
Y Integer 左上角 Y 坐标轴
示例值:1142
Width Integer 方框宽
示例值:567
Height Integer 方框高
示例值:87

OperTimeSlot

AI分析的时间段配置

被如下接口引用:AddAITask, UpdateAITask。

名称 类型 必选 描述
Start String 开始时间。格式为"hh:mm:ss",且 Start 必须小于 End
示例值:10:00:00
End String 结束时间。格式为"hh:mm:ss",且 Start 必须小于 End
示例值:20:00:00

OrganizationChannelInfo

组织目录下的通道信息

被如下接口引用:ListOrganizationChannels。

名称 类型 描述
DeviceId String 设备通道所属的设备ID
示例值:389708b2-bcbb-****-a61f528b2a15
DeviceName String 设备通道所属的设备名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:NVR05
ChannelId String 设备通道ID
示例值:53ca64d3-9627-****-cea5122f6977
ChannelName String 设备通道名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:PTZ03
InPlan Boolean 该通道是否在上云计划中,如果是,则不能在添加到其他上云计划|true:在上云计划中,false:不在上云计划中
示例值:true

PetAIResultInfo

宠物识别结果详情

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Time String 时间字符串
示例值:2023-10-10 12:30:00
Url String 截图 URL
示例值:https://****
PetInfo Array of BaseAIResultInfo 宠物信息

PhoneCallAIResultInfo

打电话识别结果详情

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Time String 时间字符串
示例值:2023-10-10 12:30:00
Url String 截图 URL
示例值:https://****
PhoneCallInfo Array of BaseAIResultInfo 打电话信息

PlateContent

AI车牌信息

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Plate String 车牌号信息
示例值:陕ASxxxL
Color String 车牌的颜色
示例值:蓝色
Type String 车牌的种类,例如普通蓝牌
示例值:普通蓝牌
Location Location 截图中坐标信息

PlayRecordData

本地录像播放url数据结构

被如下接口引用:PlayRecord。

名称 类型 描述
Flv String 录像播放地址
注意:此字段可能返回 null,表示取不到有效值。
示例值:http://192.168.0.1:18080/live/5c46860f-****-41bd-****-a5e47cab08df@c451066b-****-46ba-****-53fc3c7c1d7c.live.flv?start=1656604800&end=1656608400&stream_type=1&resolution=6

RecordPlanBaseInfo

实时上云计划基础信息

被如下接口引用:DescribeRecordPlan, ListRecordPlans。

名称 类型 描述
PlanId String 上云计划ID
示例值:88ac5ea6c1**224671d0f94f
PlanName String 上云计划名称
示例值:工作日计划
TemplateId String 上云模板ID
示例值:9ee325e9984b**805c19b4e1
Describe String 上云计划描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:工作日计划
StreamType String 码流类型,default:设备默认码流类型,main:主码流,sub:子码流,其他根据设备能力集自定义
注意:此字段可能返回 null,表示取不到有效值。
示例值:main
LifeCycle LifeCycleData 云文件生命周期
Status Integer 录像计划状态,1:正常使用中,0:删除中,无法使用
示例值:1
ChannelCount Integer 通道总数
示例值:10

RecordPlanChannelInfo

计划下的设备通道信息

被如下接口引用:ListRecordBackupPlanDevices, ListRecordPlanDevices。

名称 类型 描述
DeviceId String 设备通道所属的设备ID
示例值:cae2132a-7edc-****-19cc90a61f06
DeviceName String 设备通道所属的设备名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:NVR05
ChannelId String 设备通道ID
示例值:15daac41-f309-****-0cadab7a6256
ChannelName String 设备通道名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:ptz01
OrganizationName String 所属组织名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:深圳市

RecordPlanOptData

实时上云计划添加和修改的返回数据

被如下接口引用:AddRecordPlan, UpdateRecordPlan。

名称 类型 描述
PlanId String 上云计划ID
示例值:88ac5ea6c1**224671d0f94f
PlanName String 上云计划名称
示例值:name1
TemplateId String 上云模板ID
示例值:9ee325e9984b**805c19b4e1
Describe String 上云计划描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:工作日计划
LifeCycle LifeCycleData 云文件生命周期
StreamType String 码流类型,default:设备默认码流类型,main:主码流,sub:子码流,其他根据设备能力集自定义
注意:此字段可能返回 null,表示取不到有效值。
示例值:main

RecordPlaybackUrl

云录像回放url

被如下接口引用:DescribeRecordPlaybackUrl。

名称 类型 描述
Hls String hls回放url
示例值:https://test5.maxshang.cn/playback/32525dd7-c3fc-****-****-d5beb4acd1e1/hls.m3u8?starttime=1687677795&endtime=1687688595&token=13*******2_1687677842_68dfc39854510520f29de4da78bd6e93

RecordRetrieveTaskChannelInfo

取回任务通道信息

被如下接口引用:DescribeRecordRetrieveTask。

名称 类型 描述
DeviceId String 设备通道所属的设备ID
示例值:389708b2-bcbb-****-a61f528b2a15
DeviceName String 设备通道所属的设备名称
示例值:SDK-NVR05
ChannelId String 设备通道ID
示例值:32525dd7-c3fc-****-d5beb4acd1e1
ChannelName String 设备通道名称
示例值:ptz01
Status Integer 任务状态,0:已取回,1:取回中,2:待取回, 3:无归档录像
示例值:0

RecordRetrieveTaskDetailsInfo

录像取回任务详情基础信息

被如下接口引用:ListRecordRetrieveTasks。

名称 类型 描述
TaskId String 任务ID
示例值:d00a3e6f9b**040cebcee7a6
TaskName String 任务名称
示例值:取回任务
StartTime Integer 取回录像的开始时间
示例值:1687688595
EndTime Integer 取回录像的结束时间
示例值:1687692195
Mode Integer 取回模式,1:极速模式,其他暂不支持
示例值:1
Expiration Integer 副本有效期
示例值:3
Status Integer 任务状态, 0:已取回,1:取回中,2:待取回
示例值:0
Capacity Integer 取回容量,单位MB
示例值:100
Describe String 任务描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:取回任务
ChannelCount Integer 任务通道数量
示例值:1

RecordSliceInfo

录像切片信息

被如下接口引用:DescribeRecordSlice。

名称 类型 描述
PlanId String 计划ID
示例值:88ac5ea6c1f**24671d0f94f
List Array of RecordTimeLine 录像切片开始和结束时间列表

RecordTemplateInfo

实时上云模板信息数据

被如下接口引用:AddRecordTemplate, DescribeRecordTemplate, ListRecordTemplates, UpdateRecordTemplate。

名称 类型 描述
TemplateId String 模板ID
示例值:48676e89a8c**baa36220fa4
TemplateName String 模板名称
示例值:name
TimeSections Array of RecordTemplateTimeSections 上云时间段,按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟

RecordTemplateTimeSections

上云模板的时间片段数据格式

被如下接口引用:AddRecordBackupTemplate, AddRecordTemplate, DescribeRecordBackupTemplate, DescribeRecordTemplate, ListRecordBackupTemplates, ListRecordTemplates, UpdateRecordBackupTemplate, UpdateRecordTemplate。

名称 类型 必选 描述
DayOfWeek Integer 周日期,取值范围1~7(对应周一~周日
示例值:1
StartTime String 开始时间,格式:HH:MM:SS,范围:[00:00:00~23:59:59]
示例值:08:00:00
EndTime String 结束时间,格式:HH:MM:SS,范围:[00:00:00~23:59:59]
示例值:12:00:00

RecordTimeLine

云录像时间片段

被如下接口引用:DescribeRecordFile, DescribeRecordSlice。

名称 类型 描述
Begin Integer 时间片段开始时间,UTC秒数,例如:1662114146
示例值:1687688595
End Integer 时间片段结束时间,UTC秒数,例如:1662114146
示例值:1687692195

SmokingAIResultInfo

抽烟识别结果详情

被如下接口引用:DescribeAITaskResult。

名称 类型 描述
Time String 时间字符串
示例值:2023-10-10 12:30:00
Url String 截图 URL
示例值:https://****
SmokingInfo Array of BaseAIResultInfo 抽烟信息

SnapshotConfig

截图配置

被如下接口引用:AddAITask, UpdateAITask。

名称 类型 必选 描述
TimeInterval Integer 截图频率。可选值1~20秒
示例值:10
OperTimeSlot Array of OperTimeSlot 模板生效的时间段。最多包含5组时间段

SubTaskData

子任务详情

被如下接口引用:ListSubTasks。

名称 类型 描述
SubTaskId String 子任务ID
示例值:9effe2a2-60d3-418b-9546-****
Status Integer 任务状态1:NEW,2:RUNNING,3:COMPLETED ,4:FAILED
示例值:3
FailReason String 任务失败原因
注意:此字段可能返回 null,表示取不到有效值。
示例值:设备离线
Progress Float 任务进度
示例值:0.66
Action String 操作类型
示例值:DisableDevice
ActionZhDesc String 操作类型中文描述
示例值:禁用设备
ResourceId String 资源ID
示例值:f8656fa3-e7fa-4cad-a4cc-****
StartedAt String 启动任务时间
示例值:2023-11-02 10:00:12.324
CreatedAt String 创建任务时间
示例值:2023-11-02 10:00:12.324
UpdatedAt String 更新任务时间
示例值:2023-11-02 10:00:12.334
Runtime Integer 任务运行时间,单位ms
示例值:20
DeviceId String 设备ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f8656fa3-e7fa-4cad-a4cc-****
DeviceName String 设备名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:设备1
ChannelId String 通道ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f7ca505f-be1b-4ce8-849b-****
ChannelName String 通道名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:通道1

TaskData

查询复杂任务详情返回结果

被如下接口引用:DescribeTask, ListTasks。

名称 类型 描述
TaskId String 任务ID
示例值:4d3535ba-3d81-4154-85ac-****
Status Integer 任务状态1:NEW,2:RUNNING,3:COMPLETED ,4:FAILED
示例值:3
FailReason String 失败原因
注意:此字段可能返回 null,表示取不到有效值。
示例值:设备响应超时
Progress Float 进度(0-1)
示例值:1
Action String 任务操作类型,批量任务类型以Batch开头
示例值:BatchDisableDevice
ActionZhDesc String 操作类型中文描述
示例值:批量禁用设备
TaskType Integer 任务类型 1.简单 2.复杂 3.子任务
示例值:2
ResourceId String 任务资源id(复杂任务该字段无效)
示例值:f8656fa3-e7fa-4cad-a4cc-****
Total Integer 总任务数(仅复杂任务有效)
示例值:10
SuccessCount Integer 成功任务数(仅复杂任务有效)
示例值:10
FailCount Integer 失败任务数(仅复杂任务有效)
示例值:0
RunningCount Integer 运行任务数(仅复杂任务有效)
示例值:0
StartedAt String 启动任务时间
示例值:2023-09-06 15:52:34
CreatedAt String 创建任务时间
示例值:2023-09-06 15:52:34
UpdatedAt String 更新任务时间
示例值:2023-09-06 15:52:35
Runtime Integer 任务运行时间,单位ms
示例值:300
DeviceId String 设备ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f8656fa3-e7fa-4cad-a4cc-****
DeviceName String 设备名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:设备1
ChannelId String 通道ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f7ca505f-be1b-4ce8-849b-****
ChannelName String 通道名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:通道1

Timeline

时间片段结构体

被如下接口引用:ControlRecordTimeline。

名称 类型 描述
Begin Integer 分片起始时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:1702813300
End Integer 分片结束时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:1702814300

UpdateDeviceData

修改设备接口返回数据

被如下接口引用:UpdateUserDevice。

名称 类型 描述
DeviceId String 设备ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f8656fa3-e7fa-4cad-a4cc-****
Code String 设备编码(国标设备即我们为设备生成的20位国标编码,rtmp 设备为10 位设备编码)
注意:此字段可能返回 null,表示取不到有效值。
示例值:6101320000132000****
Name String 设备名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:设备1
AccessProtocol Integer 设备接入协议,1:RTMP,2:GB,3:GW
注意:此字段可能返回 null,表示取不到有效值。
示例值:2
Type Integer 设备类型,1:IPC,2:NVR
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
ClusterId String 设备接入服务节点ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:b2181417-03ce-4ea3-ae39-****
ClusterName String 设备接入服务节点名称

注意:此字段可能返回 null,表示取不到有效值。
示例值:上海1
TransportProtocol Integer 设备流传输协议,1:UDP,2:TCP
注意:此字段可能返回 null,表示取不到有效值。
示例值:2
Password String 设备密码
注意:此字段可能返回 null,表示取不到有效值。
示例值:111111
Description String 设备描述
注意:此字段可能返回 null,表示取不到有效值。
示例值:这是一个设备
Status Integer 设备状态,0:未注册,1:在线,2:离线,3:禁用
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
OrganizationId Integer 设备所属组织ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:237
GatewayId String 设备接入网关ID,从查询网关列表接口中获取(仅网关接入需要)
注意:此字段可能返回 null,表示取不到有效值。
示例值:f6d2540d-1d13-4873-b10e-****
ProtocolType Integer 网关接入协议类型,1.海康SDK,2.大华SDK,3.宇视SDK,4.Onvif(仅网关接入需要)
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
Ip String 设备接入IP
注意:此字段可能返回 null,表示取不到有效值。
示例值:192.168.*.1
Port Integer 设备Port
注意:此字段可能返回 null,表示取不到有效值。
示例值:9000
Username String 设备用户名
注意:此字段可能返回 null,表示取不到有效值。
示例值:admin
AppId Integer 用户Id
注意:此字段可能返回 null,表示取不到有效值。
示例值:1300***012

UpdateGatewayData

修改网关信息返回结果

被如下接口引用:UpdateGateway。

名称 类型 描述
GatewayId String 网关索引ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:f6d2540d-1d13-4873-b10e-****
GwId String 网关编码
注意:此字段可能返回 null,表示取不到有效值。
示例值:25f26da2bc3347f639e7****
Name String 网关名称,仅支持中文、英文、数字、_、-,长度不超过32个字符
注意:此字段可能返回 null,表示取不到有效值。
示例值:网关1
Description String 网关描述,仅支持中文、英文、数字、_、-,长度不超过128个字符
注意:此字段可能返回 null,表示取不到有效值。
示例值:这是一个网关
ClusterId String 服务节点ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:b2181417-03ce-4ea3-ae39-****
ClusterName String 服务节点名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:上海1
Status Integer 网关状态,0:离线,1:在线
注意:此字段可能返回 null,表示取不到有效值。
示例值:1
CreatedAt Integer 激活时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:1702813300
Secret String 网关密钥
注意:此字段可能返回 null,表示取不到有效值。
示例值:abcdefg*
Version String 网关版本信息
注意:此字段可能返回 null,表示取不到有效值。
示例值:v1.1.1.1

UpdateOrgData

修改组织接口返回数据

被如下接口引用:UpdateOrganization。

名称 类型 描述
OrganizationId String 组织 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:237
Name String 组织名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:组织237
ParentId String 组织父节点 ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:236
Level Integer 组织层级
注意:此字段可能返回 null,表示取不到有效值。
示例值:3
AppId Integer 用户ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:130****012
ParentIds String 组织结构
注意:此字段可能返回 null,表示取不到有效值。
示例值:0,236
Total Integer 设备总数
注意:此字段可能返回 null,表示取不到有效值。
示例值:10
Online Integer 设备在线数量
注意:此字段可能返回 null,表示取不到有效值。
示例值:7

UpdateRecordBackupPlanData

修改录像上云计划返回数据

被如下接口引用:UpdateRecordBackupPlan。

名称 类型 描述
PlanId String 录像上云计划ID
示例值:f06d500f-64fb-42c0-b804-****
PlanName String 录像上云计划名称
示例值:录像上云计划1
TemplateId String 录像上云模板ID
示例值:584fd9d0-569c-4153-aff7-****
Describe String 录像上云计划描述
示例值:这是计划的一部分
LifeCycle LifeCycleData 云文件生命周期
Status Integer 录像上云计划状态,1:正常使用中,0:删除中,无法使用
示例值: 1
ChannelCount Integer 通道数量
示例值:10
CreateAt String 创建时间
示例值:2023-09-06 15:52:34
UpdateAt String 修改时间
示例值:2023-09-06 15:52:34

UpdateRecordBackupPlanModify

修改录像上云计划数据结构

被如下接口引用:UpdateRecordBackupPlan。

名称 类型 必选 描述
PlanName String 录像上云计划名称(仅支持中文、英文、数字、_、-,长度不超过32个字符,计划名称全局唯一,不能为空,不能重复,不修改名称时,不需要该字段)
示例值:录像上云计划1
TemplateId String 录制模板ID(从查询录像上云模板列表接口ListRecordBackupTemplates中获取,不修改模板ID时,不需要该字段)
示例值:584fd9d0-569c-4153-aff7-****
Describe String 录像上云计划描述(仅支持中文、英文、数字、_、-,长度不超过128个字符, 不修改描述时,不需要该字段)
示例值:这是一个录像上云计划
LifeCycle LifeCycleData 生命周期(录像文件生命周期设置,管理文件冷、热存储的时间,不修改生命周期时,不需要该字段)
Add Array of ChannelInfo 要新增的设备通道(Json数组,没有新增时,不需要该字段,一次添加通道总数不超过5000个,包括组织目录下的通道数量)
Del Array of String 要删除的设备通道(Json数组,内容为要删除的设备通道id,没有删除设备通道时,不需要该字段)
示例值:f8656fa3-e7fa-4cad-a4cc-****
OrganizationId Array of String 添加组织目录下所有设备通道(Json数组,可以为空,并且通道总数量不超过5000个(包括Add字段通道数量))
示例值:237

UpdateRecordBackupTemplateData

修改录像上云模板返回数据

被如下接口引用:UpdateRecordBackupTemplate。

名称 类型 描述
TemplateId String 模板ID
注意:此字段可能返回 null,表示取不到有效值。
示例值:584fd9d0-569c-4153-aff7-****
TemplateName String 模板名称
注意:此字段可能返回 null,表示取不到有效值。
示例值:录像上云模板1
TimeSections Array of RecordTemplateTimeSections 上云时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
注意:此字段可能返回 null,表示取不到有效值。
DevTimeSections Array of RecordTemplateTimeSections 录像时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
注意:此字段可能返回 null,表示取不到有效值。
Scale Integer 上云倍速(支持1,2,4倍速)
注意:此字段可能返回 null,表示取不到有效值。
示例值:2
CreateAt String 创建时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:52:34
UpdateAt String 更新时间
注意:此字段可能返回 null,表示取不到有效值。
示例值:2023-09-06 15:52:34

UpdateRecordBackupTemplateModify

修改录像上云模板数据结构

被如下接口引用:UpdateRecordBackupTemplate。

名称 类型 必选 描述
TemplateName String 模板名称(不修改名称时,不需要带该字段)
示例值:录像上云模板1
TimeSections Array of RecordTemplateTimeSections 上云时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
DevTimeSections Array of RecordTemplateTimeSections 录像时间段(按周进行设置,支持一天设置多个时间段,每个时间段不小于10分钟)
Scale Integer 上云倍速(支持1,2,4倍速)
示例值: 2

UpdateRecordPlanData

修改实时上云录像计划的数据

被如下接口引用:UpdateRecordPlan。

名称 类型 必选 描述
PlanName String 上云计划名称,仅支持中文、英文、数字、_、-,长度不超过32个字符,计划名称全局唯一,不能为空,不能重复,不修改名称时,不需要该字段
示例值:88ac5ea6c1**224671d0f94f
TemplateId String 上云模板ID,不修改模板ID时,不需要该字段
示例值:9ee325e9984b**805c19b4e1
Describe String 上云计划描述,仅支持中文、英文、数字、_、-,长度不超过128个字符, 不修改描述时,不需要该字段
示例值:工作日计划
StreamType String 码流类型,default:不指定码流类型,以设备默认推送类型为主, main:主码流,sub:子码流,其他根据设备能力集自定义,长度不能超过32个字节
示例值:main
LifeCycle LifeCycleData 生命周期,文件生命周期设置,管理文件冷、热存储的时间,不修改生命周期时,不需要该字段
Add Array of ChannelInfo 要新增的设备通道,Json数组,没有新增时,不需要该字段,一次添加通道总数不超过5000个,包括组织目录下的通道数量
Del Array of String 要删除的设备通道,Json数组,内容为要删除的设备通道id,没有删除设备通道时,不需要该字段
示例值:9ee325e9984**a805c19b4e1
OrganizationId Array of String 组织目录ID,添加组织目录下所有设备通道,Json数组,可以为空,并且通道总数量不超过5000个(包括Add字段通道数量)
示例值:185

UpdateRecordTemplateData

修改实时上云模板的请求数据结构

被如下接口引用:UpdateRecordTemplate。

名称 类型 必选 描述
TemplateName String 模板名称, 不修改名称时,不需要带该字段
示例值:全天模板
TimeSections Array of RecordTemplateTimeSections 上云时间段,不修改名称时,不需要带该字段