全部产品
Search
文档中心

ApsaraMQ for MQTT:Batasan

更新时间:Nov 09, 2025

Topik ini menjelaskan batasan dan spesifikasi untuk metrik tertentu dalam ApsaraMQ for MQTT. Saat menggunakan ApsaraMQ for MQTT, jangan melebihi batasan ini untuk menghindari terjadinya pengecualian program. Tabel berikut memberikan detail lebih lanjut tentang batasan-batasan tersebut.

Jika Anda membeli instans Edisi Platinum dari ApsaraMQ for MQTT, Anda dapat menyesuaikan beberapa metrik. Metrik-metrik ini ditandai dalam tabel di bawah ini. Untuk meminta penyesuaian, hubungi ApsaraMQ for MQTT dukungan teknis di grup DingTalk 116015007918.

Batasan Instans

Keterbatasan

Batas

Deskripsi

Nama Instans

  • Panjang: 3 hingga 64 karakter

  • Karakter yang diizinkan: digit (0-9), huruf (a-z, A-Z), tanda hubung (-), dan garis bawah (_). Nama tidak peka huruf besar/kecil.

  • Keunikan: Nama instans harus unik dalam wilayah yang sama.

Anda tidak dapat menentukan nama kustom saat membuat instans. Secara default, nama instans baru sama dengan ID instansnya. Anda dapat mengubah nama di Konsol ApsaraMQ for MQTT.

TPS pesan per instans tunggal

Pembatasan didasarkan pada spesifikasi yang dibeli. Jika transaksi pesan per detik (TPS) dari ApsaraMQ for MQTT melebihi batas spesifikasi Anda, masalah seperti pemutusan koneksi, waktu tanggapan habis, dan pembuangan pesan mungkin terjadi pada klien. Ini berlaku untuk klien seperti klien MQTT sumber terbuka dan kit pengembangan perangkat lunak (SDK) cloud. Dalam hal ini, pengiriman pesan yang andal tidak dijamin.

Sebuah klien MQTT tunggal biasanya tidak menangani volume pesan yang besar, dan beberapa SDK tidak dirancang untuk throughput tinggi. TPS pesan untuk klien MQTT tunggal seharusnya tidak melebihi 20. Jika Anda memerlukan volume pesan yang lebih tinggi untuk aplikasi sisi server, pertimbangkan untuk menggunakan klien ApsaraMQ for RocketMQ.

Jumlah koneksi online untuk instans tunggal

Pembatasan didasarkan pada spesifikasi yang dibeli. Jika jumlah koneksi melebihi batas, permintaan koneksi baru mungkin ditolak.

Secara default, ApsaraMQ for MQTT menyediakan alarm pemantauan untuk jumlah koneksi online. Anda dapat menyesuaikan ambang pemantauan sesuai kebutuhan.

Jumlah hubungan langganan untuk instans tunggal

Jika jumlah langganan melebihi batas spesifikasi, langganan baru mungkin gagal. Koneksi klien yang sesuai mungkin terputus, dan integritas hubungan langganan tidak dapat dijamin.

Secara default, ApsaraMQ for MQTT menyediakan alarm pemantauan untuk jumlah hubungan langganan. Anda dapat menyesuaikan ambang pemantauan sesuai kebutuhan.

Alamat IP yang sesuai dengan titik akhir instans

Tidak ada

Alamat IP ini dapat berubah sewaktu-waktu. Jangan melakukan hardcode alamat IP. Tim produk ApsaraMQ for MQTT tidak bertanggung jawab atas masalah yang terjadi dalam situasi berikut:

  • Klien terhubung menggunakan alamat IP bukan nama domain, dan alamat IP asli menjadi tidak valid setelah pembaruan resolusi nama domain.

  • Kebijakan firewall pada jaringan klien Anda disetel untuk alamat IP, dan alamat IP baru diblokir oleh firewall Anda setelah pembaruan resolusi nama domain.

Batasan Topik

Pembatasan

Batas

Deskripsi

Nama Topik

  • Panjang: 3 hingga 64 karakter

    Catatan

    Panjang topik merujuk pada panjang total topik induk dan sub-topiknya.

  • Karakter yang diizinkan: digit (0-9), huruf (a-z, A-Z), tanda hubung (-), dan garis bawah (_). Nama tidak peka huruf besar/kecil.

  • Keunikan: Nama topik induk harus unik dalam instans yang sama.

Saat Anda mengirim dan menerima pesan menggunakan ApsaraMQ for MQTT, panjang topik harus berada dalam batas yang ditentukan. Jika tidak, Anda tidak dapat mengirim atau berlangganan pesan.

Jumlah topik induk untuk instans tunggal

25

Jika batas default tidak memenuhi kebutuhan Anda, hubungi ApsaraMQ for MQTT dukungan teknis di grup DingTalk 116015007918.

Penggunaan lintas wilayah topik

Tidak didukung

Jika Anda mengonfigurasi aturan untuk pertukaran data antara ApsaraMQ for MQTT dan ApsaraMQ for RocketMQ, sumber daya terkait harus berada di wilayah yang sama.

Batasan Klien

Batasan

Batas

Deskripsi

ID Klien

  • Panjang: Hingga 64 karakter

  • Karakter yang diizinkan: digit (0-9), huruf (a-z, A-Z), tanda hubung (-), dan garis bawah (_).

Saat Anda mengirim dan menerima pesan menggunakan ApsaraMQ for MQTT, ID Klien tidak boleh melebihi batas panjang. Jika tidak, koneksi akan terputus.

ID Grup

  • Panjang: 7 hingga 64 karakter

  • Karakter yang diizinkan: digit (0-9), huruf (a-z, A-Z), tanda hubung (-), dan garis bawah (_). ID harus dimulai dengan "GID_" atau "GID-".

  • Keunikan: ID Grup harus unik dalam instans yang sama.

Saat Anda mengirim dan menerima pesan menggunakan ApsaraMQ for MQTT, panjang ID Grup harus berada dalam batas yang ditentukan. Jika tidak, Anda tidak dapat mengirim atau berlangganan pesan.

ID Perangkat

  • Panjang: Format ID Klien adalah <GroupID>@@@<DeviceID>. Batas panjang untuk ID Perangkat bersifat dinamis. Anda harus memastikan bahwa panjang total ID Klien tidak melebihi 64 karakter.

  • Karakter yang diizinkan: digit (0-9), huruf (a-z, A-Z), tanda hubung (-), dan garis bawah (_).

  • Keunikan: ID Perangkat harus unik dalam ID Grup yang sama.

Saat Anda mengirim dan menerima pesan menggunakan ApsaraMQ for MQTT, ID Klien tidak boleh melebihi batas panjang. Jika tidak, koneksi akan terputus.

Jumlah topik yang dapat dilanggan oleh klien

30

Setiap klien dapat berlangganan maksimal 30 topik secara bersamaan. Jika batas ini dilampaui, permintaan langganan baru gagal. Instans Edisi Platinum mendukung penyesuaian. Untuk meminta penyesuaian, hubungi ApsaraMQ for MQTT dukungan teknis di grup DingTalk 116015007918.

Saat Anda menghitung jumlah topik yang dilanggan, langganan yang berisi karakter wildcard dihitung sebagai satu langganan. Langganan ke sub-topik yang berbeda di bawah topik induk yang sama dihitung sebagai langganan terpisah. Misalnya, A/# dihitung sebagai satu langganan, dan A/# dan A/a1/# dihitung sebagai dua langganan.

Jumlah hubungan langganan wildcard

Maksimum 100 hubungan langganan wildcard diperbolehkan untuk setiap topik induk.

Layanan membatasi jumlah hubungan langganan wildcard aktif untuk setiap topik induk. Jika batas ini dilampaui, layanan hanya memuat 100 hubungan. Hal ini dapat menyebabkan beberapa klien yang dilanggan tidak menerima pesan. Anda harus mengontrol jumlah hubungan dengan ketat. Misalnya, untuk topik induk yang sama A, langganan ke A/#, A/a1/#, dan A/a2/# dihitung sebagai tiga hubungan langganan.

Interval heartbeat maksimum

8 menit

Saat mengirim dan menerima pesan dengan ApsaraMQ for MQTT, interval heartbeat maksimum adalah 8 menit.

Batasan aliran data dan aturan status klien

Batasan

Batas

Deskripsi

Jumlah aturan per instans

100

Jika batas default tidak memenuhi kebutuhan Anda, hubungi ApsaraMQ for MQTT dukungan teknis di grup DingTalk 116015007918.

Deduplikasi aturan

Untuk sumber daya internal yang sama, Anda hanya dapat membuat satu aturan dari setiap jenis.

Sebagai contoh, Anda hanya dapat membuat satu aturan notifikasi online/offline untuk ID Grup, dan hanya satu aturan data masuk dan satu aturan data keluar untuk topik MQTT.

Batasan wilayah

Anda tidak dapat membuat aturan lintas wilayah. Instans sumber data dan tujuan data untuk suatu aturan harus berada di wilayah yang sama.

Sebagai contoh, jika Anda membuat aturan data keluar dan instans ApsaraMQ for MQTT sumber berada di wilayah China (Hangzhou), Anda hanya dapat memilih instans ApsaraMQ for RocketMQ di wilayah China (Hangzhou) sebagai tujuan data.

Versi instans ApsaraMQ for MQTT

Hanya instans ApsaraMQ for MQTT versi 3.x.x yang mendukung fitur ini.

Hanya instans ApsaraMQ for MQTT versi 3.x.x yang dapat dibeli.

Versi instans ApsaraMQ for RocketMQ

Hanya seri 4.0 yang didukung.

Saat ApsaraMQ for MQTT dan ApsaraMQ for RocketMQ bertukar data melalui aturan data masuk atau data keluar, hanya instans seri 4.0 ApsaraMQ for RocketMQ yang mendukung aturan ini. Seri 5.0 tidak didukung.

Batasan pengiriman dan penerimaan pesan

Catatan

ApsaraMQ for MQTT tidak mendukung pesan wasiat terakhir atau pesan yang disimpan.

Batasan

Batas

Deskripsi

Ukuran pesan

64 KB

Muatan pesan tidak boleh melebihi batas ini. Jika tidak, pesan akan dibuang.

Instans Edisi Platinum mendukung penyesuaian. Untuk meminta penyesuaian, hubungi ApsaraMQ for MQTT dukungan teknis di grup DingTalk 116015007918.

Periode retensi pesan

3 hari

ApsaraMQ for MQTT hanya menyimpan pesan offline saat QoS=1 dan cleanSession=false. Pesan disimpan maksimal selama 3 hari dan secara otomatis dihapus oleh pengguliran otomatis setelah periode ini. Untuk informasi lebih lanjut tentang Quality of Service (QoS) dan cleanSession, lihat Glosarium.

Instans Edisi Platinum mendukung penyesuaian. Untuk meminta penyesuaian, hubungi ApsaraMQ for MQTT dukungan teknis di grup DingTalk 116015007918.

QoS dan cleanSession

  • Konfigurasi QoS dan cleanSession hanya didukung oleh SDK sisi klien, bukan oleh SDK sisi server.

  • Konfigurasi berikut tidak didukung:

    • QoS=2 dan cleanSession=false

    • QoS=0 dan cleanSession=false

Saat Anda mengirim dan menerima pesan menggunakan ApsaraMQ for MQTT:

  • Jika cleanSession=true, Anda dapat mengatur QoS ke 0, 1, atau 2.

  • Jika cleanSession=false, Anda tidak dapat mengatur QoS ke 2 atau 0. ApsaraMQ for MQTT tidak mendukung konfigurasi ini.

Periode validitas token

30 hari

Saat Anda memanggil operasi untuk mengajukan token, jika nilai ExpireTime lebih besar dari 30 hari, operasi tetap berhasil dan mengembalikan token tanpa kesalahan. Namun, periode validitas aktual tetap 30 hari.

Waktu visibilitas pesan offline

10 detik

Setelah layanan mendorong pesan untuk pertama kali, ia harus menunggu timeout atau kegagalan untuk memastikan apakah pesan tersebut dikonversi menjadi pesan offline. Latensi yang sesuai biasanya 5 hingga 10 detik.

Jumlah pesan offline yang disimpan

1 juta

Layanan membatasi jumlah pesan offline yang disimpan untuk setiap instans. Jika batas ini dilampaui, layanan mulai membersihkan pesan dari yang paling awal. Oleh karena itu, gunakan pola langganan persisten secara wajar untuk menghindari menghasilkan terlalu banyak pesan offline yang tidak berguna.

Jika batas default tidak memenuhi kebutuhan Anda, hubungi ApsaraMQ for MQTT dukungan teknis di grup DingTalk 116015007918.

Jumlah percobaan ulang pengiriman pesan

  • Konsumsi sisi klien

    • Saat QoS=1: 16 kali

    • Saat QoS=2: 16 kali

  • Konsumsi sisi server

    10 kali

Jumlah maksimum percobaan ulang yang dilakukan layanan ApsaraMQ for MQTT saat konsumen gagal menerima pesan atau konsumsi gagal.

Batasan API Cloud

Untuk informasi tentang batasan permintaan per detik (QPS) pada panggilan API cloud, lihat Batasan QPS.