全部產品
Search
文件中心

ApsaraMQ for MQTT:參數說明

更新時間:Dec 27, 2024

本文介紹雲Message QueueTT 版雲端Go SDK的參數說明。

公用參數

參數

說明

domain

雲Message QueueTT 版執行個體的存取點。用戶端通過存取點串連雲Message QueueTT 版服務端。

使用雲端SDK接入雲Message QueueTT 版時,需要填寫的存取點格式如下:

重要

僅執行個體地區屬於中國內地的執行個體支援雲端SDK接入。

  • 公网接入点MQTT執行個體ID-server-internet.mqtt.aliyuncs.com

  • VPC 接入点MQTT執行個體ID-server-internal.mqtt.aliyuncs.com

MQTT執行個體ID可在雲Message QueueTT 版控制台執行個體詳情頁面的基础信息地區查看。

port

協議連接埠。連接埠和使用的協議必須匹配,雲端SDK中,該參數值固定為5672。

instanceId

您在雲Message QueueTT 版控制台建立的執行個體的ID。可在雲Message QueueTT 版控制台实例详情頁面查看。

accessKey

您在阿里雲帳號管理主控台中建立的AccessKey ID,用於身份認證。擷取方式,請參見擷取AccessKey

secretKey

您在阿里雲帳號管理主控台中建立的AccessKey Secret,用於身份認證。擷取方式,請參見擷取AccessKey。僅在Signature鑒權模式下需要設定。

訊息發送

表 1. 訊息發送參數

參數

說明

mqttTopic

雲Message QueueTT 版的Topic,包括父級Topic和子級Topic。

其中父級Topic需要在雲Message QueueTT 版控制台建立。子級Topic無需建立,直接在代碼中定義。更多資訊,請參見基本概念

重要

如果使用了未建立或未授權的Topic,會導致用戶端鑒權失敗,雲Message QueueTT 版服務端斷開用戶端的串連。

訊息訂閱

表 2. 訊息訂閱參數

參數

說明

firstTopic

您在雲Message QueueTT 版控制台建立的父級Topic。更多資訊,請參見基本概念

重要
  • 如果使用了未建立或未授權的Topic,會導致用戶端鑒權失敗,雲Message QueueTT 版服務端斷開用戶端的串連。

  • 由於雲端SDK訂閱訊息一般用於雲上應用進行訊息匯總和分析等情境,因此,雲端SDK訂閱訊息不支援設定子級Topic。

裝置上下線事件

表 3. 裝置上下線事件參數

參數

說明

gid

您在雲Message QueueTT 版控制台建立的Group的ID。更多資訊,請參見基本概念