开发设备端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接入域名、证书。
地域说明
地域是指物理的数据中心。资源创建成功后不能更换地域。当前所有的地域、地域所在城市和Region ID的对照关系如下表所示。
旧版公共实例下,各终端节点接入域名需使用对应地域的Region ID进行拼接。
- 中国内地
地域名称 所在城市 Region ID 华北 2 北京 cn-beijing 华东 2 上海 cn-shanghai 华南 1 深圳 cn-shenzhen - 其他国家和地区
所在国家 所在城市 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:1883 。
|
CoAP | ${YourProductKey}.coap.cn-shanghai.link.aliyuncs.com:${port} 。
|
HTTP | https://iot-as-http.${YourRegionId}.aliyuncs.com 。
|
AMQP | ${uid}.iot-amqp.${YourRegionId}.aliyuncs.com 。
|
调用API | 请求结构为http://Endpoint/?Action=**&Parameters ,详细说明,请参见调用API。
|
在实际场景中,需替换各终端节点信息中的以下参数:
查看新版公共实例和企业版实例终端节点信息
为接入域名绑定固定IP
固定IP的作用是物联网平台IP扩容时,不会改变您的域名解析。如果您是物联网卡定向流量卡用户,且运营商不支持配置域名时,可以添加固定IP到运营商定向流量IP列表中。
因此,建议您使用接入域名进行设备接入,物联网平台会提前通知您IP变更情况。
按照以下步骤,为实例的公网MQTT设备接入域名绑定固定IP。
- 对于非尊享型实例,可为MQTT设备接入分配2个固定IP。
- 在非尊享型实例下的实例详情页面,单击右上角的查看开发配置。
- 在开发配置面板,单击MQTT页签下固定IP右侧的设置。
- 在弹出的对话框中单击确定,可得到2个固定IP。
当MQTT设备接入不再需要固定IP时,单击解除绑定。
- 对于尊享型实例,已为实例分配1个固定IP,您无需操作。不可解除绑定。
自定义公网MQTT接入域名
按照以下步骤,为尊享型实例自定义MQTT接入的证书和域名。