文档

查看和配置实例终端节点信息(Endpoint)

更新时间:
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

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

前提条件

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

  • 不同类型实例的概念和对比,请参见实例概述

    实例

    地域

    说明

    查看方法

    旧版公共实例

    华东2(上海)、日本(东京)、新加坡、德国(法兰克福)、美国(硅谷)、美国(弗吉尼亚)

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

    在物联网平台控制台不显示开发配置信息,本文汇总各终端节点信息。具体信息,请参见查看旧版公共实例终端节点信息

    新版公共实例

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

    • 新开通物联网平台服务,默认为新版公共实例。

    在物联网平台控制台显示开发配置信息。具体信息,请参见查看新版公共实例和企业版实例终端节点信息

    企业版实例

    华东2(上海)、华北2(北京)、华南1(深圳)、日本(东京)、新加坡、德国(法兰克福)、美国(硅谷)、美国(弗吉尼亚)

背景信息

  • 域名类型

    • 分为公网域名VPC网络域名,使用内网域名可以降低网络时延、节省公网流量费用、提高连接的安全性和稳定性。

    • 设备接入物联网平台:MQTT、CoAPHTTP。尊享型企业版实例支持挂载VPC网络,配置完成后设备可通过VPC网络接入物联网平台,设备可使用MQTT协议的VPC网络域名。

    • 用户使用AMQP服务端订阅、调用云端API。对于专有网络VPC内的ECS实例,用户调用云端API或使用AMQP服务端订阅时,可以配置VPC网络域名

  • 实例类型

    • 华东2(上海)、华北2(北京)、华南1(深圳)地域的标准型和尊享型企业版实例:设备使用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

  • 使用DTLS时,端口号为5684。

  • 使用对称加密时,端口号为5682。

HTTP

一机一密:https://iot-as-http.${YourRegionId}.aliyuncs.com

443。

一型一密预注册:iot-auth.cn-shanghai.aliyuncs.com

重要

仅华东2(上海)地域支持设备使用HTTPS协议的一型一密预注册方式。

AMQP

${uid}.iot-amqp.${YourRegionId}.aliyuncs.com

  • 对于Java、.NET、Python 2.7、Node.js、Go客户端:端口号为5671。

  • 对于Python3、PHP客户端:端口号为61614。

云端API

请求结构为http://Endpoint/?Action=**&Parameters,详细说明,请参见调用API

不涉及。

ID²

${YourProductKey}.itls.${YourRegionId}.aliyuncs.com

仅支持华东2(上海)地域。

1883。

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

参数

说明

${YourProductKey}

请替换为设备所属产品的ProductKey。您可登录物联网平台控制台,在对应实例的设备详情页面获取。

${YourRegionId}

请替换为您的物联网平台设备所在地域的Region ID。Region ID表达方法,请参见支持的地域

${uid}

请替换为您的阿里云账号ID。您可登录物联网平台控制台,移动鼠标指针到账号头像,查看账号ID

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

  1. 登录物联网平台控制台,在页面左上方,选择实例所在地域。

  2. 实例概览页面,单击目标实例的备注名称或ID

  3. 实例详情页面,单击右上角的查看开发配置

    查看开发配置

  4. 开发配置面板,单击MQTTCoAPAMQP等页签,查看对应终端节点接入信息。单击域名右侧的复制获取接入地址,单击域名后的帮助按钮帮助查看对应端口号。端口号的更多说明,请参见本文上方查看旧版公共实例终端节点信息中的端口号说明。

    重要
    • 对于尊享型实例,MQTT接入域名需手动创建。具体内容,请参见为尊享型实例创建独立的MQTT接入域名

    • 设备使用HTTPS协议接入时,仅支持一机一密和一型一密预注册方式,且使用的接入域名不同:

      • 使用一机一密方式时,接入域名为HTTP页签下接入信息。

      • 使用一型一密预注册方式时,只有华东2(上海)地域支持,接入域名为iot-auth.cn-shanghai.aliyuncs.com

    • 如果历史用户已为企业版实例开启ID²认证,开发配置面板的管理ID²页签下ID² 认证地址不可用。ID²认证地址格式说明,请参见本文上方查看旧版公共实例终端节点信息

    查看配置

为接入域名绑定固定IP

重要

仅华东2(上海)、华北2(北京)、华南1(深圳)地域的标准型和尊享型企业版实例支持该功能。

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

说明

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

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

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

  • 对于非尊享型实例,可为MQTT设备接入分配2个固定IP。

    1. 在非尊享型实例下的实例详情页面,单击右上角的查看开发配置

    2. 开发配置面板,单击MQTT页签下固定IP右侧的设置

    3. 在弹出的对话框中单击确定,可得到2个固定IP。

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

  • 对于尊享型实例,手动创建MQTT公网接入域名后,已默认为实例分配1个固定IP,您无需操作。不支持解除绑定。

为尊享型实例创建独立的MQTT接入域名

按照以下步骤,为尊享型实例创建MQTT接入域名。

  1. 在尊享型实例下的实例详情页面,单击右上角的查看开发配置

  2. 开发配置面板,单击MQTT页签下的点击创建

  3. 创建接入点对话框中,配置接入信息。

    参数

    说明

    自定义端口

    MQTT接入的端口号。默认端口号为1883。

    是否开启VPC网络

    • :开启VPC网络,需要配置专有网络、交换机可用区、交换机和安全组。

      此时会同时创建公网和VPC网络的MQTT接入地址。

      重要

      开启VPC网络的MQTT接入域名,需要开通专有网络的私网连接(PrivateLink)服务。若当前阿里云账号未开通该服务,需单击开通,前往专有网络管理控制台,完成开通私网连接服务。

    • (默认):不开启VPC网络。

      此时仅创建公网的MQTT接入地址。

      重要

      如果选中,后续无法再开启VPC网络。

    授权

    开启VPC网络时,需要完成授权。

    单击授权,系统自动创建角色和授权策略,授权设备通过VPC网络接入物联网平台。详细说明,请参见服务关联角色说明

    专有网络

    开启VPC网络,并授权成功后,需配置该参数。

    选择当前账号下,已创建的专有网络和交换机。

    您可单击创建专有网络创建交换机,新增专有网络和交换机。具体操作,请参见创建专有网络创建交换机

    交换机可用区

    交换机

    安全组

    开启VPC网络,并授权成功后,需配置该参数。

    选择当前账号下,已创建的安全组。

    您可单击创建安全组,新增安全组。具体操作,请参见创建安全组

  4. 单击确认

    等待接入域名创建完成后,MQTT设备接入下方显示创建成功的接入域名。

为尊享型实例自定义MQTT接入证书

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

说明

公网和VPC网络接入地域复用同一张自定义证书。

  1. 在尊享型实例下的实例详情页面,单击右上角的查看开发配置

  2. 开发配置面板,单击MQTT页签下自定义证书点击配置

  3. 自定义证书对话框中,单击自定义配置

    说明

    若已开启自定义配置,忽略此步骤。

  4. 输入从证书颁发机构获得的PEM格式的证书内容和证书密钥,单击确定

    警告

    若已定义证书内容和证书密钥,更新证书信息后,证书校验会异常,导致设备无法连接到物联网平台、用户业务中断。请谨慎操作。

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

    重要

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

  • 本页导读 (1)
文档反馈