本示例介绍使用Alibaba Cloud SDK for Java调用CreateProduct接口创建产品。

前提条件

请在pom.xml文件中增加以下依赖,准确的SDK版本号,参见阿里云开发工具包(SDK)

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-iot</artifactId>
    <version>6.11.0</version>
 </dependency>
此接口限制说明如下:
  • 单阿里云账号调用该接口的每秒请求数(QPS)最大限制为50(子账号共享主账号配额)。
  • 单客户端出口IP的最大QPS限制为100,即来自单个客户端出口IP,调用阿里云接口的每秒请求总数不能超过100。

示例代码

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.iot.model.v20180120.CreateProductRequest;
import com.aliyuncs.iot.model.v20180120.CreateProductResponse;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;

/**
 * 调用接口新建产品。
 */
public class TestCreateProduct {
    public static void main(String[] args)  {
        DefaultProfile profile = DefaultProfile.getProfile(
                "<your-region-id>",            // 地域ID
                "<your-access-key-id>",        // 您的AccessKey ID
                "<your-access-key-secret>");  // 您的AccessKey Secret
        // DefaultProfile.addEndpoint("cn-shanghai", "cn-shanghai", "Iot", "iot.cn-shanghai.aliyuncs.com");
        IAcsClient client = new DefaultAcsClient(profile);
        // 创建请求接口
        CreateProductRequest request = new CreateProductRequest();
        // 为新建产品命名。产品名在当前账号下应保持唯一。
        request.setProductName("测试设备");
        // 联网方式。此参数为创建高级版产品,产品节点类型为网关或不接入网关的设备时的特有参数。
        // 可选值:
        // WIFI: WiFi
        // CELLULAR:蜂窝网
        // ETHERNET:以太网
        // LORA:LoRaWAN
        // OTHER:其他
        // 若不传入此参数,则默认为WiFi。
        request.setNetType("ETHERNET");
        // 设备接入网关的协议类型。此参数为创建高级版产品,且产品节点类型为要接入网关的设备时的特有参数。
        // 可选值:
        // modbus:Modbus协议。
        // opc-ua:OPC UA协议。
        // customize:自定义协议。
        // ble:BLE协议。
        // zigbee:ZigBee协议。
        request.setProtocolType("modbus");
        // 是否使用ID²认证。
        // 可选值:
        // true:开通ID²认证。
        // false:不开通ID²认证。
        // 不传入此参数,则默认为不开通。
        request.setId2(true);
        // 为新建产品添加描述信息。描述信息应在100字符以内。
        request.setDescription("这是一个测试设备2");
        // 产品版本类型选择为iothub_senior的产品数据格式。
        // 此参数为高级版产品的特有参数,并且是创建高级版产品的必需参数。
        // 可选值:
        // 0:透传/自定义格式(CUSTOM_FORMAT)。
        // 1:Alink协议(ALINK_FORMAT)。
        request.setDataFormat(0);
        // 产品版本类型。
        // iothub_senior:高级版。
        // iothub:基础版。
        // 若不传入此参数默,则默认为基础版。
        request.setAliyunCommodityCode("iothub_senior");
        // 产品的节点类型,取值:
        // 0:设备。设备不能挂载子设备。可以直连物联网平台,也可以作为网关的子设备连接物联网平台。
        // 1:网关。网关可以挂载子设备,具有子设备管理模块,维持子设备的拓扑关系,和将拓扑关系同步到物联网平台。
        request.setNodeType(0);

        try {
            // 发起请求并获取返回值
            CreateProductResponse response = client.getAcsResponse(request);
            // 处理业务逻辑
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }
    }
}           
说明 更多参数信息,请参见API参考