调用该接口查询免费的云存储套餐详情。
路径 | /vision/customer/freecloudstorage/get |
版本号 | 1.0.1 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 可选 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
iotId | String | 是 | 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int | 接口返回码。200表示成功。 |
|
message | String | 调用失败时,返回的出错信息。 |
|
localizedMsg | String | 本地语言的错误消息。 |
|
data | JSON | 响应结果。 |
|
type | Int | 云存储套餐类型,1(表示连续型);2(表示事件型)。 |
|
lifecycle | Int | 数据在云端的存储周期,只有1、3、7、30, 单位:天。 |
|
months | Int | 云存储服务有效期,单位:月。 |
|
consumed | Int | 是否已领取免费的云存储套餐。0(表示未领取);1(表示已领取)。 |
|
startTime | String | 开始时间,格式为yyyy-MM-dd HH:mm:ss。 |
|
endTime | String | 结束时间,格式为yyyy-MM-dd HH:mm:ss。 |
|
expired | Int | 云存储服务是否已到期,0(表示未到期);1(表示已到期);2(表示订单冻结停用)。 |
|
startTimeUTC | String | 开始时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ。 |
|
endTimeUTC | String | 结束时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ。 |
|
remainQuota | Int | 赠送的云存储剩余配额,单位:月。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.1"
},
"params":{
"iotId": "value0"
}
}
正常返回示例
JSON
格式
{
"code": 200,
"data": {
"lifecycle": 7,
"consumed": 0,
"months": 3,
"expired": 0,
"startTime":"",
"endTime":"",
"startTimeUTC":"",
"endTimeUTC":"",
"type": 2,
"remainQuota": 3
},
"localizedMsg": "success",
"message": "success"
}
异常返回示例
JSON
格式
{
"id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
"code": 403,
"message": "request forbidden.",
"localizedMsg": "请求被禁止",
"data": null
}