本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
开发设备端SDK、云端SDK和AMQP SDK时,接入域名需配置为实例对应的终端节点。本文介绍如何获取实例下对应终端节点的接入信息。
前提条件
- 不同SDK的开发指导,请参见设备端SDK、云端SDK和AMQP客户端接入说明。 
- 不同类型实例的概念和对比,请参见实例概述。 - 实例 - 地域 - 说明 - 查看方法 - 旧版公共实例 - 华东2(上海)、日本(东京)、新加坡、德国(法兰克福)、美国(硅谷)、美国(弗吉尼亚) - 在物联网平台控制台实例概览页面,实例ID不显示具体值。 - 在物联网平台控制台不显示开发配置信息,本文汇总各终端节点信息。具体信息,请参见查看旧版公共实例终端节点信息。 - 新版公共实例 - 在物联网平台控制台实例概览页面,实例ID显示具体值,实例下有实例详情页面。 
- 新开通物联网平台服务,默认为新版公共实例。 
 - 在物联网平台控制台显示开发配置信息。具体信息,请参见查看新版公共实例和企业版实例终端节点信息。 - 企业版实例 - 华东2(上海)、华北2(北京)、华南1(深圳)、日本(东京)、新加坡、德国(法兰克福)、美国(硅谷)、美国(弗吉尼亚) 
背景信息
- 域名类型 - 分为公网域名和VPC网络域名,使用内网域名可以降低网络时延、节省公网流量费用、提高连接的安全性和稳定性。 
- 设备接入物联网平台:MQTT、CoAP或HTTP。尊享型企业版实例支持挂载VPC网络,配置完成后设备可通过VPC网络接入物联网平台,设备可使用MQTT协议的VPC网络域名。 
- 用户使用AMQP服务端订阅、调用云端API。对于专有网络VPC内的ECS实例,用户调用云端API或使用AMQP服务端订阅时,可以配置VPC网络域名。 
 
- 实例类型 - 华东2(上海)、华北2(北京)、华南1(深圳)地域的标准型和尊享型企业版实例:设备使用MQTT协议接入时,支持接入域名绑定固定IP。 
- 尊享型企业版实例:需要手动创建独立的MQTT接入域名,可以自定义端口号和证书。 
 
查看旧版公共实例终端节点信息
| 通信类型 | 接入域名格式 | 端口号 | 
| MQTT | 
 | 1883或443。 使用MQTT over WebSocket时,使用443端口。 | 
| CoAP | 
 | 
 | 
| HTTP | 一机一密: | 443。 | 
| 一型一密预注册: 重要  仅华东2(上海)地域支持设备使用HTTPS协议的一型一密预注册方式。 | ||
| AMQP | 
 | 
 | 
| 云端API | 请求结构为 | 不涉及。 | 
| ID² | 
 仅支持华东2(上海)地域。 | 1883。 | 
在实际场景中,需替换各终端节点信息中的以下参数:
| 参数 | 说明 | 
| 
 | 请替换为设备所属产品的ProductKey。您可登录物联网平台控制台,在对应实例的设备详情页面获取。 | 
| 
 | 请替换为您的物联网平台设备所在地域的Region ID。Region ID表达方法,请参见支持的地域。 | 
| 
 | 请替换为您的阿里云账号ID。您可登录物联网平台控制台,移动鼠标指针到账号头像,查看账号ID。 | 
查看新版公共实例和企业版实例终端节点信息
- 登录物联网平台控制台,在页面左上方,选择实例所在地域。 
- 在实例概览页面,单击目标实例的备注名称或ID。 
- 在实例详情页面,单击右上角的查看开发配置。  
- 在开发配置面板,单击MQTT、CoAP、AMQP等页签,查看对应终端节点接入信息。单击域名右侧的复制获取接入地址,单击域名后的帮助按钮  查看对应端口号。端口号的更多说明,请参见本文上方查看旧版公共实例终端节点信息中的端口号说明。重要 查看对应端口号。端口号的更多说明,请参见本文上方查看旧版公共实例终端节点信息中的端口号说明。重要- 对于尊享型实例,MQTT接入域名需手动创建。具体内容,请参见为尊享型实例创建独立的MQTT接入域名。 
- 设备使用HTTPS协议接入时,仅支持一机一密和一型一密预注册方式,且使用的接入域名不同: - 使用一机一密方式时,接入域名为HTTP页签下接入信息。 
- 使用一型一密预注册方式时,只有华东2(上海)地域支持,接入域名为 - iot-auth.cn-shanghai.aliyuncs.com。
 
- 如果历史用户已为企业版实例开启ID²认证,开发配置面板的管理ID²页签下ID² 认证地址不可用。ID²认证地址格式说明,请参见本文上方查看旧版公共实例终端节点信息。 
  
为接入域名绑定固定IP
仅华东2(上海)、华北2(北京)、华南1(深圳)地域的标准型和尊享型企业版实例支持该功能。
固定IP的作用是物联网平台IP扩容时,不会改变您的域名解析。如果您是物联网卡定向流量卡用户,且运营商不支持配置域名时,可以添加固定IP到运营商定向流量IP列表中。
某些情况下,例如运营商机房搬迁导致原IP不可用时,不能保证您的IP不变。如果您的设备接入没有使用接入域名而是使用固定IP,请通过云端下发或者OTA升级,同步新IP到设备,否则设备会无法正常连接物联网平台。
因此,建议您使用接入域名进行设备接入,物联网平台会提前通知您IP变更情况。
按照以下步骤,为实例的公网MQTT设备接入域名绑定固定IP。
- 对于非尊享型实例,可为MQTT设备接入分配2个固定IP。 - 在非尊享型实例下的实例详情页面,单击右上角的查看开发配置。 
- 在开发配置面板,单击MQTT页签下固定IP右侧的设置。 
- 在弹出的对话框中单击确定,可得到2个固定IP。 
 - 当MQTT设备接入不再需要固定IP时,单击解除绑定即可。 
- 对于尊享型实例,手动创建MQTT公网接入域名后,已默认为实例分配1个固定IP,您无需操作。不支持解除绑定。 
为尊享型实例创建独立的MQTT接入域名
按照以下步骤,为尊享型实例创建MQTT接入域名。
- 在尊享型实例下的实例详情页面,单击右上角的查看开发配置。 
- 在开发配置面板,单击MQTT页签下的点击创建。 
- 在创建接入点对话框中,配置接入信息。 - 参数 - 说明 - 自定义端口 - MQTT接入的端口号。默认端口号为1883。 - 是否开启VPC网络 - 是:开启VPC网络,需要配置专有网络、交换机可用区、交换机和安全组。 - 此时会同时创建公网和VPC网络的MQTT接入地址。 重要- 开启VPC网络的MQTT接入域名,需要开通专有网络的私网连接(PrivateLink)服务。若当前阿里云账号未开通该服务,需单击开通,前往专有网络管理控制台,完成开通私网连接服务。 
- 否(默认):不开启VPC网络。 - 此时仅创建公网的MQTT接入地址。 重要- 如果选中否,后续无法再开启VPC网络。 
 - 授权 - 开启VPC网络时,需要完成授权。 - 单击授权,系统自动创建角色和授权策略,授权设备通过VPC网络接入物联网平台。详细说明,请参见服务关联角色说明。 - 专有网络 - 开启VPC网络,并授权成功后,需配置该参数。 - 选择当前账号下,已创建的专有网络和交换机。 - 交换机可用区 - 交换机 - 安全组 - 开启VPC网络,并授权成功后,需配置该参数。 - 选择当前账号下,已创建的安全组。 - 您可单击创建安全组,新增安全组。具体操作,请参见创建安全组。 
- 单击确认。 - 等待接入域名创建完成后,MQTT设备接入下方显示创建成功的接入域名。 
为尊享型实例自定义MQTT接入证书
按照以下步骤,为尊享型实例自定义MQTT接入的证书和域名。
公网和VPC网络接入地域复用同一张自定义证书。
- 在尊享型实例下的实例详情页面,单击右上角的查看开发配置。 
- 在开发配置面板,单击MQTT页签下自定义证书的点击配置。 
- 在自定义证书对话框中,单击自定义配置的开。 说明- 若已开启自定义配置,忽略此步骤。 
- 输入从证书颁发机构获得的PEM格式的证书内容和证书密钥,单击确定。 警告- 若已定义证书内容和证书密钥,更新证书信息后,证书校验会异常,导致设备无法连接到物联网平台、用户业务中断。请谨慎操作。 - 页面会显示从自定义证书中解析出的自定义域名。您可使用自定义域名进行MQTT设备接入。 重要- 您需要在域名提供商配置CNAME,将自定义域名解析到实例默认的MQTT接入域名。