本页目录
请求参数
请求示例
响应字段
响应示例
错误码
说明
相关

openCloudRecord（开通设备云存储）

openCloudRecord：开通设备云存储

要点：https://openapi.lechange.cn/openapi/openCloudRecord · 见 错误码

给账号下的设备通道开通指定的云存储套餐。支持通用云存储和智见云存储套餐。

请求参数

参数名参数类型是否必填默认值合法值参数说明
tokenString是管理员accessToken
deviceIdString是设备序列号
channelIdString是通道号
strategyIdString是详情请见：云存储套餐 strategyId云存储套餐ID，对应需要开通的云存储套餐种类
deviceCloudIdString否可通过 unUsedCloudList 获取值库存云存储唯一 ID：从 [unUsedCloudList](/api/unUsedCloudList/) 选套餐开通时**必填**；用账号额度新开、不消耗库存时**不填**
repositoryIdString否兼容字段，与 `deviceCloudId` 同义（二选一）；新接入请用 `deviceCloudId`
activateNowBoolean否false如果设备上已有其他套餐使用中，再次开通套餐时，可通过该字段选择立即启用新套餐。
true:开通后立刻使用该套餐，按其规格存储录像，设备上的其他套餐顺延进套餐队列；false：本次开通的套餐按顺序加入设备套餐队列。默认为false
rulesArray否≤128 条连续云存储录像计划对象数组；元素含 `period`（String，星期可逗号拼接）、`beginTime`/`endTime`（String，`HH:mm:ss`）。形状同 [setCloudRecordPlan](/api/setCloudRecordPlan/) 的 `rules`

对于rules云录像计划参数:
1、该参数只对连续云存储套餐生效。开通事件云存储时可忽略该参数；
2、24小时连续云存储录像计划默认是每天的0点~24点，可不用再设置；如需自定义计划，可通过该参数设置；
3、如果使用的是指定每日存储时长的连续云存储（例如12小时连续云存储套餐），设置的录像计划总生效时长不能超过套餐支持的时长；这类套餐，开通时如果不设置rules，平台默认设置每日0点开始的录像计划。

rules 示例片段："rules":[{"period":"Monday,Tuesday","beginTime":"08:00:00","endTime":"20:00:00"}]

请求示例

{
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
        "time": 1706511734,
        "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
    },
    "params":{
        "token": "<yourAccessToken>", 
        "deviceId":"TESTQWERXXXX", 
        "channelId":"0", 
        "strategyId":"3"
    }
}

响应字段

无data数据返回

响应示例

{
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
    "result":{
        "code":"0",
        "msg":"操作成功"
    }
}

错误码

本接口可能返回下列码；完整分组见 错误码。

网关与鉴权（SN / TK / OP）

错误码错误码说明下一步
SN1001签名异常按 签名 核对 sign
TK1002token 无效或过期重新获取 token
OP1002缺少必填参数补必填字段
OP1003参数不合法按本页参数表核对
OP1039分钟级限流等到下一分钟再试
OP1040调用超限降低频率
DV1007设备离线或超时等设备上线

子账号（SUB）

错误码错误码说明下一步
SUB1001子账号无指定权限在 子账号策略 中补权限
SUB1002子账号无任何设备权限授权设备或调整策略
SUB1005子账号 token 过期重新 获取子账号 token
SUB1006子账号与设备无授权关系核对 Resource 与设备序列号
SUB1008子账号未绑定当前应用先创建并绑定子账号
SUB1007创建子账号失败核对参数后重试
SUB1009子账号创建失败，账号格式错误account 须为手机号或邮箱
SUB1010子账号创建失败，账号已存在勿重复绑定同一子账号到应用

更多见 错误码 · SUB。

设备访问与通道（DV10xx）

错误码错误码说明下一步
DV1007设备离线或超时等设备上线；低电休眠先 唤醒
DV1009设备正忙稍后重试
DV1012分享/授权设备权限不足核对子账号 Permission / Resource
DV1019能力集不支持确认型号与 设备能力
DV1020通道离线检查通道与设备状态
DV1026不支持此功能换接口或升级固件
DV1028未绑定或通道不存在核对 deviceId / channelId
DV1030设备休眠唤醒后再调
DV1057通道不存在核对通道号
DV1061设备响应超时检查设备网络
DV1062需先唤醒设备调用唤醒接口
DV1069不满足操作条件见 msg

云存储套餐（ST）

错误码错误码说明下一步
ST1001默认云存储套餐已到期续费或换套餐
ST1002无默认云存储套餐先开通套餐
ST1004云存储未开通开通云存储
ST1005云存储已过期续费
ST1006套餐不存在核对套餐 id
ST1009仍有未过期收费套餐先处理旧套餐
ST1010设备不支持该套餐策略换支持的套餐
ST101124 小时内仅可解绑一次次日再试
OP1043国标设备仅支持连续云存储换连续套餐
OP1046套餐不属于该设备核对设备与套餐 id

更多见 错误码 · ST。

说明

仅支持管理员 accessToken；子账号不可调用本接口。

相关

getMessageCallback（查看报警回调地址）
unBindDeviceCloud（解绑设备云存储）