|
|
开发设备端SDK、云端SDK和AMQP SDK时，接入域名需配置为实例对应的终端节点。本文介绍如何获取实例下对应终端节点的接入信息。
前提条件
请先确认您当前物联网平台实例类型及所属地域：
|
实例 |
地域 |
说明 |
查看方法 |
|
旧版公共实例 |
华东2（上海）、日本（东京）、新加坡、德国（法兰克福）、美国（硅谷）、美国（弗吉尼亚） |
在物联网平台控制台 实例概览 页面，实例 ID 不显示具体值。
说明
仅华东2（上海）地域下支持开通新版公共实例服务，其他地域的公共实例默认为旧版公共实例。 |
在物联网平台控制台不显示 开发配置 信息，本文汇总各终端节点信息。具体信息，请参见 查看旧版公共实例终端节点信息 。 |
|
新版公共实例 |
华东2（上海） |
在物联网平台控制台 实例概览 页面，实例 ID 显示具体值，实例下有 实例详情 页面。 |
在物联网平台控制台显示 开发配置 信息。具体信息，请参见 查看新版公共实例和企业版实例终端节点信息 。 |
|
企业版实例 |
华东2（上海）、华北2（北京）、华南1（深圳）、日本（东京）、新加坡、德国（法兰克福）、美国（硅谷）、美国（弗吉尼亚） |
实例的详细说明，请参见 实例概述 。
背景信息
各SDK开发指导，请参见 设备端SDK 、 云端SDK 和 AMQP客户端接入说明 。
使用说明
-
对于实例中的设备使用MQTT、CoAP或HTTP协议接入物联网平台，使用AMQP服务端订阅，或调用云端API时，接入域名需配置为对应的公网终端节点。
-
对于使用ID²认证接的设备，接入物联网平台的ID²认证地址也需配置为对应的公网终端节点。
重要公共实例和企业版实例的ID²认证地址格式相同。格式说明，请参见本文下方 《查看旧版公共实例终端节点信息》 。
-
对于VPC网络，设备使用MQTT设备接入、AMQP服务端订阅和云端API调用时，接入域名需配置为对应的VPC网络终端节点。
-
对于企业版实例，设备使用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 、 HTTP 等页签，查看对应终端节点接入信息。
重要-
对于尊享型实例，MQTT接入域名需手动创建。具体内容，请参见 为尊享型实例创建独立的MQTT接入域名 。
-
如果历史用户已为企业版实例开启ID²认证， 开发配置 面板的 管理ID² 页签下 ID² 认证地址 不可用。ID²认证地址格式说明，请参见本文上方 《查看旧版公共实例终端节点信息》 。
-
设备使用HTTPS协议接入时，仅支持一机一密和一型一密预注册方式，且使用的接入域名不同：
-
使用一机一密方式时，接入域名为 HTTP 页签下接入信息。
-
使用一型一密预注册方式时，物联网平台设备所在地域必须在华东2（上海），接入域名为
iot-auth.cn-shanghai.aliyuncs.com。
-
在对应页签下：
-
单击右侧的 复制 ，获取该实例下对应节点的接入域名。
-
单击域名右侧的帮助按钮
，查看对应端口号。
说明端口号使用的更多说明，请参见本文上方 《查看旧版公共实例终端节点信息》 中的端口号说明。
-
为接入域名绑定固定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。
是否开启VPC网络
-
是 ：开启VPC网络，需要配置专有网络、交换机可用区、交换机和安全组。
此时会同时创建公网和VPC网络的MQTT接入地址。
重要开启VPC网络的MQTT接入域名，需要开通专有网络的私网连接（PrivateLink）服务。若当前阿里云账号未开通该服务，需单击 开通 ，前往 专有网络管理控制台 ，完成开通私网连接服务。
-
否 （默认）：不开启VPC网络。
此时仅创建公网的MQTT接入地址。
重要如果选中 否 ，后续无法再开启VPC网络。
授权
开启VPC网络时，需要完成授权。
单击 授权 ，系统自动创建角色和授权策略，授权设备通过VPC网络接入物联网平台。详细说明，请参见 服务关联角色说明 。
专有网络
开启VPC网络，并授权成功后，需配置该参数。
选择当前账号下，已创建的专有网络和交换机。
交换机可用区
交换机
安全组
开启VPC网络，并授权成功后，需配置该参数。
选择当前账号下，已创建的安全组。
您可单击 创建安全组 ，新增安全组。具体操作，请参见 创建安全组 。
-
-
单击 确认 。
等待接入域名创建完成后， MQTT设备接入 下方显示创建成功的接入域名。
为尊享型实例自定义MQTT接入证书
按照以下步骤，为尊享型实例自定义MQTT接入的证书和域名。
说明
公网和VPC网络接入地域复用同一张自定义证书。
-
在尊享型实例下的 实例详情 页面，单击右上角的 查看开发配置 。
-
在 开发配置 面板，单击 MQTT 页签下 自定义证书 的 点击配置 。
-
在 自定义证书 对话框中，单击 自定义配置 的 开 。
说明若已开启 自定义配置 ，忽略此步骤。
-
输入从证书颁发机构获得的PEM格式的证书内容和证书密钥，单击 确定 。
警告若已定义证书内容和证书密钥，更新证书信息后，证书校验会异常，导致设备无法连接到物联网平台、用户业务中断。请谨慎操作。
页面会显示从自定义证书中解析出的自定义域名。您可使用自定义域名进行MQTT设备接入。
重要您需要在域名提供商配置CNAME，将自定义域名解析到实例默认的MQTT接入域名。