All Products
Search

This Product

    ApsaraMQ for RabbitMQ:Membuat resource

    Document Center

    ApsaraMQ for RabbitMQ:Membuat resource

    Last Updated:Jul 10, 2026

    Buat resource ApsaraMQ for RabbitMQ yang dibutuhkan aplikasi Anda: instance, vhost, exchange, queue, dan binding.

    Hierarki resource

    Instance
  └── Vhost (isolasi logis)
        ├── Exchange (mengarahkan pesan)
        └── Queue (menyimpan pesan)
              └── Binding (menghubungkan exchange ke queue)

    Resource

    Peran

    Instance

    Kontainer tingkat teratas untuk semua resource lainnya.

    Vhost

    Mengisolasi exchange, queue, dan binding. Satu instance dapat menampung beberapa vhost.

    Exchange

    Menerima pesan dari produsen dan mengarahkannya ke queue berdasarkan routing key.

    Queue

    Menyimpan pesan hingga konsumen mengambilnya.

    Binding

    Menghubungkan exchange ke queue menggunakan routing key.

    Alur data: Produsen > Exchange > (routing key + binding) > Queue > Konsumen

    Prasyarat

    Jika Anda menggunakan pengguna Resource Access Management (RAM), berikan izin yang diperlukan. Langkah 1: (Opsional) Memberikan izin kepada pengguna RAM

    Catatan

    Jika Anda menggunakan pengguna RAM untuk membuat instance ApsaraMQ for RabbitMQ, Anda harus memilih minimal dua vSwitch saat mengonfigurasi jaringan. Jika jumlah vSwitch yang dipilih kurang dari dua, pembuatan instance akan gagal.

    Langkah 1: Membuat instance

    1. Masuk ke Konsol ApsaraMQ for RabbitMQ. Di panel navigasi kiri, klik Instances.

    2. Di bilah navigasi atas, pilih wilayah. Pada halaman Instances, klik Create Instance.

    3. Pada halaman pembelian, konfigurasikan pengaturan instance, terima syarat layanan, lalu klik Buy Now.

    4. Selesaikan pembayaran.

    Setelah pembayaran selesai, kembali ke halaman Instances dan pilih wilayah Anda untuk melihat instance tersebut.

    Langkah 2: Membuat vhost

    Vhost mengisolasi resource. Tentukan vhost sebelum menghubungkan produsen atau konsumen.

    1. Pada halaman Instances, klik nama instance Anda.

    2. Di panel navigasi kiri, klik Vhosts.

    3. Pada halaman Vhosts, klik Create Vhost.

    4. Pada panel Create Vhost, masukkan nama di bidang vhost Name lalu klik OK.

    Langkah 3: Membuat exchange

    Exchange mengarahkan pesan dari produsen ke queue berdasarkan routing key. Exchange

    1. Di panel navigasi kiri, klik Exchanges.

    2. Pada halaman Exchanges, perluas daftar drop-down vhost, pilih vhost target dari Change, lalu klik Create Exchange.

    3. Pada panel Create Exchange, konfigurasikan parameter berikut lalu klik OK.

    Parameter exchange

    Parameter

    Wajib

    Deskripsi

    Exchange Name

    Ya

    1. The Exchange name supports only letters, digits, hyphens (-), underscores (_), periods (.), pound signs (#), slashes (/), at signs (@), colons (:), commas (,), spaces ( ), and greater-than signs (>). Length: 1–255 characters. Nama yang diawali dengan amq. bersifat terbatas (misalnya, amq.test).

    Type

    Ya

    Jenis exchange.

    Internal

    Tidak

    Apakah exchange bersifat internal. Default: No. Atur ke Yes untuk mengikat exchange ini ke exchange lain alih-alih ke queue.

    Parameter berikut hanya muncul untuk jenis exchange tertentu:

    Parameter

    Kapan Mengonfigurasi

    Deskripsi

    x-delayed-type

    Type = x-delayed-message

    Aturan routing untuk exchange pesan tertunda.

    Hash value

    Type = x-consistent-hash

    Input untuk perhitungan hash. Nilai yang valid: RoutingKey, Header Value.

    hash-header

    Type = x-consistent-hash dan Hash value = Header Value

    Header yang digunakan sebagai input untuk perhitungan hash.

    Jenis exchange

    Jenis

    Logika routing

    Deskripsi

    direct

    Pencocokan eksak

    Mengarahkan pesan ke queue yang routing key-nya persis sesuai dengan routing key pesan.

    topic

    Pencocokan pola

    Mengarahkan pesan ke queue yang binding key-nya sesuai dengan routing key pesan berdasarkan pola.

    fanout

    Penyiaran

    Mengarahkan pesan ke semua queue yang terikat, mengabaikan routing key.

    headers

    Pencocokan header

    Mengarahkan pesan dengan mencocokkan pasangan kunci-nilai header terhadap atribut binding alih-alih routing key.

    x-delayed-message

    Pengiriman tertunda

    Menunda pengiriman pesan selama durasi yang ditentukan dalam atribut header x-delay (dalam milidetik). Setelah penundaan berakhir, pesan diarahkan sesuai aturan yang ditentukan oleh x-delayed-type.

    x-consistent-hash

    Penghashan konsisten

    Memproses routing key atau nilai header melalui penghashan dan menggunakan penghashan konsisten untuk mendistribusikan pesan ke berbagai queue.

    Langkah 4: Membuat queue

    Queue menyimpan pesan hingga konsumen mengambilnya.

    1. Di panel navigasi kiri, klik Queues.

    2. Pada halaman Queues, perluas daftar drop-down vhost, pilih vhost target dari Change, lalu klik Create Queue.

    3. Pada panel Create Queue, konfigurasikan parameter berikut lalu klik OK.

    Parameter antrean

    Parameter

    Wajib

    Deskripsi

    Queue Name

    Ya

    Nama queue.

    Auto Delete

    Tidak

    Secara otomatis menghapus queue ketika konsumen terakhir berhenti berlangganan. Default: No.

    Klik Dead-letter Policy untuk mengonfigurasi parameter opsional:

    Parameter

    Deskripsi

    DeadLetterExchange

    Exchange tempat pesan dead-letter dikirimkan.

    DeadLetterRoutingKey

    Routing key untuk pesan dead-letter.

    MessageTTL

    Waktu hidup (TTL) pesan dalam milidetik. Pesan yang tidak dikonsumsi akan menjadi dead-letter setelah TTL habis. Message TTL

    Aturan penamaan queue

    • 1. The queue name supports only letters, digits, hyphens (-), underscores (_), periods (.), pound signs (#), slashes (/), at signs (@), colons (:), commas (,), spaces ( ), and greater-than signs (>). Length: 1–255 characters.

    • Panjang: 1 hingga 255 karakter.

    • Nama tidak dapat diubah setelah dibuat. Hapus dan buat ulang untuk mengganti nama.

    • amq. adalah awalan yang terbatas. Misalnya, amq.test tidak diizinkan.

    Langkah 5: Membuat binding

    Binding menghubungkan exchange ke queue agar pesan dapat mencapai queue tersebut.

    1. Pada halaman Queues, temukan queue Anda lalu klik Details di kolom Actions.

    2. Pada halaman Queue Details, klik tab Bound as Destination. Lalu, klik Add Binding.

    3. Pada panel Add Binding, konfigurasikan parameter Source Exchange dan Routing Key. Lalu, klik OK.

    Jika exchange sumber bertipe x-consistent-hash, routing key merepresentasikan bobot queue. Bobot harus berupa bilangan bulat antara 1 hingga 20.

    Langkah berikutnya

    Langkah 3: Gunakan SDK untuk mengirim dan menerima pesan

    Referensi

    Anda juga dapat membuat resource dengan memanggil operasi API:

    FAQ

    Apa yang harus saya lakukan jika gagal membuat instance ApsaraMQ for RabbitMQ?

    Coba langkah troubleshooting berikut:

    1. Periksa pengaturan security group VPC: Pastikan security group di VPC Anda dikonfigurasi dengan benar. Pastikan aturan inbound mengizinkan traffic pada port 5672 (AMQP) dan port 5671 (AMQPS).

    2. Dapatkan informasi error detail: Buka developer tools browser Anda (tekan F12) dan periksa tab Network untuk melihat respons API guna mengidentifikasi kode error atau pesan spesifik yang dikembalikan oleh server.

    3. Izin pengguna RAM dan persyaratan vSwitch: Jika Anda menggunakan pengguna RAM, pastikan izin yang diperlukan telah diberikan. Saat membuat instance, pastikan Anda memilih minimal dua vSwitch. Memilih kurang dari dua vSwitch menyebabkan pembuatan instance gagal.