Topik merupakan konstruk utama untuk perutean pesan di ApsaraMQ for RocketMQ. Dalam model publish/subscribe (pub/sub), produsen mengirim pesan ke suatu topik, sedangkan konsumen berlangganan ke topik tersebut untuk menerimanya. Kelompokkan topik berdasarkan domain bisnis—misalnya, satu topik untuk event pesanan, satu untuk pembaruan logistik, dan satu lagi untuk notifikasi pembayaran.
Halaman ini menjelaskan cara membuat, melihat, memperbarui, dan menghapus topik di Konsol ApsaraMQ for RocketMQ. Untuk mengelola topik secara terprogram, lihat Referensi API.
Sebelum Anda mulai
Instans ApsaraMQ for RocketMQ telah tersedia. Untuk membuatnya, lihat dokumentasi manajemen instans.
Anda telah menentukan jenis pesan untuk topik tersebut. Setiap topik hanya mendukung satu jenis pesan, dan pengaturan ini tidak dapat diubah setelah topik dibuat. Untuk detailnya, lihat Jenis pesan.
Batasan utama
Sebelum membuat topik, tinjau batasan berikut.
| Batasan | Deskripsi |
|---|---|
| Instance-scoped | Topik termasuk dalam satu instans dan tidak dapat digunakan lintas instans. |
| Message type is immutable | Jenis pesan yang Anda pilih saat pembuatan menentukan pesan mana yang diterima oleh topik tersebut. Ketidaksesuaian menyebabkan masalah O&M seperti hilangnya scheduled message selama perubahan endpoint atau migrasi instans. |
| Billing | Setiap topik dikenakan biaya okupansi terlepas dari penggunaannya. Hapus topik yang tidak digunakan untuk menghindari biaya yang tidak perlu. Untuk detailnya, lihat Billing fitur messaging dan Billing. |
Aturan penamaan
Nama topik harus memenuhi persyaratan berikut:
Panjang 3 hingga 64 karakter
Hanya berisi huruf, angka, tanda hubung (-), dan garis bawah (_)
Persyaratan keunikan bergantung pada apakah instans memiliki namespace:
| Jenis instans | Cakupan keunikan | Detail |
|---|---|---|
| Dengan namespace | Di dalam instance | Nama tidak boleh sama dengan nama topik atau group ID yang sudah ada dalam instans yang sama. Instans berbeda dapat menggunakan nama yang sama. |
| Tanpa namespace | Lintas semua instans dan wilayah | Nama tidak boleh sama dengan nama topik atau group ID apa pun dalam Akun Alibaba Cloud Anda. |
Periksa apakah instans memiliki namespace di bagian Basic Information pada halaman Instance Details.
Buat topik
Masuk ke Konsol ApsaraMQ for RocketMQ. Di panel navigasi, klik Instances.
Di bilah navigasi atas, pilih wilayah, misalnya China (Hangzhou). Klik nama instans yang ingin Anda kelola.
Di panel navigasi, klik Topics. Di pojok kiri atas, klik Create Topic.
Di panel Create Topic, konfigurasikan parameter berikut, lalu klik OK.
Parameter Deskripsi Name Nama topik unik yang mengikuti aturan penamaan. Description Deskripsi singkat mengenai tujuan topik. Message Type Jenis pesan yang ditangani oleh topik ini. Nilai ini tidak dapat diubah setelah pembuatan.
Topik hanya dapat mengirim dan menerima pesan yang sesuai dengan jenis pesannya. Misalnya, topik yang dibuat dengan jenis Normal Message hanya menerima pesan normal. Untuk detailnya, lihat Jenis pesan.
Lihat detail topik
Di halaman Instances, klik nama instans yang ingin Anda kelola. Di panel navigasi, klik Topics.
Di daftar topik, klik nama topik atau klik Details di kolom Actions.
Perbarui deskripsi topik
Di halaman Instances, klik nama instans yang ingin Anda kelola. Di panel navigasi, klik Topics.
Di daftar topik, temukan topik target dan klik Details di kolom Actions.
Di bagian Basic Information, klik Edit di samping bidang Topic Description. Masukkan deskripsi baru, lalu klik OK.
Hapus topik
Menghapus topik bersifat permanen. Setelah dihapus, produsen tidak dapat lagi mengirim pesan ke topik tersebut, konsumen tidak dapat lagi mengonsumsi pesan darinya, dan seluruh metadata serta pesan dalam topik tersebut akan dihapus secara permanen.
Di halaman Instances, klik nama instans yang ingin Anda kelola. Di panel navigasi, klik Topics.
Di daftar topik, temukan topik target, klik More di kolom Actions, lalu pilih Delete.
Di kotak dialog konfirmasi, klik OK.
Referensi API
Operasi API berikut tersedia untuk manajemen topik:
| API | Deskripsi |
|---|---|
| OnsTopicCreate | Membuat topik. |
| OnsTopicDelete | Menghapus topik. |
| OnsTopicList | Menanyakan topik. |
| OnsTopicStatus | Menanyakan jumlah total pesan dan waktu pembaruan terakhir suatu topik. |
| OnsTopicSubDetail | Menanyakan langganan suatu topik. |