开发设备端SDK、云端SDK和AMQP SDK时,接入域名需配置为实例对应的终端节点。本文介绍如何获取实例下对应终端节点的接入信息。

背景信息

实例的详细说明,请参见实例概述

各SDK开发指导,请参见设备端SDK云端SDKAMQP客户端接入说明

使用说明

  • 对于实例中的设备使用MQTT、CoAP或HTTP协议接入物联网平台,使用AMQP服务端订阅,或调用云端API时,接入域名需配置为对应的公网终端节点。

    若您为实例启用了ID²设备身份认证,设备使用ID²认证时,ID²认证地址也需配置为对应的公网终端节点。

  • 对于VPC网络,设备使用MQTT设备接入、AMQP服务端订阅和云端API调用时,接入域名需配置为对应的VPC网络终端节点。
  • 对于企业版实例,设备使用MQTT协议接入时,支持接入域名绑定固定IP。
  • 对于连接型的企业版实例,支持自定义MQTT接入域名、证书。

查看旧版公共实例终端节点信息

通信类型 接入域名格式
MQTT ${YourProductKey}.iot-as-mqtt.${YourRegionId}.aliyuncs.com:1883,其中:
  • ${YourProductKey}:请替换为设备所属产品的ProductKey。可登录物联网平台控制台,在对应实例的设备详情页面获取。
  • ${YourRegionId}:请替换为您的物联网平台设备所在地域代码。地域代码表达方法,请参见地域和可用区
CoAP ${YourProductKey}.coap.cn-shanghai.link.aliyuncs.com:${port},其中:
  • ${YourProductKey}:请替换为设备所属产品的ProductKey。可登录物联网平台控制台,在对应实例的设备详情页面获取。
  • ${port}:端口。使用DTLS时,端口为5684。使用对称加密时,端口为5682。
HTTP https://iot-as-http.${YourRegionId}.aliyuncs.com

其中,${YourRegionId}请替换为您的物联网平台设备所在地域代码。地域代码表达方法,请参见地域和可用区

AMQP ${uid}.iot-amqp.${YourRegionId}.aliyuncs.com,其中:
  • ${uid}:您的阿里云账号ID。可登录物联网平台控制台,将鼠标指针移动到账号头像,查看账号ID
  • ${YourRegionId}:请替换为您的物联网平台设备所在地域代码。地域代码表达方法,请参见地域和可用区
调用API 请求结构为http://Endpoint/?Action=**&Parameters,详细说明,请参见调用API

查看新版公共实例和企业版实例终端节点信息

  1. 登录物联网平台控制台,在页面左上方,选择实例所在地域。
    选择地域
  2. 实例概览页面,单击目标实例进入实例详情页面。
  3. 实例详情页面,单击右上角的查看开发配置,在开发配置面板,单击MQTTCoAPHTTP等页签,查看对应终端节点接入信息。
    您可单击右侧的复制,获取该实例下对应节点的接入域名。终端节点
  4. 对于启用ID²设备身份认证的实例,选择管理ID²,显示的ID²认证地址即为设备接入域名。
    复制ID²控制台地址,粘贴到浏览器地址栏并按回车键,可跳转到该实例对应的ID²设备身份认证控制台。ID²

为接入域名绑定固定IP

固定IP的作用是物联网平台IP扩容时,不会改变您的域名解析。如果您是物联网卡定向流量卡用户,且运营商不支持配置域名时,可以将固定IP添加到运营商定向流量IP列表中。

说明 某些情况下,例如运营商机房搬迁导致原IP不可用时,不能保证您的IP不变。如果您的设备接入没有使用接入域名而是使用固定IP,请通过云端下发或者OTA升级,同步新IP到设备,否则设备将无法正常连接物联网平台。

因此,建议您使用接入域名进行设备接入,物联网平台将提前通知您IP变更情况。

按照以下步骤,为实例的公网MQTT设备接入域名绑定固定IP。

  • 对于非连接型实例,可为MQTT设备接入分配2个固定IP。
    1. 在非连接型实例下的实例详情页面,单击右上角的查看开发配置
    2. 开发配置面板,单击MQTT页签下固定IP右侧的设置固定IP
    3. 在弹出的对话框中单击确定,可得到2个固定IP。

    当MQTT设备接入不再需要固定IP时,单击解除绑定

  • 对于连接型实例,已为实例分配1个固定IP,您无需操作。不可解除绑定。

自定义公网MQTT接入域名

按照以下步骤,为连接型实例自定义MQTT接入的证书和域名。

  1. 在连接型实例下的实例详情页面,单击右上角的查看开发配置
  2. 开发配置面板,单击MQTT页签下设备接入域名右侧的自定义证书
    自定义证书
  3. 在对话框中开启自定义配置,填写从证书颁发机构获得的PEM格式的证书内容、证书密钥,单击确定
    自定义证书

    页面显示从自定义证书中解析出的自定义域名。您可使用自定义域名进行MQTT设备接入。

    说明 您需要在域名提供商配置CNAME,解析到实例默认的MQTT设备接入域名。