全部产品
Search
文档中心

ApsaraMQ for MQTT:Batas

更新时间:Jun 28, 2025

Topik ini menjelaskan batasan pada metrik tertentu di ApsaraMQ for MQTT. Untuk mencegah pengecualian pada aplikasi Anda, tentukan nilai yang valid untuk metrik ini saat menggunakan ApsaraMQ for MQTT. Tabel berikut menggambarkan batasan tersebut.

Jika Anda menggunakan instance ApsaraMQ for MQTT Enterprise Platinum Edition, Anda dapat menentukan nilai kustom untuk metrik tertentu yang dijelaskan dalam tabel berikut. Untuk menentukan nilai kustom untuk metrik, bergabunglah dengan grup DingTalk 116015007918 untuk menghubungi ApsaraMQ for MQTT dukungan teknis.

Instance

Item

Batas

Deskripsi

Nama instance

  • Nama instance harus memiliki panjang 3 hingga 64 karakter.

  • Nama instance dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Nama tidak peka huruf besar/kecil.

  • Nama instance harus unik di wilayah yang sama.

Saat membuat instance, Anda tidak dapat menentukan nama kustom untuk instance tersebut. Nama default dari instance baru adalah ID instance. Untuk mengubah nama instance, buka Konsol ApsaraMQ for MQTT.

TPS pesan per instance tunggal

Pembatasan dipicu berdasarkan spesifikasi yang dibeli. Jika ambang batas transaksi per detik (TPS) yang ditentukan terlampaui, masalah seperti pemutusan koneksi, waktu tanggapan habis, dan pembuangan pesan dapat terjadi pada SDK klien MQTT open source dan cloud SDK. Dalam hal ini, ApsaraMQ for MQTT tidak menjamin pengiriman pesan yang andal.

Klien ApsaraMQ for MQTT tunggal hanya mempublikasikan dan berlangganan sejumlah kecil pesan. SDK tertentu tidak mendukung TPS pesan besar. Kami merekomendasikan agar Anda menentukan maksimal 20 TPS pesan pada satu klien ApsaraMQ for MQTT. Jika Anda memerlukan TPS pesan lebih besar pada server cloud Anda, Anda dapat menggunakan klien ApsaraMQ for RocketMQ.

Jumlah klien ApsaraMQ for MQTT yang terhubung ke instance tunggal

Pembatasan dipicu berdasarkan spesifikasi yang dibeli. Jika ambang batas spesifikasi instance yang ditentukan terlampaui, permintaan untuk koneksi baru mungkin ditolak.

Jika jumlah maksimum klien ApsaraMQ for MQTT yang terhubung ke instance tunggal terlampaui, ApsaraMQ for MQTT secara otomatis mengirimkan peringatan. Kami merekomendasikan agar Anda menentukan ambang batas peringatan berdasarkan kebutuhan bisnis Anda.

Jumlah langganan dalam instance tunggal

Jika ambang batas yang ditentukan dalam spesifikasi terlampaui, Anda mungkin gagal membuat langganan baru, koneksi untuk langganan yang ada mungkin terputus, dan langganan yang ada mungkin tidak utuh.

Jika jumlah langganan dalam instance tunggal terlampaui, ApsaraMQ for MQTT secara otomatis mengirimkan peringatan. Kami merekomendasikan agar Anda menentukan ambang batas peringatan berdasarkan kebutuhan bisnis Anda.

Alamat IP dari nama domain yang digunakan sebagai titik akhir instance

Tidak ada.

Alamat IP dapat berubah secara tak terduga. Jangan asumsikan bahwa alamat IP tetap. Tim teknis ApsaraMQ for MQTT tidak bertanggung jawab atas kesalahan atau kerugian langsung atau tidak langsung dalam skenario berikut:

  • Anda menggunakan alamat IP alih-alih nama domain untuk mengakses broker ApsaraMQ for MQTT. Alamat IP asli menjadi tidak valid setelah tim teknis ApsaraMQ for MQTT memperbarui resolusi nama domain.

  • Kebijakan firewall pada alamat IP dikonfigurasi di jaringan tempat klien Anda berjalan. Setelah tim teknis ApsaraMQ for MQTT memperbarui resolusi nama domain, alamat IP baru diblokir karena kebijakan firewall.

Topik

Item

Batas

Deskripsi

Nama topik

  • Nama topik harus memiliki panjang 3 hingga 64 karakter.

    Catatan

    Panjang nama topik merujuk pada total panjang nama topik induk dan subtopiknya.

  • Nama topik dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Nama tidak peka huruf besar/kecil.

  • Nama topik induk harus unik dalam instance.

Saat Anda menggunakan ApsaraMQ for MQTT untuk mempublikasikan dan berlangganan pesan, nama topik harus berada dalam rentang panjang yang valid. Jika tidak, Anda tidak dapat mempublikasikan atau berlangganan pesan.

Jumlah topik induk pada instance tunggal

25

Jika nilai default tidak memenuhi kebutuhan bisnis Anda, bergabunglah dengan grup DingTalk 116015007918 untuk menghubungi ApsaraMQ for MQTT dukungan teknis.

Catatan

Tidak ada batasan yang diberlakukan pada jumlah subtopik. Kami merekomendasikan agar Anda membuat tidak lebih dari 1.000 subtopik untuk memastikan kelancaran operasi bisnis Anda.

Penggunaan lintas wilayah topik

Tidak didukung.

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

Klien

Item

Batas

Deskripsi

ID Klien

  • ID Klien tidak boleh melebihi 64 karakter.

  • ID Klien hanya dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_).

Saat menggunakan ApsaraMQ for MQTT untuk mempublikasikan dan berlangganan pesan, ID Klien tidak boleh melebihi 64 karakter. Jika tidak, klien akan terputus.

ID Grup

  • ID Grup harus memiliki panjang 7 hingga 64 karakter.

  • ID Grup hanya dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). Harus dimulai dengan GID_ atau GID-.

  • ID Grup harus unik dalam instance.

Saat menggunakan ApsaraMQ for MQTT untuk mempublikasikan dan berlangganan pesan, ID Grup harus berada dalam rentang panjang yang valid. Jika tidak, Anda tidak dapat mempublikasikan atau berlangganan pesan.

ID Perangkat

  • Panjang ID Perangkat bersifat dinamis. ID Klien berada dalam format <GroupID>@@@<DeviceID>. ID Klien tidak boleh melebihi 64 karakter.

  • ID Perangkat hanya dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_).

  • ID Perangkat harus unik dalam grup.

Saat menggunakan ApsaraMQ for MQTT untuk mempublikasikan dan berlangganan pesan, ID Perangkat tidak boleh melebihi 64 karakter. Jika tidak, klien akan terputus.

Jumlah topik yang dapat dilanggan oleh klien

30

Setiap klien dapat berlangganan hingga 30 topik secara bersamaan. Jika jumlah topik yang dilanggan mencapai 30, langganan baru tidak dapat ditambahkan. Jika Anda menggunakan instance ApsaraMQ for MQTT Enterprise Platinum Edition, Anda dapat meningkatkan jumlah maksimum topik yang dapat dilanggan oleh klien. Untuk meningkatkan jumlah, bergabunglah dengan grup DingTalk 116015007918 untuk menghubungi ApsaraMQ for MQTT dukungan teknis.

Jika topik dilanggan menggunakan langganan yang berisi wildcard (*), topik tersebut dihitung sebagai satu topik yang dilanggan. Jika subtopik yang berbeda dari topik induk yang sama dilanggan, setiap subtopik dihitung sebagai topik yang dilanggan. Sebagai contoh, A/# dihitung sebagai satu topik yang dilanggan. A/# dan A/a1/# dihitung sebagai dua topik yang dilanggan.

Jumlah langganan yang berisi wildcard (*)

Setiap topik induk mendukung hingga 100 langganan yang berisi wildcard (*).

Broker ApsaraMQ for MQTT mendukung sejumlah langganan aktif yang berisi wildcard (*) untuk setiap topik induk. Jika nilai maksimum terlampaui, broker ApsaraMQ for MQTT hanya memuat 100 langganan. Akibatnya, beberapa pelanggan mungkin gagal menerima pesan. Kami merekomendasikan agar Anda secara ketat mengontrol jumlah langganan yang berisi wildcard. Sebagai contoh, langganan ke A/#, A/a1, dan A/a2/# di bawah Parent Topic A yang sama dihitung sebagai tiga langganan.

Interval denyut jantung maksimum

8 menit

Saat menggunakan ApsaraMQ for MQTT untuk mempublikasikan dan berlangganan pesan, interval denyut jantung maksimum yang dapat Anda tentukan adalah 8 menit.

Aturan pemasukan pesan, pengeluaran pesan, dan notifikasi status klien

Item

Batas

Deskripsi

Jumlah aturan untuk instance tunggal

100

Jika nilai default tidak memenuhi kebutuhan bisnis Anda, bergabunglah dengan grup DingTalk 116015007918 untuk menghubungi ApsaraMQ for MQTT dukungan teknis.

Deduplikasi aturan

Hanya satu aturan dengan jenis yang sama yang dapat dibuat untuk setiap sumber daya internal.

Sebagai contoh, Anda hanya dapat membuat satu aturan untuk notifikasi status klien untuk setiap ID Grup, dan satu aturan pemasukan data dan satu aturan pengeluaran data untuk setiap topik di ApsaraMQ for MQTT.

Wilayah

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

Sebagai contoh, jika Anda membuat aturan pengeluaran data di mana sumber data ditentukan sebagai ApsaraMQ for MQTT di wilayah China (Hangzhou), Anda hanya dapat memilih instance ApsaraMQ for RocketMQ di wilayah China (Hangzhou) sebagai tujuan data.

Versi instance ApsaraMQ for MQTT

Anda hanya dapat membuat aturan untuk instance dengan versi kernel 3.x.x.

Anda dapat melihat versi kernel instance ApsaraMQ for MQTT di daftar instance atau di halaman Detail Instance di Konsol ApsaraMQ for MQTT.

Versi instance ApsaraMQ for RocketMQ

Hanya instance ApsaraMQ for RocketMQ 4.0 yang didukung.

Ketika Anda bertukar data antara ApsaraMQ for MQTT dan ApsaraMQ for RocketMQ dengan menggunakan aturan data arah masuk atau aturan data arah keluar, Anda hanya dapat menggunakan instance ApsaraMQ for RocketMQ 4.0.

Pesan

Item

Batas

Deskripsi

Ukuran pesan

64 KB

Jika ukuran pesan melebihi nilai maksimum, pesan tersebut dibuang.

Jika Anda menggunakan instance ApsaraMQ for MQTT Enterprise Platinum Edition, Anda dapat meningkatkan ukuran pesan maksimum. Untuk meningkatkan ukuran pesan maksimum, bergabunglah dengan grup DingTalk 116015007918 untuk menghubungi ApsaraMQ for MQTT dukungan teknis.

Periode retensi pesan

3 hari

ApsaraMQ for MQTT hanya menyimpan pesan offline jika parameter QoS disetel ke 1 dan parameter cleanSession disetel ke false. Pesan offline dapat disimpan hingga tiga hari dan secara otomatis dihapus setelah periode ini berakhir. Untuk informasi tentang parameter QoS dan cleanSession, lihat Istilah.

Jika Anda menggunakan instance ApsaraMQ for MQTT Enterprise Platinum Edition, Anda dapat meningkatkan periode retensi pesan. Untuk meningkatkan periode retensi pesan, bergabunglah dengan grup DingTalk 116015007918 untuk menghubungi ApsaraMQ for MQTT dukungan teknis.

Konfigurasi QoS dan cleanSession

Anda tidak dapat menyetel parameter QoS ke 2 dan parameter cleanSession ke false pada saat yang sama.

Saat Anda menggunakan ApsaraMQ for MQTT untuk mempublikasikan dan berlangganan pesan, Anda dapat menentukan konfigurasi berikut:

  • Jika parameter cleanSession disetel ke true, parameter QoS dapat disetel ke 0, 1, atau 2.

  • Jika parameter cleanSession disetel ke false, parameter QoS tidak dapat disetel ke 2. ApsaraMQ for MQTT tidak mendukung konfigurasi ini.

Masa berlaku token

30 hari

Saat Anda memanggil operasi ApplyToken, jika parameter ExpireTime disetel ke nilai lebih dari 30, token dikembalikan dan tidak ada kesalahan yang dilaporkan. Masa berlaku token ini tetap 30 hari.

Periode tunggu untuk pesan offline

Periode maksimum: 10 detik

Pertama kali broker ApsaraMQ for MQTT mendorong pesan, broker dapat menentukan apakah pesan tersebut dikonversi menjadi pesan offline hanya setelah pesan tersebut habis waktu atau gagal. Periode tunggu berkisar antara 5 detik hingga 10 detik.

Jumlah pesan offline yang disimpan

1.000.000

Broker ApsaraMQ for MQTT dari instance membatasi jumlah pesan offline yang disimpan di instance. Jika nilai maksimum terlampaui, broker ApsaraMQ for MQTT menghapus pesan offline yang tersimpan paling awal. Untuk mencegah jumlah pesan offline yang berlebihan, atur parameter cleanSession ke nilai yang sesuai saat Anda berlangganan topik.

Jika nilai default tidak memenuhi kebutuhan bisnis Anda, bergabunglah dengan grup DingTalk 116015007918 untuk menghubungi ApsaraMQ for MQTT dukungan teknis.