SQS / Client / list_message_move_tasks

list_message_move_tasks#

SQS.Client.list_message_move_tasks(**kwargs)#

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.

  • Currently, only standard queues are supported.

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

See also: AWS API Documentation

Request Syntax

response = client.list_message_move_tasks(
    SourceArn='string',
    MaxResults=123
)
Parameters:

  • SourceArn (string) –

    [REQUIRED]

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

  • MaxResults (integer) – 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.

Return type:

dict

Returns:

Response Syntax

{
    'Results': [
        {
            'TaskHandle': 'string',
            'Status': 'string',
            'SourceArn': 'string',
            'DestinationArn': 'string',
            'MaxNumberOfMessagesPerSecond': 123,
            'ApproximateNumberOfMessagesMoved': 123,
            'ApproximateNumberOfMessagesToMove': 123,
            'FailureReason': 'string',
            'StartedTimestamp': 123
        },
    ]
}

Response Structure

  • (dict) –

    • Results (list) –

      A list of message movement tasks and their attributes.

      • (dict) –

        Contains the details of a message movement task.

        • TaskHandle (string) –

          An identifier associated with a message movement task. When this field is returned in the response of the ListMessageMoveTasks action, it is only populated for tasks that are in RUNNING status.

        • Status (string) –

          The status of the message movement task. Possible values are: RUNNING, COMPLETED, CANCELLING, CANCELLED, and FAILED.

        • SourceArn (string) –

          The ARN of the queue that contains the messages to be moved to another queue.

        • DestinationArn (string) –

          The ARN of the destination queue if it has been specified in the StartMessageMoveTask request. If a DestinationArn has not been specified in the StartMessageMoveTask request, this field value will be NULL.

        • MaxNumberOfMessagesPerSecond (integer) –

          The number of messages to be moved per second (the message movement rate), if it has been specified in the StartMessageMoveTask request. If a MaxNumberOfMessagesPerSecond has not been specified in the StartMessageMoveTask request, this field value will be NULL.

        • ApproximateNumberOfMessagesMoved (integer) –

          The approximate number of messages already moved to the destination queue.

        • ApproximateNumberOfMessagesToMove (integer) –

          The number of messages to be moved from the source queue. This number is obtained at the time of starting the message movement task.

        • FailureReason (string) –

          The task failure reason (only included if the task status is FAILED).

        • StartedTimestamp (integer) –

          The timestamp of starting the message movement task.

Exceptions

  • SQS.Client.exceptions.ResourceNotFoundException

  • SQS.Client.exceptions.RequestThrottled

  • SQS.Client.exceptions.InvalidAddress

  • SQS.Client.exceptions.InvalidSecurity

  • SQS.Client.exceptions.UnsupportedOperation