All Products
Search
Document Center

ApsaraMQ for MQTT:Buat resource

Last Updated:Mar 11, 2026

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.

  1. Masuk ke konsol ApsaraMQ for MQTT. Di panel navigasi sebelah kiri, klik Instances.

  2. Di bilah navigasi atas, pilih wilayah. Di pojok kiri atas, klik Create Instance.

  3. Di panel yang muncul, pertahankan metode penagihan Subscription sebagai default dan klik OK.

  4. 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.

  5. Selesaikan pembayaran di halaman pesanan.

  6. 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.

  1. Di konsol ApsaraMQ for MQTT, buka Instances dan pilih wilayah tempat instans Anda dideploy.

  2. Klik nama instans, atau klik Details di kolom Actions, untuk membuka halaman Instance Details.

  3. Klik tab Endpoints. Temukan dan salin public endpoint.

    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:

  1. Di halaman Instance Details, klik Topics di panel navigasi sebelah kiri.

  2. Di pojok kiri atas halaman Topics, klik Create Topic.

  3. 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.

  1. Di halaman Instance Details, klik Groups di panel navigasi sebelah kiri.

  2. Di pojok kiri atas halaman Groups, klik Create Group.

  3. 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:

ResourceLokasiDigunakan dalam kode SDK sebagai
Instance endpointInstance Details > tab EndpointsConnection URL
Parent topicInstance Details > TopicsParameter topik dalam panggilan publish/subscribe
Group IDInstance Details > GroupsParameter Group ID dalam konfigurasi client

Langkah selanjutnya

Dengan instans, topik, dan grup yang telah disiapkan, mulailah membangun alur kerja messaging: