调用该接口查询云存储套餐是否可以购买。

路径 /vision/customer/cloudstorage/commodity/check
版本号 1.0.3
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权 可选
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
iotId String QIuozfUcxRX6frOTO4dKz2**** 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。
commodityCode String ilopLV*****Resource 云存储套餐编码。从查询云存储套餐列表接口获取。
specification String e****Resource_7 云存储套餐规格。从查询云存储套餐列表接口获取。

返回数据

名称 类型 示例值 描述
code Int

接口返回码。200表示成功。

message String

调用失败时,返回的出错信息。

localizedMsg String

本地语言的错误消息。

data JSON

响应的结果。

available Boolean

是否可以购买。

示例

请求示例

// https://github.com/aliyun/iotx-api-gateway-client
IoTApiClientBuilderParams ioTApiClientBuilderParams = new IoTApiClientBuilderParams();

ioTApiClientBuilderParams.setAppKey("你的<AppKey>");
ioTApiClientBuilderParams.setAppSecret("你的<AppSecret>");

SyncApiClient syncApiClient = new SyncApiClient(ioTApiClientBuilderParams);

IoTApiRequest request = new IoTApiRequest();

// 设置请求ID
String uuid = UUID.randomUUID().toString();
String id = uuid.replace("-", "");
request.setId(id);
// 设置API版本号
request.setApiVer("1.0.3");

// 设置参数
request.putParam("iotId", "value0");
request.putParam("commodityCode", value1");
request.putParam("specification", value2");
// 如果需要,设置headers
Map<String, String> headers = new HashMap<String, String>(8);
// headers.put("你的<header", "你的<value>");

// 设置请求参数域名, path, request, isHttps, headers
ApiResponse response = syncApiClient.postBody("api.link.aliyun.com", "/vision/customer/cloudstorage/commodity/check", request, true, headers);

System.out.println(
    "response code = " + response.getCode()
        + " response = " + new String(response.getBody(), "UTF-8")
        + " headers = " + response.getHeaders().toString()
);

正常返回示例

JSON 格式

{
    "code": 200, 
    "data": {
        "available": true
    }, 
    "id": "e10dca29-23f3-43e2-96fb-471bfdc1c781"
}

异常返回示例

JSON 格式

{
    "code": 460, 
    "data": {
        "available": false
    }, 
    "id": "03a4b78a-adbd-4ced-ace3-f50d9691098d", 
    "localizedMsg": "请求参数错误", 
    "message": "commodity code or specification invalid"
}