Deletes a message queue. If you call this operation to delete a queue, the messages in the queue are also deleted and cannot be restored. Proceed with caution.


A request consists of the following parts:

  • Request line

    DELETE /$queueName HTTP/1.1

  • Operation-specific request headers

    None. For more information about common request parameters, see Common parameters.

  • Request body



A response consists of a status line, HTTP headers, and a response body.

  • HTTP status code

    HTTP/1.1 204 No Content

  • Operation-specific response headers

    None. For more information about common response parameters, see Common parameters.

  • Response body


Error codes

No error codes that are specific to this operation are returned. Potential errors are related to permission check and parameter settings. For more information, see Error codes.

  • Sample requests
        DELETE /$queueName  HTTP/1.1
        Host: $
        Date: Wed, 08 Mar 2012 12:00:00 GMT
        x-mqs-version: 2014-07-08
        Authorization: MQS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=            
  • Sample responses
        HTTP/1.1 204 NoContent
        x-mqs-request-id: 512B2A634403E52B1956133E
        x-mqs-version: 2015-06-06