查看和配置實例終端節(jié)點信息(Endpoint)
本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業(yè)務(wù)造成影響,請務(wù)必仔細(xì)閱讀。
開發(fā)設(shè)備端SDK、云端SDK和AMQP SDK時,接入域名需配置為實例對應(yīng)的終端節(jié)點。本文介紹如何獲取實例下對應(yīng)終端節(jié)點的接入信息。
前提條件
不同SDK的開發(fā)指導(dǎo),請參見設(shè)備端SDK、云端SDK和AMQP客戶端接入說明。
不同類型實例的概念和對比,請參見實例概述。
實例
地域
說明
查看方法
舊版公共實例
華東2(上海)、日本(東京)、新加坡、德國(法蘭克福)、美國(硅谷)、美國(弗吉尼亞)
在物聯(lián)網(wǎng)平臺控制臺實例概覽頁面,實例ID不顯示具體值。
在物聯(lián)網(wǎng)平臺控制臺不顯示開發(fā)配置信息,本文匯總各終端節(jié)點信息。具體信息,請參見查看舊版公共實例終端節(jié)點信息。
新版公共實例
在物聯(lián)網(wǎng)平臺控制臺實例概覽頁面,實例ID顯示具體值,實例下有實例詳情頁面。
新開通物聯(lián)網(wǎng)平臺服務(wù),默認(rèn)為新版公共實例。
在物聯(lián)網(wǎng)平臺控制臺顯示開發(fā)配置信息。具體信息,請參見查看新版公共實例和企業(yè)版實例終端節(jié)點信息。
企業(yè)版實例
華東2(上海)、華北2(北京)、華南1(深圳)、日本(東京)、新加坡、德國(法蘭克福)、美國(硅谷)、美國(弗吉尼亞)
背景信息
域名類型
分為公網(wǎng)域名和VPC網(wǎng)絡(luò)域名,使用內(nèi)網(wǎng)域名可以降低網(wǎng)絡(luò)時延、節(jié)省公網(wǎng)流量費用、提高連接的安全性和穩(wěn)定性。
設(shè)備接入物聯(lián)網(wǎng)平臺:MQTT、CoAP或HTTP。尊享型企業(yè)版實例支持掛載VPC網(wǎng)絡(luò),配置完成后設(shè)備可通過VPC網(wǎng)絡(luò)接入物聯(lián)網(wǎng)平臺,設(shè)備可使用MQTT協(xié)議的VPC網(wǎng)絡(luò)域名。
用戶使用AMQP服務(wù)端訂閱、調(diào)用云端API。對于專有網(wǎng)絡(luò)VPC內(nèi)的ECS實例,用戶調(diào)用云端API或使用AMQP服務(wù)端訂閱時,可以配置VPC網(wǎng)絡(luò)域名。
實例類型
華東2(上海)、華北2(北京)、華南1(深圳)地域的標(biāo)準(zhǔn)型和尊享型企業(yè)版實例:設(shè)備使用MQTT協(xié)議接入時,支持接入域名綁定固定IP。
尊享型企業(yè)版實例:需要手動創(chuàng)建獨立的MQTT接入域名,可以自定義端口號和證書。
查看舊版公共實例終端節(jié)點信息
通信類型 | 接入域名格式 | 端口號 |
MQTT |
| 1883或443。 使用MQTT over WebSocket時,使用443端口。 |
CoAP |
|
|
HTTP | 一機一密: | 443。 |
一型一密預(yù)注冊: 重要 僅華東2(上海)地域支持設(shè)備使用HTTPS協(xié)議的一型一密預(yù)注冊方式。 | ||
AMQP |
|
|
云端API | 請求結(jié)構(gòu)為 | 不涉及。 |
ID2 |
僅支持華東2(上海)地域。 | 1883。 |
在實際場景中,需替換各終端節(jié)點信息中的以下參數(shù):
參數(shù) | 說明 |
| 請?zhí)鎿Q為設(shè)備所屬產(chǎn)品的ProductKey。您可登錄物聯(lián)網(wǎng)平臺控制臺,在對應(yīng)實例的設(shè)備詳情頁面獲取。 |
| 請?zhí)鎿Q為您的物聯(lián)網(wǎng)平臺設(shè)備所在地域的Region ID。Region ID表達方法,請參見支持的地域。 |
| 請?zhí)鎿Q為您的阿里云賬號ID。您可登錄物聯(lián)網(wǎng)平臺控制臺,移動鼠標(biāo)指針到賬號頭像,查看賬號ID。 |
查看新版公共實例和企業(yè)版實例終端節(jié)點信息
登錄物聯(lián)網(wǎng)平臺控制臺,在頁面左上方,選擇實例所在地域。
在實例概覽頁面,單擊目標(biāo)實例的備注名稱或ID。
在實例詳情頁面,單擊右上角的查看開發(fā)配置。
在開發(fā)配置面板,單擊MQTT、CoAP、AMQP等頁簽,查看對應(yīng)終端節(jié)點接入信息。單擊域名右側(cè)的復(fù)制獲取接入地址,單擊域名后的幫助按鈕查看對應(yīng)端口號。端口號的更多說明,請參見本文上方查看舊版公共實例終端節(jié)點信息中的端口號說明。
重要對于尊享型實例,MQTT接入域名需手動創(chuàng)建。具體內(nèi)容,請參見為尊享型實例創(chuàng)建獨立的MQTT接入域名。
設(shè)備使用HTTPS協(xié)議接入時,僅支持一機一密和一型一密預(yù)注冊方式,且使用的接入域名不同:
使用一機一密方式時,接入域名為HTTP頁簽下接入信息。
使用一型一密預(yù)注冊方式時,只有華東2(上海)地域支持,接入域名為
iot-auth.cn-shanghai.aliyuncs.com
。
如果歷史用戶已為企業(yè)版實例開啟ID2認(rèn)證,開發(fā)配置面板的管理ID2頁簽下ID2 認(rèn)證地址不可用。ID2認(rèn)證地址格式說明,請參見本文上方查看舊版公共實例終端節(jié)點信息。
為接入域名綁定固定IP
僅華東2(上海)、華北2(北京)、華南1(深圳)地域的標(biāo)準(zhǔn)型和尊享型企業(yè)版實例支持該功能。
固定IP的作用是物聯(lián)網(wǎng)平臺IP擴容時,不會改變您的域名解析。如果您是物聯(lián)網(wǎng)卡定向流量卡用戶,且運營商不支持配置域名時,可以添加固定IP到運營商定向流量IP列表中。
某些情況下,例如運營商機房搬遷導(dǎo)致原IP不可用時,不能保證您的IP不變。如果您的設(shè)備接入沒有使用接入域名而是使用固定IP,請通過云端下發(fā)或者OTA升級,同步新IP到設(shè)備,否則設(shè)備會無法正常連接物聯(lián)網(wǎng)平臺。
因此,建議您使用接入域名進行設(shè)備接入,物聯(lián)網(wǎng)平臺會提前通知您IP變更情況。
按照以下步驟,為實例的公網(wǎng)MQTT設(shè)備接入域名綁定固定IP。
對于非尊享型實例,可為MQTT設(shè)備接入分配2個固定IP。
在非尊享型實例下的實例詳情頁面,單擊右上角的查看開發(fā)配置。
在開發(fā)配置面板,單擊MQTT頁簽下固定IP右側(cè)的設(shè)置。
在彈出的對話框中單擊確定,可得到2個固定IP。
當(dāng)MQTT設(shè)備接入不再需要固定IP時,單擊解除綁定即可。
對于尊享型實例,手動創(chuàng)建MQTT公網(wǎng)接入域名后,已默認(rèn)為實例分配1個固定IP,您無需操作。不支持解除綁定。
為尊享型實例創(chuàng)建獨立的MQTT接入域名
按照以下步驟,為尊享型實例創(chuàng)建MQTT接入域名。
在尊享型實例下的實例詳情頁面,單擊右上角的查看開發(fā)配置。
在開發(fā)配置面板,單擊MQTT頁簽下的點擊創(chuàng)建。
在創(chuàng)建接入點對話框中,配置接入信息。
參數(shù)
說明
自定義端口
MQTT接入的端口號。默認(rèn)端口號為1883。
是否開啟VPC網(wǎng)絡(luò)
是:開啟VPC網(wǎng)絡(luò),需要配置專有網(wǎng)絡(luò)、交換機可用區(qū)、交換機和安全組。
此時會同時創(chuàng)建公網(wǎng)和VPC網(wǎng)絡(luò)的MQTT接入地址。
重要開啟VPC網(wǎng)絡(luò)的MQTT接入域名,需要開通專有網(wǎng)絡(luò)的私網(wǎng)連接(PrivateLink)服務(wù)。若當(dāng)前阿里云賬號未開通該服務(wù),需單擊開通,前往專有網(wǎng)絡(luò)管理控制臺,完成開通私網(wǎng)連接服務(wù)。
否(默認(rèn)):不開啟VPC網(wǎng)絡(luò)。
此時僅創(chuàng)建公網(wǎng)的MQTT接入地址。
重要如果選中否,后續(xù)無法再開啟VPC網(wǎng)絡(luò)。
授權(quán)
開啟VPC網(wǎng)絡(luò)時,需要完成授權(quán)。
單擊授權(quán),系統(tǒng)自動創(chuàng)建角色和授權(quán)策略,授權(quán)設(shè)備通過VPC網(wǎng)絡(luò)接入物聯(lián)網(wǎng)平臺。詳細(xì)說明,請參見服務(wù)關(guān)聯(lián)角色說明。
專有網(wǎng)絡(luò)
開啟VPC網(wǎng)絡(luò),并授權(quán)成功后,需配置該參數(shù)。
選擇當(dāng)前賬號下,已創(chuàng)建的專有網(wǎng)絡(luò)和交換機。
您可單擊創(chuàng)建專有網(wǎng)絡(luò)、創(chuàng)建交換機,新增專有網(wǎng)絡(luò)和交換機。具體操作,請參見創(chuàng)建專有網(wǎng)絡(luò)、創(chuàng)建交換機。
交換機可用區(qū)
交換機
安全組
開啟VPC網(wǎng)絡(luò),并授權(quán)成功后,需配置該參數(shù)。
選擇當(dāng)前賬號下,已創(chuàng)建的安全組。
您可單擊創(chuàng)建安全組,新增安全組。具體操作,請參見創(chuàng)建安全組。
單擊確認(rèn)。
等待接入域名創(chuàng)建完成后,MQTT設(shè)備接入下方顯示創(chuàng)建成功的接入域名。
為尊享型實例自定義MQTT接入證書
按照以下步驟,為尊享型實例自定義MQTT接入的證書和域名。
公網(wǎng)和VPC網(wǎng)絡(luò)接入地域復(fù)用同一張自定義證書。
在尊享型實例下的實例詳情頁面,單擊右上角的查看開發(fā)配置。
在開發(fā)配置面板,單擊MQTT頁簽下自定義證書的點擊配置。
在自定義證書對話框中,單擊自定義配置的開。
說明若已開啟自定義配置,忽略此步驟。
輸入從證書頒發(fā)機構(gòu)獲得的PEM格式的證書內(nèi)容和證書密鑰,單擊確定。
警告若已定義證書內(nèi)容和證書密鑰,更新證書信息后,證書校驗會異常,導(dǎo)致設(shè)備無法連接到物聯(lián)網(wǎng)平臺、用戶業(yè)務(wù)中斷。請謹(jǐn)慎操作。
頁面會顯示從自定義證書中解析出的自定義域名。您可使用自定義域名進行MQTT設(shè)備接入。
重要您需要在域名提供商配置CNAME,將自定義域名解析到實例默認(rèn)的MQTT接入域名。