开发设备端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 |
1883或443。 使用MQTT over WebSocket时,使用443端口。 |
CoAP | ${YourProductKey}.coap.cn-shanghai.link.aliyuncs.com |
|
HTTP | 一机一密:https://iot-as-http.${YourRegionId}.aliyuncs.com |
443。 |
一型一密预注册:iot-auth.cn-shanghai.aliyuncs.com
重要 仅华东2(上海)地域支持设备使用HTTPS协议的一型一密预注册方式。
|
||
AMQP | ${uid}.iot-amqp.${YourRegionId}.aliyuncs.com |
|
云端API | 请求结构为http://Endpoint/?Action=**&Parameters ,详细说明,请参见调用API。 |
不涉及。 |
ID² | ${YourProductKey}.itls.${YourRegionId}.aliyuncs.com 仅支持华东2(上海)和新加坡地域。 |
1883。 |
在实际场景中,需替换各终端节点信息中的以下参数:
参数 | 说明 |
---|---|
${YourProductKey} |
请替换为设备所属产品的ProductKey。您可登录物联网平台控制台,在对应实例的设备详情页面获取。 |
${YourRegionId} |
请替换为您的物联网平台设备所在地域的Region ID。Region ID表达方法,请参见支持的地域。 |
${uid} |
请替换为您的阿里云账号ID。您可登录物联网平台控制台,移动鼠标指针到账号头像,查看账号ID。 |
查看新版公共实例和企业版实例终端节点信息
- 登录物联网平台控制台,在页面左上方,选择实例所在地域。
- 在实例概览页面,单击目标实例的备注名称或ID。
- 在实例详情页面,单击右上角的查看开发配置。
- 在开发配置面板,单击MQTT、CoAP、HTTP等页签,查看对应终端节点接入信息。
重要 对于尊享型实例,MQTT接入域名需手动创建。具体内容,请参见 为尊享型实例创建独立的MQTT接入域名。
- 单击右侧的复制,获取该实例下对应节点的接入域名。
- 单击域名右侧的帮助按钮
,查看对应端口号。
说明 端口号使用的更多说明,请参见本文上方 《查看旧版公共实例终端节点信息》中的端口号说明。重要 设备使用HTTPS协议接入时,仅支持一机一密和一型一密预注册方式,且使用的接入域名不同:- 使用一机一密方式时,接入域名为HTTP页签下接入信息。
- 使用一型一密预注册方式时,物联网平台设备所在地域必须在华东2(上海),接入域名为
iot-auth.cn-shanghai.aliyuncs.com
。
- 对于启用ID²设备身份认证的实例,单击管理ID²页签,显示的ID²认证地址即为设备接入域名。
复制 ID²控制台地址,粘贴到浏览器地址栏并按回车键,可跳转到该实例对应的ID²设备身份认证控制台。
为接入域名绑定固定IP
固定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。等待接入域名创建完成后, MQTT设备接入下方显示创建成功的接入域名。
为尊享型实例自定义MQTT接入证书
按照以下步骤,为尊享型实例自定义MQTT接入的证书和域名。
- 在尊享型实例下的实例详情页面,单击右上角的查看开发配置。
- 在开发配置面板,单击MQTT页签下设备接入域名右侧的自定义证书。
- 在自定义证书对话框中,单击自定义配置的开。
说明 若已开启 自定义配置,忽略此步骤。
- 输入从证书颁发机构获得的PEM格式的证书内容和证书密钥,单击确定。
警告 若已定义证书内容和证书密钥,更新证书信息后,证书校验会异常,导致设备无法连接到物联网平台、用户业务中断。请谨慎操作。
页面会显示从自定义证书中解析出的自定义域名。您可使用自定义域名进行MQTT设备接入。
重要 您需要在域名提供商配置CNAME,将自定义域名解析到实例默认的MQTT接入域名。