本示例介绍使用Alibaba Cloud SDK for Java调用CreateProduct接口创建产品。
前提条件
请在pom.xml文件中增加以下依赖,准确的SDK版本号,参见阿里云开发工具包(SDK)。
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>java.demo</groupId>
<artifactId>test</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-core -->
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>4.4.3</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-iot -->
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-iot</artifactId>
<version>6.11.0</version>
</dependency>
</dependencies>
</project>
此接口限制说明如下:
- 单阿里云账号调用该接口的每秒请求数(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());
}
}
}