开通设备云存储
openCloudRecord:开通设备云存储
功能详情
给账号下的设备通道开通指定的云存储套餐。支持通用云存储和智见云存储套餐。
如果给一个设备通道同时开通多个云存储套餐,首次开通的套餐立即生效,平台按该套餐规格存储云录像;其他后开通的套餐自动进入设备套餐队列,待前一个套餐过期后,队列中的套餐自动按顺序生效。 开通之后可通过deviceCloudList查看设备上套餐信息。
开通场景1:使用账号下未使用过的云存储套餐(指购买后未用完的剩余云存储额度)进行开通。先通过queryCloudRecordCallNum确认指定套餐可用额度大于0,此时开发者即可开通该云存储套餐到设备通道上,每开通一次即为一个设备通道开通云存储服务。开通成功后,对应云存储套餐额度减1。
开通场景2:使用账号下的库存云存储额度(指之前开通到设备上使用过,但后续设备解绑或套餐解绑,又回到账号下的那部分套餐)进行开通。可通过unUsedCloudList接口查看库存云存储额度信息,进行开通使用。
请求地址
https://openapi.lechange.cn/openapi/openCloudRecord
传入参数说明
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 | |
|---|---|---|---|---|---|---|
| token | String | 是 | 管理员accessToken | |||
| deviceId | String | 是 | 设备序列号 | |||
| channelId | String | 是 | 通道号 | |||
| strategyId | String | 是 | 详情请见:云存储套餐 | 云存储套餐ID,对应需要开通的云存储套餐种类 | ||
| deviceCloudId | String | 否 | 可通过unUsedCloudList获取值 | 库存云存储唯一id,若是按上述场景2来开通库存云存储,该字段必填; 若是按上述场景1开通未使用过的云存储额度,该字段不用填 | ||
| activateNow | Boolean | 否 | false | 如果设备上已有其他套餐使用中,再次开通套餐时,可通过该字段选择立即启用新套餐。 true:开通后立刻使用该套餐,按其规格存储录像,设备上的其他套餐顺延进套餐队列;false:本次开通的套餐按顺序加入设备套餐队列。默认为false | ||
| rules | period | string | 否 | 云录像计划周期,多天可以逗号拼接,例:Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday | ||
| beginTime | [string] | 否 | 云录像计划开始时间,HH:mm:ss格式,不支持跨天 | |||
| endTime | [string] | 否 | 云录像计划结束时间,HH:mm:ss格式,不支持跨天 | |||
对于rules云录像计划参数:
1、该参数只对连续云存储套餐生效。开通事件云存储时可忽略该参数;
2、24小时连续云存储录像计划默认是每天的0点~24点,可不用再设置;如需自定义计划,可通过该参数设置;
3、如果使用的是指定每日存储时长的连续云存储(例如12小时连续云存储套餐),设置的录像计划总生效时长不能超过套餐支持的时长;这类套餐,开通时如果不设置rules,平台默认设置每日0点开始的录像计划。
样例输入
{
"id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign":"74bc756ebd53e9eef2836f8cf1730c10",
"time":1599031074,
"nonce":"8ec8a7bd1d1c95420de20d92422d457d"
},
"params":{
"token":"At_12345678901234567890123456789012",
"deviceId":"TESTQWERXXXX",
"channelId":"0",
"strategyId":"3"
}
}
返回data字段说明
无data数据返回
样例输出
{
"id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"result":{
"code":"0",
"msg":"操作成功"
}
}