DeleteQueue

Description

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]Caution

Use DeleteQueue with care; once you delete your queue, any messages in the queue are no longer available.

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.

Request Parameters

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

Response Elements

The response contains no special elements besides the common elements in all successful responses (for more information, see Structure of a Successful Response).

Special Errors

The DeleteQueue action returns no special errors besides the common errors all actions return (for more information, see Errors Common to all Actions).

Examples

The following example Query request deletes the specified queue.

Sample Request

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

Sample Response

<DeleteQueueResponse>
  <ResponseMetadata>
    <RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
  </ResponseMetadata>
</DeleteQueueResponse>

Related Actions