Prev		Next

DeleteQueue (SOAP)

Deletes the queue specified by the queue URL. A queue is deleted only if it does not contain any messages. Use DeleteMessage to delete messages from the queue.

Validation

DeleteQueue requests are validated on the following:

The queue specified must exist.
The queue specified must be empty.

Returns

Returns Success if the request is successful, or an error response if unsuccessful.

Request Parameters

The DeleteQueue action takes no input parameters other than those common to all requests to SQS.

Example DeleteQueue Request (SOAP)

The following example of a DeleteQueue request deletes the queue specified by the provided queue URL.

Sample Request

<soap:Body wsu:Id="body" 
 xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
  <m:DeleteQueue xmlns:m="http://queue.amazonaws.com/doc/2006-04-01/">
  </m:DeleteQueue>
</soap:Body>

Sample Response

<DeleteQueueResponse>
    <ResponseStatus>
      <StatusCode>Success</StatusCode>
      <RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
    </ResponseStatus>
</DeleteQueueResponse>

Error Responses

Error	Description
NonEmptyQueue	Queue not empty.
AWS.SimpleQueueService.NonExistentQueue	Queue does not exist.