批量开通设备通道服务
功能介绍
通道绑定资源(视图接入调阅、连续云存储、动检云存储、行业数据流)能力,支持批量。
每个通道同时只能绑定每类资源中的一个资源,不区分按需和套餐;同类资源间支持变更资源绑定,使用不同资源ID调用该接口即可;同一个资源不允许重复开通,重复开通报错。
URI
POST /v1/{user_id}/devices/channels/resources
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
user_id |
是 |
String |
用户ID:由数字组成,长度范围[15,25],获取方式参考获取user ID与下载AK/SK章节 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Access-Token |
是 |
String |
用户认证AccessToken:从获取用户北向接口认证AccessToken中获取 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
resource_id |
是 |
String |
资源ID:该资源ID可从查询包周期和按需资源列表接口进行获取 |
storage_day |
否 |
Float |
存储天数:例如连续收录中录像的存储天数等 当resourceID为连续收录按需服务、行业数据流按需服务、动检云存储按需服务三种按需资源时必传,参数范围为[1,365], 不传报错 当resourceID为包周期资源时不传,默认值为0, 传非0值报错 |
channels |
是 |
Array of Channel objects |
通道信息 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
failed_num |
Integer |
开通失败设备数 |
channels |
Array of Device objects |
通道列表 |
请求示例
用户【123456781234567812345***】设备开通【MANAGE】类型按需
/v1/123456781234567812345***/devices/channels/resources { "resource_id" : "d84c8cbabb8145b390bced5f2a774af6", "storage_day" : 7, "channels" : [ { "device_id" : "1abcdef8", "channel_id" : "1" }, { "device_id" : "12345678901234******", "channel_id" : "2" } ] }
响应示例
状态码: 200
OK
{ "failed_num" : 0, "channels" : [ { "device_id" : "34020000001*********", "channel_id" : "34020000001*********", "result" : { "code" : "IVM.0", "msg" : "Success" } } ] }
状态码
请参见状态码
错误码
请参见错误码。