全部產品
Search
文件中心

IoT Platform:查看和配置執行個體終端節點資訊(Endpoint)

更新時間:Jun 30, 2024

開發裝置端SDK、雲端SDK和AMQP SDK時,接入網域名稱需配置為執行個體對應的終端節點。本文介紹如何擷取執行個體下對應終端節點的接入資訊。

前提條件

  • 不同SDK的開發指導,請參見裝置端SDK雲端SDKAMQP用戶端接入說明

  • 不同類型執行個體的概念和對比,請參見執行個體概述

    執行個體

    地區

    說明

    查看方法

    舊版公用執行個體

    華東2(上海)、日本(東京)、新加坡、德國(法蘭克福)、美國(矽谷)、美國(維吉尼亞)

    在物聯網平台控制台執行個體概覽頁面,執行個體ID不顯示具體值。

    在物聯網平台控制台不顯示開發配置資訊,本文匯總各終端節點資訊。具體資訊,請參見查看舊版公用執行個體終端節點資訊

    新版公用執行個體

    • 在物聯網平台控制台執行個體概覽頁面,執行個體ID顯示具體值,執行個體下有執行個體詳情頁面。

    • 新開通物聯網平台服務,預設為新版公用執行個體。

    在物聯網平台控制台顯示開發配置資訊。具體資訊,請參見查看新版公用執行個體和企業版執行個體終端節點資訊

    企業版執行個體

    華東2(上海)、華北2(北京)、華南1(深圳)、日本(東京)、新加坡、德國(法蘭克福)、美國(矽谷)、美國(維吉尼亞)

背景資訊

  • 網域名稱類型

    • 分為公網網域名稱VPC網路網域名稱,使用內網網域名稱可以降低網路時延、節省公網流量費用、提高串連的安全性和穩定性。

    • 裝置接入物聯網平台:MQTT、CoAPHTTP。尊享型企業版執行個體支援掛載VPC網路,配置完成後裝置可通過VPC網路接入物聯網平台,裝置可使用MQTT協議的VPC網路網域名稱。

    • 使用者使用AMQP服務端訂閱、調用雲端API。對於Virtual Private Cloud內的ECS執行個體,使用者調用雲端API或使用AMQP服務端訂閱時,可以配置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

  • 使用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

僅支援日本(東京)地區。

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

固定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接入網域名稱。