ApsaraMQ for RabbitMQ:Create resources

Resource hierarchy

Instance
  └── Vhost (logical isolation)
        ├── Exchange (routes messages)
        └── Queue (stores messages)
              └── Binding (connects an exchange to a queue)

Data flow: Producer > Exchange > (routing key + binding) > Queue > Consumer

Prerequisites

If you use a Resource Access Management (RAM) user, grant the required permissions. Step 1: (Optional) Grant permissions to a RAM user

Step 1: Create an instance

1. Log on to the ApsaraMQ for RabbitMQ console. In the left-side navigation pane, click Instances.

2. In the top navigation bar, select a region. On the Instances page, click Create Instance.

3. On the buy page, configure instance settings, accept the terms of service, and click Buy Now.

4. Complete the payment.

After payment, return to the Instances page and select your region to view the instance.

Step 2: Create a vhost

A vhost isolates resources. Specify a vhost before connecting a producer or consumer.

1. On the Instances page, click the name of your instance.

2. In the left-side navigation pane, click Vhosts.

3. On the Vhosts page, click Create Vhost.

4. In the Create Vhost panel, enter a name in the vhost Name field and click OK.

Step 3: Create an exchange

An exchange routes producer messages to queues by routing key. Exchange

1. In the left-side navigation pane, click Exchanges.

2. On the Exchanges page, expand the vhost drop-down list, select the target vhost from Change, and click Create Exchange.

3. In the Create Exchange panel, configure the following parameters and click OK.

Step 4: Create a queue

Queues store messages until consumers retrieve them.

1. In the left-side navigation pane, click Queues.

2. On the Queues page, expand the vhost drop-down list, select the target vhost from Change, and click Create Queue.

3. In the Create Queue panel, configure the following parameters and click OK.

Step 5: Create a binding

A binding connects an exchange to a queue so that messages reach the queue.

1. On the Queues page, find your queue and click Details in the Actions column.

2. On the Queue Details page, click the Bound as Destination tab. Then, click Add Binding.

3. In the Add Binding panel, configure the Source Exchange and Routing Key parameters. Then, click OK.

If the source exchange is of the x-consistent-hash type, the routing key represents the weight of the queue. The weight must be an integer from 1 to 20.

Next steps

Step 3: Use an SDK to send and receive messages

References

You can also create resources by calling API operations:

• CreateInstance: Create an instance.

• ListInstances: Get an instance endpoint.

• CreateVirtualHost: Create a vhost.

• CreateExchange: Create an exchange.

• CreateQueue: Create a queue.

• CreateBinding: Create a binding.

• CreateAccount: Create a static username and password for an instance.

FAQ

What do I do if I fail to create an ApsaraMQ for RabbitMQ instance?

Try the following troubleshooting steps:

1. Check VPC security group settings: Verify that the security group in your VPC is correctly configured. Make sure that inbound rules allow traffic on port 5672 (AMQP) and port 5671 (AMQPS).

2. Get detailed error information: Open your browser developer tools (press F12) and check the Network tab for the API response to identify the specific error code or message returned by the server.

3. RAM user permissions and vSwitch requirements: If you are using a RAM user, verify that the required permissions are granted. When creating the instance, make sure you select at least two vSwitches. Selecting fewer than two vSwitches causes the instance creation to fail.