Skip to content

SQS  >  Operations  >  delete_queue

delete_queue

Operation

delete_queue async 

delete_queue(input: DeleteQueueInput, plugins: list[Plugin] | None = None) -> DeleteQueueOutput

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.

Parameters:

Name Type Description Default
input DeleteQueueInput

An instance of DeleteQueueInput.

 required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

 None

Returns:

Type Description
DeleteQueueOutput

An instance of DeleteQueueOutput.

Input

DeleteQueueInput dataclass

Attributes

queue_url class-attribute instance-attribute 
queue_url: str | None = None

The URL of the Amazon SQS queue to delete.

Queue URLs and names are case-sensitive.

Output

DeleteQueueOutput dataclass

Dataclass for DeleteQueueOutput structure.