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

前提条件

请先确认您当前物联网平台实例类型及所属地域：
实例 地域 说明 查看方法
旧版公共实例 华东（上海）

在物联网平台控制台实例概览页面，实例ID不显示具体值，实例下无实例详情页面。

说明 在日本（东京）地域下，不支持开通新版公共实例服务，默认公共实例为旧版公共实例。
在物联网平台控制台不显示开发配置信息，本文汇总各终端节点信息。具体信息，请参见查看旧版公共实例终端节点信息。
日本（东京）、新加坡、德国（法兰克福）、美国（硅谷）、美国（弗吉尼亚）

未开通企业版实例服务，默认公共实例为旧版公共实例，在物联网平台控制台无实例概览页面。

新版公共实例 华东（上海）

在物联网平台控制台实例概览页面，实例ID显示具体值，实例下有实例详情页面。

在物联网平台控制台显示开发配置信息。具体信息，请参见查看新版公共实例和企业版实例终端节点信息。
企业版实例 华东（上海）、华北2（北京）、华南1（深圳）
实例的详细说明，请参见实例概述。

背景信息

各SDK开发指导，请参见设备端SDK、云端SDK和AMQP客户端接入说明。

使用说明

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

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

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

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

通信类型 接入域名格式
MQTT ${YourProductKey}.iot-as-mqtt.${YourRegionId}.aliyuncs.com:${port}。
CoAP ${YourProductKey}.coap.cn-shanghai.link.aliyuncs.com:${port}。
HTTP https://iot-as-http.${YourRegionId}.aliyuncs.com:${port}。
AMQP ${uid}.iot-amqp.${YourRegionId}.aliyuncs.com:${port}。
云端API 请求结构为http://Endpoint/?Action=**&Parameters，详细说明，请参见调用API。

在实际场景中，需替换各终端节点信息中的以下参数：

参数 说明
${YourProductKey} 请替换为设备所属产品的ProductKey。您可登录物联网平台控制台，在对应实例的设备详情页面获取。
${YourRegionId} 请替换为您的物联网平台设备所在地域的Region ID。Region ID表达方法，请参见支持的地域。
${port} 请替换为对应终端节点的端口号：
  • MQTT：1883或443。使用MQTT over WebSocket时，使用443端口。
  • CoAP：使用DTLS时，端口为5684。使用对称加密时，端口为5682。
  • HTTP：443。
  • AMQP：
    • 对于Java、.NET、Python 2.7、Node.js、Go客户端：端口号为5671。
    • 对于Python3、PHP客户端：端口号为61614。
${uid} 请替换为您的阿里云账号ID。您可登录物联网平台控制台，移动鼠标指针到账号头像，查看账号ID。

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

  1. 登录物联网平台控制台，在页面左上方，选择实例所在地域。
  2. 在实例概览页面，单击目标实例进入实例详情页面。
  3. 在实例详情页面，单击右上角的查看开发配置，在开发配置面板，单击MQTT、CoAP、HTTP等页签，查看对应终端节点接入信息。
    查看开发配置
    您可单击右侧的复制，获取该实例下对应节点的接入域名；也可单击域名右侧的帮助按钮帮助，查看对应端口号。
    说明 端口号使用的更多说明，请参见本文上方《查看旧版公共实例终端节点信息》中的端口号说明。
    终端节点
  4. 对于启用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右侧的设置。
    3. 在弹出的对话框中单击确定，可得到2个固定IP。

    当MQTT设备接入不再需要固定IP时，单击解除绑定即可。

  • 对于尊享型实例，已默认为实例分配1个固定IP，您无需操作。不支持解除绑定。

自定义公网MQTT接入域名

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

  1. 在尊享型实例下的实例详情页面，单击右上角的查看开发配置。
  2. 在开发配置面板，单击MQTT页签下设备接入域名右侧的自定义证书。
  3. 在自定义证书对话框中，单击自定义配置的开。
    说明 若已开启自定义配置，忽略此步骤。
  4. 输入从证书颁发机构获得的PEM格式的证书内容和证书密钥，单击确定。
    警告 若已定义证书内容和证书密钥，更新证书信息后，证书校验会异常，导致设备无法连接到物联网平台、用户业务中断。请谨慎操作。

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

    重要 您需要在域名提供商配置CNAME，将自定义域名解析到实例默认的MQTT设备接入域名。