Deleting Queues

Method 1: Deleting a Single Queue on the Management UI

1. Log in to the RabbitMQ management UI.
2. On the Queues tab page, click the name of the desired queue.
   Figure 1 Queue list
   

3. 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.

1. Log in to the RabbitMQ management UI.
2. 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 with the same prefix 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 prefix is 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.

3. Click Add policy.

   On the Queues tab page, check whether the queues are successfully deleted.

4. 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.

1. Connect to the instance in Linux. For details, see Accessing a RabbitMQ Instance Without SSL Encryption.
2. 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 deleted
   

   You 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.

1. Connect to the instance in Linux. For details, see Accessing a RabbitMQ Instance Without SSL Encryption.
2. Create the delete_queues.sh script.

   touch delete_queues.sh

3. 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.

4. Save the script.
5. Configure the script permissions.

   chmod 777 delete_queues.sh

6. Run the script.

   sh delete_queues.sh

   If the deletion is successful, the following information is displayed.

   Figure 6 Queues deleted
   

   You can also check whether the queues are successfully deleted on the Queues tab page of the management UI.