DeleteQueue

Description

Deletes the queue specified by the queue URL. Normally, a queue must be empty before you can delete it. However, you can set the request parameter ForceDeletion to true to force the deletion of a queue even if it's not empty.

	Caution
	Use the `ForceDeletion` parameter with care; once you delete your messages in a queue, they are no longer available.

Once you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.

Request Parameters

The following table lists the special request parameters the action uses (in addition to the common request parameters listed in Common Request Parameters).

Name Description Required

Name	Description	Required
`ForceDeletion`	When set to `true`, the queue is deleted even if it is not empty. If this parameter is omitted or set to `false`, the queue must be empty for the `DeleteQueue` action to succeed. Use this parameter with care, because once you delete your messages, you cannot access them again. Type: Boolean Default: `false` Valid values: `false` \| `true`	No

ForceDeletion

When set to true, the queue is deleted even if it is not empty. If this parameter is omitted or set to false, the queue must be empty for the DeleteQueue action to succeed. Use this parameter with care, because once you delete your messages, you cannot access them again.

Type: Boolean

Default: false

Valid values: false | true

Response Elements

The response contains no special elements besides the common elements listed in The Structure of a Response.

Special Errors

The following table lists the special errors the action returns (in addition to the common errors listed in Common Errors).

Error	Description	HTTP Status Code
AWS.SimpleQueueService.NonEmptyQueue	Queue not empty.	400

Examples

The following example Query request deletes the specified queue even if it's not empty.

Sample Request

http://queue.amazonaws.com/A29E9VSPHGOG23/queue1
?Action=DeleteQueue
&AWSAccessKeyId=0GS7553JW74RRM612K02EXAMPLE
&Version=2007-05-01
&Expires=2007-05-12T12:00:00Z
&Signature=CN2SbNq%2B2Vw1W3lbc7wpM5gzDHEXAMPLE=
&ForceDeletion=true

Sample Response

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