Link IoT Edge被集成到第三方业务系统中时,需要使用标准的协议接口,使得其他应用程序能够访问Link IoT Edge的子设备或配置本地计算规则。本文介绍如何开始使用Link IoT Edge的MQTT API的方法。

Link IoT Edge中使用3.1版本MQTT协议,MQTT Broker默认随Link IoT Edge一同部署。应用程序通过访问Link IoT Edge的IP地址:8883端口接入到MQTT Broker。MQTT客户端连接Broker的用户名和密码由用户在云端控制台配置并部署到边缘网关,目前密码配置露出在边缘分组配置页面。

说明 MQTT Broker的用户名和密码请参见本文下方云端开启MQTT API中的操作。

不同的应用程序,获取Link IoT Edge IP地址的方法也不同,具体如下所示:

  • 当应用程序被Link IoT Edge托管,且以容器模式运行时,可以通过读取环境变量FCBASE_IPADDR的值,获取Link IoT Edge容器当前的IP地址。
  • 当应用程序被Link IoT Edge托管,且以进程模式运行时,Link IoT Edge的IP地址为127.0.0.1,即本机地址。
  • 当应用程序为第三方系统组件,即没有被Link IoT Edge托管时,Link IoT Edge的IP地址为运行Link IoT Edge的宿主机IP地址。

云端开启MQTT API

调用MQTT API前,需要在云端开启MQTT API开关。

  1. 登录物联网平台控制台,在左侧导航栏选择边缘计算 > 边缘实例
  2. 进入目标边缘实例的实例详情页面,选择设置页签,打开Open API后的开关。
    云端开关
  3. 边缘Open API权限配置对话框中设置参数,然后单击确定
    参数 描述
    访问边缘Open API的用户名 设置用户名。支持英文字母、数字、下划线(_)和中划线(-),长度不超过64个字符。
    访问边缘Open API的密码 设置用户名密码。只允许设置十六进制格式的密码,不需要以0x开头,长度为6~64字节。
    再次确认密码 再次输入已设置的密码。

    当开关按钮显示为按钮时,表示已开启MQTT API开关。您可以开始使用边缘端MQTT API,处理您的业务。