unUsedCloudList（获取未启用的云存储服务列表）

unUsedCloudList：获取未启用的云存储服务列表

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

获取开发者账号下未启用的库存云存储服务信息（指之前开通到设备上使用过，但后续设备解绑或套餐解绑，又回到账号下的那部分套餐）。

请求参数

参数名	参数类型	是否必填	合法值	参数说明
token	String	是		管理员accessToken
nextDeviceCloudId	String	是	`-1` 或上一页响应值	请求游标：首次传 `-1`；翻页传上一响应中的 `nextDeviceCloudId`
limit	Integer	是	1–15	每页条数，最大 15

请求示例

{
    "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>", 
        "nextDeviceCloudId":"-1", 
        "limit":15 
    }
}

响应字段

字段名		字段类型	字段说明
nextDeviceCloudId		String	本页最后一条 `deviceCloudId`（供下次请求游标）；无数据时为 `-1`
cloudInfos	deviceCloudId	Long	云存储套餐唯一id
	name	String	套餐名称
	strategyId	String	云存储策略id
	cloudCount	Integer	云存储数量
	validDays	Integer	剩余有效天数，正数表示剩余天数，-1表示未使用过
	uniqueId	String	库存套餐唯一标识
	lastDeviceId	String	上次绑定设备序列号（若有）
	lastChannelId	String	上次绑定通道号（若有）
	lastUnbindTime	String	最近解绑时间

响应示例

{
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
    "result":{
        "code":"0",
        "msg":"操作成功",
        "data": {
            "nextDeviceCloudId":"100124",
            "cloudInfos":[{
                "deviceCloudId":"100123",
                "name":"3天一年事件云存储",
                "strategyId":"3", 
                "cloudCount":1, 
                "validDays":264 
            },
            {
                "deviceCloudId":"100124",
                "name":"3天一年事件云存储",
                "strategyId":"3", 
                "cloudCount":1, 
                "validDays":264 
            }]
        }
    }
}

错误码

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

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

错误码	错误码说明	下一步
`SN1001`	签名异常	按签名核对 `sign`
`TK1002`	token 无效或过期	重新获取 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`	设备不支持该套餐策略	换支持的套餐
`ST1011`	24 小时内仅可解绑一次	次日再试
`OP1043`	国标设备仅支持连续云存储	换连续套餐
`OP1046`	套餐不属于该设备	核对设备与套餐 id

更多见错误码 · ST。

说明

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