全部产品
Search
文档中心

IoT Platform:Konfigurasikan langganan server AMQP

更新时间:Jul 02, 2025

IoT Platform memungkinkan Anda menggunakan grup konsumen untuk berlangganan pesan topik dan meneruskan pesan tersebut ke server Protokol Antrian Pesan Lanjutan (AMQP). Topik ini menjelaskan cara mengonfigurasi dan mengelola langganan sisi server AMQP di Konsol IoT Platform.

Prasyarat

Grup konsumen telah dibuat. Grup konsumen digunakan untuk berlangganan pesan dari topik. Anda dapat menggunakan grup konsumen default (DEFAULT_GROUP) atau membuat grup konsumen baru di IoT Platform. Untuk informasi lebih lanjut, lihat Kelola Grup Konsumen.

Konfigurasikan langganan

Untuk menentukan jenis pesan yang ingin dilanggan, ikuti langkah-langkah berikut:

  1. Masuk ke Konsol IoT Platform.

  2. Di halaman Overview, klik All environment. Di tab All environment, temukan instance yang ingin dikelola dan klik ID instance atau nama instance.

  3. Di panel navigasi sisi kiri, pilih Message Forwarding > Server-side Subscription.

  4. Di halaman Server-side Subscription, klik Create Subscription.

  5. Di kotak dialog Create Subscription, konfigurasikan parameter yang diperlukan dan klik OK. Tabel berikut menjelaskan parameter tersebut.

    Parameter

    Deskripsi

    Produk

    Pilih produk tempat perangkat-perangkat tersebut berada. Pesan-pesan yang dikirim oleh perangkat akan didorong ke konsumen.

    Tipe Langganan

    Pilih AMQP.

    Grup Konsumen

    Pilih grup konsumen. Anda dapat menentukan beberapa grup konsumen untuk satu produk dan membuat beberapa langganan untuk beberapa produk dalam satu grup konsumen.

    IoT Platform menyediakan grup konsumen default untuk mengonsumsi pesan. Jika Anda ingin mengelompokkan konsumen, lakukan langkah-langkah berikut untuk membuat grup konsumen: Di pojok kanan bawah kotak dialog Select Consumer Groups, klik Create Consumer Group dan konfigurasikan parameter sesuai petunjuk. Untuk informasi lebih lanjut, lihat Kelola grup konsumen.

    Tipe Pesan

    Pilih tipe-tipe pesan. Anda dapat berlangganan tipe-tipe pesan perangkat berikut. Untuk informasi lebih lanjut tentang topik komunikasi dasar, topik penerusan pesan, dan format data terkait, lihat Format data.

    Penting

    Jika Anda menggunakan produk dan perangkat gateway cloud, IoT Platform hanya mendorong pesan Device Upstream Notification, Device Status Change Notification, dan Device Changes Throughout Lifecycle ke produk dan perangkat tersebut. Untuk informasi lebih lanjut tentang topik penerusan pesan dan format data, lihat Pengiriman pesan melalui MQTT open source, Pengiriman pesan melalui JT/T 808, dan Pengiriman pesan melalui GB/T 32960.

    • Device Upstream Notification: pesan-pesan dalam topik yang parameter Allowed Operations-nya disetel ke Publish. Untuk informasi lebih lanjut, lihat Topik.

      Pesan-pesan tersebut mencakup data kustom dan data Thing Specification Language (TSL) yang dikirim oleh perangkat. Data TSL hulu mencakup data properti, data acara, respons terhadap permintaan pengaturan properti, dan respons terhadap panggilan layanan. Data TSL yang didorong ke server pengguna diproses oleh IoT Platform. Untuk informasi lebih lanjut, lihat Format data.

      Sebagai contoh, kategori topik berikut didefinisikan untuk sebuah produk:

      • /${YourProductKey}/${YourDeviceName}/user/get. Parameter Operasi yang Diizinkan untuk kategori topik ini disetel ke Berlangganan.

      • /${YourProductKey}/${YourDeviceName}/user/update. Parameter Operasi yang Diizinkan untuk kategori topik ini disetel ke Publikasikan.

      • /${YourProductKey}/${YourDeviceName}/thing/event/property/post. Parameter Operasi yang Diizinkan untuk kategori topik ini disetel ke Publikasikan.

      Fitur langganan sisi server mendorong pesan dari kategori topik berikut: /${YourProductKey}/${YourDeviceName}/user/update dan /${YourProductKey}/${YourDeviceName}/thing/event/property/post.

      Penting

      Jika Anda ingin berlangganan data respons dari panggilan layanan asinkron, pastikan ID pesan yang dikembalikan oleh perangkat sama dengan ID pesan yang dihasilkan ketika IoT Platform mengirimkan data hilir.

    • Device Status Change Notification: notifikasi yang dikirim oleh perangkat saat perangkat online atau offline.

    • Gateway's sub-devices discovery report: data sub-perangkat yang dikirimkan oleh gateway ketika gateway mendeteksi sub-perangkat baru. Gateway harus memiliki aplikasi yang dapat digunakan untuk mendeteksi sub-perangkat. Jenis pesan ini spesifik untuk gateway.

    • Device Topological Relation Changes: notifikasi yang dikirim oleh gateway saat hubungan topologis antara sub-perangkat dan gateway dibuat atau dihapus. Jenis pesan ini spesifik untuk gateway.

    • Device Changes Throughout Lifecycle: notifikasi yang dikirim oleh perangkat saat perangkat dibuat, dihapus, diaktifkan, atau dinonaktifkan.

    • TSL Historical Data Reporting: properti historis dan acara yang dikirimkan oleh perangkat.

    • OTA Update Status Notification: notifikasi yang dikirim oleh perangkat selama verifikasi firmware dan pembaruan massal. Saat tugas pembaruan perangkat berhasil, gagal, dibatalkan, atau sedang dilakukan, notifikasi akan didorong.

    • Device tag change: pesan-pesan yang dikirim oleh perangkat saat tag perangkat diubah.

    • Submit a module version number: pesan-pesan yang dikirim oleh perangkat saat nomor versi modul over-the-air (OTA) diubah.

    • Batch status notification: notifikasi yang dikirim oleh perangkat saat status batch pembaruan OTA berubah.

    Catatan

    Saat Anda mendengarkan pesan perangkat, Anda mungkin perlu memfilter atau memproses pesan tersebut. Dalam hal ini, Anda dapat meneruskan pesan ke grup konsumen AMQP dengan menggunakan aturan penerusan data. Kemudian, Anda dapat menerima pesan tersebut dengan menggunakan klien AMQP. Untuk informasi lebih lanjut, lihat Penerusan data.

    Untuk informasi lebih lanjut tentang cara meneruskan pesan ke server AMQP dan topik perangkat yang dapat Anda langgani, lihat Format data.

Kelola langganan produk

Setelah mengonfigurasi langganan, buka halaman Server-side Subscription dan temukan produk tempat langganan dibuat. Anda dapat melakukan beberapa operasi pada langganan tersebut. Tabel berikut menjelaskan operasi-operasi tersebut.

Operasi

Prosedur

Edit

Anda dapat mengubah grup konsumen dan tipe pesan.

  1. Klik Edit di kolom Actions.

  2. Di kotak dialog Edit Subscription, ubah parameter Consumer group atau Message Type.

  3. Klik Save.

Hapus

Peringatan

Jika data perangkat yang Anda langgani untuk produk tersebut digunakan di aplikasi lain, layanan Anda mungkin menjadi tidak tersedia atau bisnis Anda mungkin terpengaruh. Lanjutkan dengan hati-hati.

  1. Klik Delete di kolom Actions.

  2. Di pesan yang muncul, klik OK.

Apa yang harus dilakukan selanjutnya

Konfigurasikan Klien AMQP: Disarankan untuk menggunakan SDK AMQP yang disediakan oleh IoT Platform. Alibaba Cloud tidak memberikan dukungan teknis untuk SDK AMQP yang dikembangkan pengguna.

Catatan

Setelah konfigurasi selesai dan data perangkat yang dikirimkan diterima oleh klien AMQP, lakukan langkah-langkah berikut untuk melihat log di Konsol IoT Platform: Pilih Maintenance > Device Log > Cloud run log. Tab Log jalankan cloud menampilkan entri log yang dihasilkan saat perangkat mengirimkan data, IoT Platform meneruskan data ke klien AMQP, dan klien AMQP mengembalikan pesan ACK.