Skip to content

SQS  >  Operations  >  list_message_move_tasks

list_message_move_tasks

Operation

list_message_move_tasks async 

list_message_move_tasks(input: ListMessageMoveTasksInput, plugins: list[Plugin] | None = None) -> ListMessageMoveTasksOutput

Gets the most recent message movement tasks (up to 10) under a specific source queue.

Note

  • This action is currently limited to supporting message redrive from dead-letter queues (DLQs) only. In this context, the source queue is the dead-letter queue (DLQ), while the destination queue can be the original source queue (from which the messages were driven to the dead-letter-queue), or a custom destination queue.

  • Only one active message movement task is supported per queue at any given time.

Parameters:

Name Type Description Default
input ListMessageMoveTasksInput

An instance of ListMessageMoveTasksInput.

 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
ListMessageMoveTasksOutput

An instance of ListMessageMoveTasksOutput.

Input

ListMessageMoveTasksInput dataclass

Dataclass for ListMessageMoveTasksInput structure.

Attributes

max_results class-attribute instance-attribute 
max_results: int | None = None

The maximum number of results to include in the response. The default is 1, which provides the most recent message movement task. The upper limit is 10.

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

The ARN of the queue whose message movement tasks are to be listed.

Output

ListMessageMoveTasksOutput dataclass

Dataclass for ListMessageMoveTasksOutput structure.

Attributes

results class-attribute instance-attribute 
results: list[ListMessageMoveTasksResultEntry] | None = None

A list of message movement tasks and their attributes.