幫助中心

使用限制

更新時間：
Copy as MD

本文為您介紹雲Message QueueTT 版對某些具體指標的約束和規範，以便您在使用雲Message QueueTT 版時不要超過相應的限制值，以免程式出現異常。具體的限制項和限制值請參見下表。

如果您購買了企業鉑金版的雲Message QueueTT 版，則可按需定製部分指標（下表中已標出），諮詢定製請聯絡雲Message QueueTT 版支援人員，DingTalk群號：35228338。

表 1. 使用限制說明
限制項限制值說明
Topic長度64個字元使用雲Message QueueTT 版收發訊息時，Topic長度不得超過該限制，否則會導致無法發送或者訂閱。
Topic跨地區使用無雲Message QueueTT 版執行個體的Topic與該執行個體所綁定的後端訊息持久化執行個體，如雲訊息佇列 RocketMQ 版執行個體的Topic應處於同一地區。
Topic和Client ID可用字元僅限數字0-9，字母a-z或A-Z，和符號“-”、“_”Client ID和雲Message QueueTT 版的Topic不允許使用“/”、“:”、“,”、“%”等其他非常規字元，否則可能導致無法串連和收發訊息
Client ID長度64個字元使用雲Message QueueTT 版收發訊息時，Client ID長度不得超過該限制，否則會導致串連被斷開。
訊息大小64 KB訊息負載不得超過該限制，否則訊息會被丟棄（企業鉑金版可定製）。
訊息儲存時間3天目前僅當使用QoS1持久化Session時才會保留離線訊息，且最多保留3天，超過時間將自動滾動刪除（企業鉑金版可定製）。
使用者訊息收發TPS參考執行個體規格
  • 預付費執行個體會根據購買的規格進行限流，超過規格後將不保證訊息可靠到達。
  • 隨用隨付執行個體訊息TPS不超過5萬，否則可能會被系統限流，如有特殊需求，請聯絡雲Message QueueTT 版支援人員，DingTalk群號：35228338。
  • 在MQTT用戶端情境下，單MQTT用戶端訊息收發量一般不會很大，且某些SDK設計上不支援，建議單MQTT用戶端訊息TPS不超過20。如您所需的訊息收發量較大，且是服務端使用情境，請考慮使用雲訊息佇列 RocketMQ 版用戶端。
使用者串連數參考執行個體規格預付費執行個體會根據購買的規格進行限流，超過規格後將不保證串連穩定性。後付費執行個體不會限流，但會預設提供監控警示。請合理調整監控閾值。
使用者訂閱關係數參考執行個體規格預付費執行個體會根據購買的規格進行限流，超過規格後將不保證訂閱關係完整。後付費執行個體不會限流，但會預設提供監控警示。請合理調整監控閾值。
單個客訂閱Topic數量30個使用雲Message QueueTT 版收發訊息時，每個用戶端最多允許同時訂閱30個Topic，超過該限制會導致無法新增新的訂閱關係（企業鉑金版可定製）。
QoS和cleanSession目前不支援QoS2的持久Session使用雲Message QueueTT 版收發訊息時，服務端目前不支援QoS2方式的持久化Session訂閱。如果需要接收離線訊息，請使用QoS1方式的持久化Session訂閱。
Token有效期間30天調用申請Token介面時，如果ExpireTime的取值大於30天，介面仍然調用成功返回Token，無報錯，但實際有效期間即為30天。
訊息順序性上行順序使用雲Message QueueTT 版收發訊息時，目前只保證每個用戶端發送訊息的順序性，如果消費訊息需要順序，需要使用雲訊息佇列 RocketMQ 版TCP方式接收訊息。
離線訊息可見時間10秒服務端首次推送訊息後必須要等待逾時或者失敗後才能確認該訊息是否轉化為離線訊息，對應的延遲時間通常是5秒~10秒。
離線訊息儲存數量1,000,000條服務端會限制每個執行個體儲存的離線訊息數量。超過該限制後，服務端會從最早的訊息開始清理。因此，請合理使用持久化訂閱模式，以免產生很多無用的離線訊息。

如果預設限制不滿足，請聯絡雲Message QueueTT 版支援人員，DingTalk群號：35228338。

萬用字元訂閱關係數量每個父級Topic下僅允許100個萬用字元訂閱關係。服務端會限制每個父級Topic生效的萬用字元訂閱關係的數量，超過限制後服務端會只載入100個，可能會造成部分訂閱的用戶端收不到訊息。請嚴格控制數量。
雲Message QueueTT 版網域名稱存取點對應的IP地址無
該IP地址隨時可能更換，請勿假設IP地址固定。在以下使用方式中出現的問題雲Message QueueTT 版產品方概不負責：
  • 用戶端不使用網域名稱接入而是使用IP地址接入，產品方更新了網域名稱解析導致原有IP地址失效。
  • 用戶端網路對IP地址設定網路防火牆策略，產品方更新了網域名稱解析後新IP地址被您的防火牆策略攔截。