限制項

限制值

說明

實例名稱

• 名稱長度：3~64個字符

• 可用字符：僅限數字0~9、字母a~z或A~Z、短劃線（-）和下劃線（_），大小寫不敏感。

• 唯一性：同一地域下實例名稱必須唯一。

創建實例時不支持自定義實例名稱，新創建實例的名稱默認和實例ID一致，您可以在云消息隊列 MQTT 版控制臺修改。

單實例消息收發TPS

根據購買的規格進行限流，云消息隊列 MQTT 版消息收發TPS超過規格上限后，客戶端（包含開源MQTT客戶端和云端SDK）可能會出現連接斷開、響應超時和消息丟棄等情況，不保證消息可靠到達。

在MQTT客戶端場景下，單MQTT客戶端消息收發量一般不會很大，且某些SDK設計上不支持，建議單MQTT客戶端消息TPS不超過20。如您所需的消息收發量較大，且是服務端使用場景，請考慮使用云消息隊列 RocketMQ 版客戶端。

單實例在線連接數

根據購買的規格進行限流，超過規格上限后新建連接可能被拒絕。

云消息隊列 MQTT 版會默認提供在線用戶連接數的監控報警。請合理調整監控閾值。

單實例訂閱關系數

當訂閱數超過規格限制后，新增的訂閱可能會失敗，訂閱關系對應的客戶端連接可能會斷開，且不保證訂閱關系完整。

云消息隊列 MQTT 版會默認提供訂閱關系數的監控報警。請合理調整監控閾值。

實例域名接入點對應的IP地址

無

該IP地址隨時可能更換，請勿假設IP地址固定。在以下使用情況中出現的問題云消息隊列 MQTT 版產品方概不負責：

• 客戶端不使用域名接入而是使用IP地址接入，產品方更新了域名解析導致原有IP地址失效。

• 客戶端網絡對IP地址設置網絡防火墻策略，產品方更新了域名解析后新IP地址被您的防火墻策略攔截。

限制項

限制值

說明

Topic名稱

• 名稱長度：3~64個字符

  說明

  這里的Topic長度指的是父級Topic和子級Topic的總長度。

• 可用字符：僅限數字0~9、字母a~z或A~Z、短劃線（-）和下劃線（_），大小寫不敏感。

• 唯一性：同一實例下父級Topic名稱必須唯一。

使用云消息隊列 MQTT 版收發消息時，Topic長度不得低于或超過最值限制，否則會導致無法發送或者訂閱。

單實例父級Topic數量

25個

如果默認限制不滿足，請聯系云消息隊列 MQTT 版技術支持，釘釘群號：35228338。

Topic跨地域使用

不支持

云消息隊列 MQTT 版配置了相關規則實現與云消息隊列 RocketMQ 版的數據互通，則相關資源應處于同一地域。

限制項

限制值

說明

Client ID

• 名稱長度：不超過64個字符

• 可用字符：僅限數字0~9、字母a~z或A~Z、短劃線（-）和下劃線（_）。

使用云消息隊列 MQTT 版收發消息時，Client ID不得超過限制，否則會導致連接被斷開。

Group ID

• 名稱長度：7~64個字符

• 可用字符：僅限數字0~9、字母a~z或A~Z、短劃線（-）和下劃線（_），且必須以“GID_”或者“GID-”開頭。

• 唯一性：同一實例下Group ID必須唯一。

使用云消息隊列 MQTT 版收發消息時，Group ID長度不得低于或超過最值限制，否則會導致無法發送或者訂閱。

Device ID

• 名稱長度：Client ID格式為：<GroupID>@@@<DeviceID>，Device ID的長度限制為動態值，您需要保證總的Client ID長度不超過64個字符。

• 可用字符：僅限數字0~9、字母a~z或A~Z、短劃線（-）和下劃線（_）。

• 唯一性：同一Group ID下的Device ID必須唯一。

使用云消息隊列 MQTT 版收發消息時，Device ID不得超過限制，否則會導致連接被斷開。

單個客戶端訂閱Topic數量

30個

每個客戶端最多允許同時訂閱30個Topic，超過該限制會導致無法新增新的訂閱關系。鉑金版實例可支持定制，如需定制，請聯系云消息隊列 MQTT 版技術支持，釘釘群號：35228338。

計算訂閱Topic數量時，一個包含通配符的訂閱計算為一個訂閱數量；同一父級Topic下不同子級的Topic訂閱被計算為不同的Topic數量。例如：A/#被計算為一個訂閱數量。A/#和A/a1/#被計算為2個Topic訂閱數量。

通配符訂閱關系數量

每個父級Topic下僅允許100個通配符訂閱關系。

服務端會限制每個父級Topic生效的通配符訂閱關系的數量，超過限制后服務端會只加載100個，可能會造成部分訂閱的客戶端收不到消息。請嚴格控制數量。例如：對于同一個父級Topic A，訂閱的A/#和A/a1/#以及A/a2/#計算為3個訂閱關系數量。

心跳最大時間間隔

8分鐘

使用云消息隊列 MQTT 版收發消息時，支持的最大心跳時間間隔為8分鐘。

限制項

限制值

說明

消息大小

64 KB

消息負載不得超過該限制，否則消息會被丟棄。

鉑金版實例可支持定制。如需定制，請聯系云消息隊列 MQTT 版技術支持，釘釘群號：35228338。

消息保存時間

3天

僅當QoS=1且cleanSession=false時，云消息隊列 MQTT 版才會保留離線消息，且最多保留3天，超過時間將自動滾動刪除。Qos和cleanSession的詳細信息，請參見名詞解釋。

鉑金版實例可支持定制，如需定制，請聯系云消息隊列 MQTT 版技術支持，釘釘群號：35228338。

QoS和cleanSession

不支持QoS=2且cleanSession=false的配置

使用云消息隊列 MQTT 版收發消息時：

• 如果cleanSession=true，那么QoS可以設置為0、1或2。

• 如果cleanSession=false，那么QoS不可設置為2，云消息隊列 MQTT 版暫不支持該配置。

Token有效期

30天

調用申請Token接口時，如果ExpireTime的取值大于30天，接口仍然調用成功返回Token，無報錯，但實際有效期仍為30天。

離線消息可見時間

10秒

服務端首次推送消息后必須要等待超時或者失敗后才能確認該消息是否轉化為離線消息，對應的延遲時間通常是5秒~10秒。

離線消息存儲數量

100萬條

服務端會限制每個實例存儲的離線消息數量。超過該限制后，服務端會從最早的消息開始清理。因此，請合理使用持久化訂閱模式，以免產生過多無用的離線消息。

如果默認限制不滿足，請聯系云消息隊列 MQTT 版技術支持，釘釘群號：35228338。