Sebelum menggunakan SDK ApsaraMQ for MQTT untuk mengirim dan menerima pesan, Anda harus membuat resource terkait—seperti instans, topik, dan grup—di konsol ApsaraMQ for MQTT. Setiap resource tersebut dipetakan ke parameter dalam konfigurasi client Anda.
Prasyarat
Sebelum memulai, pastikan Anda telah:
Langkah 1: Buat instans
Instans adalah mesin virtual yang menyimpan topik dan grup Anda serta menyediakan titik akhir (endpoint) yang digunakan oleh client SDK untuk terhubung.
Masuk ke konsol ApsaraMQ for MQTT. Di panel navigasi sebelah kiri, klik Instances.
Di bilah navigasi atas, pilih wilayah. Di pojok kiri atas, klik Create Instance.
Di panel yang muncul, pertahankan metode penagihan Subscription sebagai default dan klik OK.
Di halaman pembelian, pilih spesifikasi instans sesuai kebutuhan Anda, terima syarat layanan, lalu klik Buy Now. Untuk perbandingan edisi yang tersedia beserta fiturnya, lihat Instance editions.
Selesaikan pembayaran di halaman pesanan.
Setelah pembayaran selesai, klik Console untuk kembali ke konsol ApsaraMQ for MQTT.
Langkah 2: Dapatkan endpoint instans
Endpoint adalah URL koneksi yang digunakan oleh client SDK untuk mengakses instans. Nilai ini diperlukan saat Anda mengonfigurasi messaging dalam kode.
Di konsol ApsaraMQ for MQTT, buka Instances dan pilih wilayah tempat instans Anda dideploy.
Klik nama instans, atau klik Details di kolom Actions, untuk membuka halaman Instance Details.
Klik tab Endpoints. Temukan dan salin public endpoint.

Langkah 3: Buat topik
Topik adalah saluran pesan yang digunakan oleh produsen dan subscriber untuk bertukar pesan. Protokol MQTT mendukung topik multi-level yang diorganisir secara hirarkis dengan pemisah garis miring maju (/).
Parent topics harus dibuat di konsol.
Subtopics ditentukan langsung dalam kode Anda dan tidak perlu dibuat di konsol.
Format penamaan topik: <parent-topic>/<level-2-topic>/<level-3-topic>
Contoh: SendMessage/demo/producer
Panjang gabungan parent topic dan semua level subtopic tidak boleh melebihi 64 karakter. Untuk detail lebih lanjut mengenai struktur topik, lihat Terms.
Untuk membuat topik induk:
Di halaman Instance Details, klik Topics di panel navigasi sebelah kiri.
Di pojok kiri atas halaman Topics, klik Create Topic.
Di panel Create Topic, masukkan Name (misalnya,
SendMessage) dan Description, lalu klik OK.
Langkah 4: Buat grup
Grup digunakan untuk mengelola client MQTT Anda. Untuk detail selengkapnya, lihat Terms.
Di halaman Instance Details, klik Groups di panel navigasi sebelah kiri.
Di pojok kiri atas halaman Groups, klik Create Group.
Di panel Create Group, masukkan Group ID (misalnya,
GID_demo) lalu klik OK.
Verifikasi konfigurasi Anda
Setelah membuat resource, pastikan item berikut siap untuk integrasi SDK:
| Resource | Lokasi | Digunakan dalam kode SDK sebagai |
|---|---|---|
| Instance endpoint | Instance Details > tab Endpoints | Connection URL |
| Parent topic | Instance Details > Topics | Parameter topik dalam panggilan publish/subscribe |
| Group ID | Instance Details > Groups | Parameter Group ID dalam konfigurasi client |
Langkah selanjutnya
Dengan instans, topik, dan grup yang telah disiapkan, mulailah membangun alur kerja messaging: