为设备开通与管理云存储
为设备开通与管理云存储
开通、解绑、查询与开关云存储套餐。strategyId 与套餐类型见 云存储产品介绍。接口索引见 云存储 API。请求与返回字段以各链接的 OpenAPI 方法页为准。
步骤
推荐顺序：查额度或库存 → 开通到通道 → 查设备上套餐 / 开关录像 → 解绑或策略调整时走对应 API。下列分节按常见操作分组，非每一步都必须执行。
开通
调用 openCloudRecord（管理员 token）。多套餐时首个立即生效，其余进队列；类型与 strategyId 见 云存储产品介绍。
| 场景 | 先查 | 开通时注意 |
|---|---|---|
| 未使用过的购买额度 | queryCloudRecordCallNum 额度 > 0 | 不需 deviceCloudId |
| 库存套餐（解绑回流） | unUsedCloudList | 必填 deviceCloudId |
activateNow：设备已有套餐时是否立即启用新套餐；连续套餐的 rules 见 录像计划。字段与示例见 openCloudRecord 方法页。
查询剩余额度与未启用列表
- queryCloudRecordCallNum：按
strategyId查剩余可开通次数（callNum）。 - unUsedCloudList：分页查库存套餐（
nextDeviceCloudId首次-1，limit≤ 15）。
查询设备上的套餐
- getDeviceCloud：当前生效中套餐；子账号需
RecordReplay+cam:序列号:通道号。strategyStatus：-1 未开通、0 过期、1 使用中、2 暂停；永久免费套餐可能无endTime。 - deviceCloudList：通道上全部套餐（使用中 + 队列）。
useStatus0/1 为云存储总开关；cloudStatus1 使用中、2 队列、3 过期；cloudType、validDays见接口页。
开关
setStorageStrategy：status 为 on/off；暂停后不再生成云录像，但套餐到期时间仍继续计时。见方法页。
解绑
unBindDeviceCloud：按通道解绑全部套餐，或按 deviceCloudId 解绑指定套餐；未用完额度回到账号，可用 unUsedCloudList 查。见方法页。
各端实现
服务端 HTTP
开通、查询、开关、解绑按各页写出的请求地址调用。参数以原接口页为准。