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

前提条件

请先确认您当前物联网平台实例类型及所属地域:
实例 地域 说明 查看方法
旧版公共实例 华东(上海)、日本(东京)

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

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

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

新版公共实例 华东(上海)

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

在物联网平台控制台显示开发配置信息。具体信息,请参见查看新版公共实例和企业版实例终端节点信息
企业版实例 华东(上海)、日本(东京)
实例的详细说明,请参见实例概述

背景信息

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

使用说明

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

地域说明

旧版公共实例下,各终端节点接入域名需使用对应地域的Region ID进行拼接。

地域通常按照数据中心所在的城市进行划分,资源创建成功后不能更换地域。物联网平台支持的所有地域、地域所在城市和Region ID的对照关系如下表所示。

  • 中国内地
    地域名称 所在城市 Region ID
    华东 2 上海 cn-shanghai
  • 其他国家和地区
    所在国家 所在城市 Region ID
    新加坡 新加坡 ap-southeast-1
    日本 东京 ap-northeast-1
    美国 硅谷 us-west-1
    美国 弗吉尼亚 us-east-1
    德国 法兰克福 eu-central-1

地域使用的更多说明,请参见支持的地域

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

通信类型 接入域名格式
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:5671。
${uid} 请替换为您的阿里云账号ID。您可登录物联网平台控制台,移动鼠标指针到账号头像,查看账号ID

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

  1. 登录物联网平台控制台,在页面左上方,选择实例所在地域。
    选择实例地域
  2. 实例概览页面,单击目标实例进入实例详情页面。
  3. 实例详情页面,单击右上角的查看开发配置,在开发配置面板,单击MQTTCoAPHTTP等页签,查看对应终端节点接入信息。
    查看开发配置
    您可单击右侧的复制,获取该实例下对应节点的接入域名;也可单击域名右侧的帮助按钮帮助,查看对应端口号。
    说明 端口号使用的更多说明,请参见本文上方查看旧版公共实例终端节点信息中的端口号说明。
    查看配置

为接入域名绑定固定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时,单击解除绑定