Deleting Queues
Delete queues on the RabbitMQ management UI or by calling APIs.
- Method 1: Deleting a Single Queue on the Management UI: Delete a single queue on the Queues tab page of the management UI.
- Method 2: Deleting Queues in Batches Using a Policy: Add a policy to delete multiple queues at a time. The policy has the same prefix as the queues to be deleted, and the queue time-to-live (TTL) is 1 ms.
- Method 3: Deleting a Single Queue Using an API: Call an API to delete a queue from a RabbitMQ instance with SSL disabled.
- Method 4: Deleting Queues in Batches Using an API: Compile a shell script to repeatedly call an API to delete queues in batches from a RabbitMQ instance with SSL disabled.
![](https://support.huaweicloud.com/eu/usermanual-rabbitmq/public_sys-resources/notice_3.0-en-us.png)
Before deleting a queue, ensure that all messages in the queue have been retrieved. Otherwise, unretrieved messages will be deleted together with the queue.
Method 1: Deleting a Single Queue on the Management UI
- Log in to the RabbitMQ management UI.
- On the Queues tab page, click the name of the desired queue.
Figure 1 Queue list
- Click Delete Queue to delete the queue.
Figure 2 Deleting a single queue
Method 2: Deleting Queues in Batches Using a Policy
Add a policy to delete multiple queues at a time. The policy has the same prefix as the queues to be deleted, and the queue TTL is 1 ms.
- Log in to the RabbitMQ management UI.
- On the Admin > Policies page, add a policy.
Figure 3 Adding a policy to delete queues in batches
- Name: Enter a policy name.
- Pattern: queue matching mode. Enter a queue name. Queues containing this queue name will be matched. If this parameter is set to .*, all queues are matched. If this parameter is set to .*queue-name, all queues whose name contains queue-name are matched.
- Apply to: Select Queues.
- Priority: policy priority. A larger value indicates a higher priority. This parameter is optional.
- Definition: TTL, in milliseconds. Set expires to 1, indicating that the queue expiration time is 1 ms.
- Click Add policy.
On the Queues tab page, check whether the queues are successfully deleted.
- After the queues are deleted, choose Admin > Policies, locate the row that contains the policy added in 2, and click Clear to delete the policy.
If this policy is retained, it will also apply to queues created later, and queues may be deleted by mistake.Figure 4 Deleting the policy
Method 3: Deleting a Single Queue Using an API
If SSL is not enabled for a RabbitMQ instance, you can call an API to delete a queue.
- Connect to the instance in Linux. For details, see Accessing a RabbitMQ Instance Without SSL Encryption.
- Run the following command to delete a queue:
curl -i -XDELETE http://${USERNAME}:${PASSWORD}@${HOST}:${PORT}/api/queues/${VHOST_NAME}/${QUEUE_NAME}
Parameter description:- USERNAME: username set when the instance was created.
- PASSWORD: password set when the instance was created. If you forget the password, reset it by referring to Resetting the Instance Password.
- HOST: management UI address queried on the instance details page.
- PORT: management UI port number queried on the instance details page.
- VHOST_NAME: virtual host name. The default value is /. Change it to %2F in the command.
- QUEUE_NAME: name of the queue to be deleted.
Example:
curl-i -XDELETE http://test:Zsxxxdx@192.168.0.241:15672/api/queues/%2F/hello
If the deletion is successful, the following information is displayed.
Figure 5 Queue deletedYou can also check whether the queue is successfully deleted on the Queues tab page of the management UI.
Method 4: Deleting Queues in Batches Using an API
If SSL is not enabled for a RabbitMQ instance, you can compile a shell script to repeatedly call an API to delete queues in batches.
- Connect to the instance in Linux. For details, see Accessing a RabbitMQ Instance Without SSL Encryption.
- Create the delete_queues.sh script.
touch delete_queues.sh
- Edit the script.
vim delete_queues.sh
Copy the following content to the script. Change the values of USERNAME, PASSWORD, HOST, and QUEUES_LIST as required.
#!/usr/bin/env bash USERNAME=root PASSWORD=Zsxxxdx HOST=192.168.0.241 PORT=15672 VHOST='%2F' QUEUES_LIST="test1 test2 test3"; for QUEUE_NAME in $QUEUES_LIST : do curl -i -XDELETE http://$USERNAME:$PASSWORD@$HOST:$PORT/api/queues/$VHOST/$QUEUE_NAME done
Parameter description:- USERNAME: username set when the instance was created.
- PASSWORD: password set when the instance was created. If you forget the password, reset it by referring to Resetting the Instance Password.
- HOST: management UI address queried on the instance details page.
- PORT: management UI port number queried on the instance details page.
- VHOST: virtual host name. The default value is /. Change it to %2F in the command.
- QUEUES_LIST: names of the queues to be deleted. Use spaces to separate queue names.
- Save the script.
- Configure the script permissions.
chmod 777 delete_queues.sh
- Run the script.
sh delete_queues.sh
If the deletion is successful, the following information is displayed.
Figure 6 Queues deletedYou can also check whether the queues are successfully deleted on the Queues tab page of the management UI.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.