Skip to content

delete_queue

Operation

delete_queue

delete_queue(request: DeleteQueueInput | DeleteQueueInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[DeleteQueueInputDict]) -> 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
request DeleteQueueInput | DeleteQueueInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[DeleteQueueInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
DeleteQueueOutput

An instance of DeleteQueueOutput.

delete_queue async

delete_queue(request: DeleteQueueInput | DeleteQueueInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[DeleteQueueInputDict]) -> 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
request DeleteQueueInput | DeleteQueueInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[DeleteQueueInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
DeleteQueueOutput

An instance of DeleteQueueOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

DeleteQueueInputDict

Bases: TypedDict

Dictionary form of DeleteQueueInput.

Attributes

queue_url instance-attribute
queue_url: Required[str]

The URL of the Amazon SQS queue to delete.

Queue URLs and names are case-sensitive.

DeleteQueueInput dataclass

Bases: _SerdeShape

Attributes

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

The URL of the Amazon SQS queue to delete.

Queue URLs and names are case-sensitive.

Output

DeleteQueueOutput dataclass

Bases: _SerdeShape

Dataclass for DeleteQueueOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.