SQS / Client / delete_queue
delete_queue#
- SQS.Client.delete_queue(**kwargs)#
Deletes the queue specified by the
QueueUrl
, regardless of the queue’s contents.Warning
Be careful with the
DeleteQueue
action: When you delete a 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 60 seconds the queue and the message you sent no longer exist.When you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.
Note
Cross-account permissions don’t apply to this action. For more information, see Grant cross-account permissions to a role and a username in the Amazon SQS Developer Guide.
The delete operation uses the HTTP
GET
verb.See also: AWS API Documentation
Request Syntax
response = client.delete_queue( QueueUrl='string' )
- Parameters:
QueueUrl (string) –
[REQUIRED]
The URL of the Amazon SQS queue to delete.
Queue URLs and names are case-sensitive.
- Returns:
None
Exceptions
SQS.Client.exceptions.RequestThrottled
SQS.Client.exceptions.QueueDoesNotExist
SQS.Client.exceptions.InvalidAddress
SQS.Client.exceptions.UnsupportedOperation
SQS.Client.exceptions.InvalidSecurity