The DeleteQueue action deletes the queue specified by the queue
URL, regardless of whether the queue is empty. If the specified queue does not
exist, SQS returns a successful response.
![]() | Caution |
|---|---|
Use |
When you delete a queue, the deletion process takes up to 60 seconds. Requests you send
involving that queue during the 60 seconds might succeed. For example, a
SendMessage request might succeed, but after the 60 seconds, the queue and
that message you sent no longer exist. Also, when you delete a queue, you must wait at least 60
seconds before creating a queue with the same name.
We reserve the right to delete queues that have had no activity for more than 30 days. For more information, see About SQS Queues.
The DeleteQueue action uses no special request parameters besides the
common request parameters all actions use (for more information, see Request Parameters Common to All Actions).
The response contains no special elements besides the common elements in all successful responses (for more information, see Structure of a Successful Response).
The DeleteQueue action returns no special errors besides the common errors
all actions return (for more information, see Errors Common to all Actions).
The following example Query request deletes the specified queue.
http://queue.amazonaws.com/queue1 ?Action=DeleteQueue &AWSAccessKeyId=0GS7553JW74RRM612K02EXAMPLE &Version=2008-01-01 &Expires=2008-02-10T12:00:00Z &Signature=CN2SbNq2B2Vw1W3lbc7wpM5gzDHEXAMPLE &SignatureVersion=2 &SignatureMethod=HmacSHA256
<DeleteQueueResponse>
<ResponseMetadata>
<RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
</ResponseMetadata>
</DeleteQueueResponse>