# Amazon SQS (/integrations/sqs)





{/* MANUAL-CONTENT-START:intro */}

Use [Amazon SQS](https://aws.amazon.com/sqs/) to send, receive, and delete messages, extend visibility timeouts, and manage queues, attributes, and tags. Batch message actions accept up to 10 entries. Dead-letter actions list source queues and start, inspect, or cancel message move tasks.

A workflow can long-poll for work, process each message, and delete it after success. Receiving a message does not remove it: if processing fails and it is not deleted, it becomes available again after the visibility timeout.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Send and receive messages one at a time or in batches of ten, delete messages, extend visibility timeouts, manage queues along with their attributes and tags, and redrive messages out of a dead-letter queue.

## Actions [#actions]

### SQS Send Message [#sqs-send-message]

Send a message to an Amazon SQS queue

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `data` | json | Yes | Message body to send as JSON object (e.g., \{ "action": "process", "payload": \{...} }) |
  | `delaySeconds` | number | No | Seconds to delay delivery of this message, 0-900. Not supported per-message on FIFO queues |
  | `messageAttributes` | json | No | Message attributes keyed by name, each \{ "dataType": "String" \| "Number", "stringValue": "..." }. A custom label such as Number.float is allowed; Binary attributes are not supported |
  | `messageGroupId` | string | No | Message group ID for FIFO queues (e.g., "order-processing-group") |
  | `messageDeduplicationId` | string | No | Message deduplication ID for FIFO queues (e.g., "order-12345-v1") |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
  | `id` | string | Message ID |
  | `md5OfMessageBody` | string | MD5 digest of the message body, for verifying SQS received it intact |
  | `md5OfMessageAttributes` | string | MD5 digest of the message attributes |
  | `sequenceNumber` | string | Large, non-consecutive sequence number assigned by a FIFO queue |
</ReferenceDetails>

### SQS Send Message Batch [#sqs-send-message-batch]

Send up to 10 messages to an Amazon SQS queue in a single request

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `entries` | array | Yes | Up to 10 entries, each \{ "id": "unique-id", "data": \{ ... }, "delaySeconds"?, "messageGroupId"?, "messageDeduplicationId"?, "messageAttributes"? } |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
  | `successful` | array | Entries that were accepted |
  | ↳ `id` | string | Id supplied for this batch entry |
  | ↳ `messageId` | string | Message ID assigned by SQS |
  | ↳ `md5OfMessageBody` | string | MD5 digest of the message body |
  | ↳ `md5OfMessageAttributes` | string | MD5 digest of the message attributes |
  | ↳ `sequenceNumber` | string | Sequence number assigned by a FIFO queue |
  | `failed` | array | Entries that were rejected |
  | ↳ `id` | string | Id supplied for this batch entry |
  | ↳ `senderFault` | boolean | Whether the sender caused the failure |
  | ↳ `code` | string | Error code for the failure |
  | ↳ `message` | string | Human-readable failure message |
  | `successCount` | number | Number of messages accepted |
  | `failureCount` | number | Number of messages rejected |
</ReferenceDetails>

### SQS Receive Message [#sqs-receive-message]

Receive up to 10 messages from an Amazon SQS queue, with optional long polling

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `maxNumberOfMessages` | number | No | Maximum number of messages to return, 1-10 (default 1) |
  | `waitTimeSeconds` | number | No | Long-poll duration in seconds, 0-20. Waits for a message to arrive before returning (default 0, short poll) |
  | `visibilityTimeout` | number | No | Seconds the returned messages stay hidden from other consumers, 0-43200. Defaults to the queue setting |
  | `messageAttributeNames` | array | No | Names of user-defined message attributes to return. Use \["All"] to return all of them |
  | `messageSystemAttributeNames` | array | No | System attributes to return: All, SenderId, SentTimestamp, ApproximateReceiveCount, ApproximateFirstReceiveTimestamp, SequenceNumber, MessageDeduplicationId, MessageGroupId, AWSTraceHeader, DeadLetterQueueSourceArn |
  | `receiveRequestAttemptId` | string | No | FIFO queues only: deduplication token that lets a retried receive return the same messages (max 128 characters) |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `messages` | array | Received messages. Pass a receiptHandle to sqs\_delete\_message, sqs\_delete\_message\_batch, sqs\_change\_message\_visibility, or sqs\_change\_message\_visibility\_batch |
  | ↳ `messageId` | string | Unique ID SQS assigned to the message |
  | ↳ `receiptHandle` | string | Handle identifying this receipt of the message, required to delete it |
  | ↳ `body` | string | Message body as it was sent |
  | ↳ `md5OfBody` | string | MD5 digest of the message body |
  | ↳ `md5OfMessageAttributes` | string | MD5 digest of the message attributes |
  | ↳ `attributes` | json | Requested system attributes as string values keyed by attribute name |
  | ↳ `messageAttributes` | json | Requested user-defined attributes, each with dataType, stringValue, and stringListValues |
  | `count` | number | Number of messages returned |
</ReferenceDetails>

### SQS Delete Message [#sqs-delete-message]

Delete a received message from an Amazon SQS queue using its receipt handle

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `receiptHandle` | string | Yes | Receipt handle returned by sqs\_receive\_message for the message to delete |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
</ReferenceDetails>

### SQS Delete Message Batch [#sqs-delete-message-batch]

Delete up to 10 received messages from an Amazon SQS queue in a single request

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `entries` | array | Yes | Up to 10 entries, each \{ "id": "unique-id", "receiptHandle": "..." }. Receipt handles come from sqs\_receive\_message |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
  | `successful` | array | Entries that were deleted |
  | ↳ `id` | string | Id supplied for this batch entry |
  | `failed` | array | Entries that were rejected |
  | ↳ `id` | string | Id supplied for this batch entry |
  | ↳ `senderFault` | boolean | Whether the sender caused the failure |
  | ↳ `code` | string | Error code for the failure |
  | ↳ `message` | string | Human-readable failure message |
  | `successCount` | number | Number of messages deleted |
  | `failureCount` | number | Number of messages rejected |
</ReferenceDetails>

### SQS Change Message Visibility [#sqs-change-message-visibility]

Change how long a received Amazon SQS message stays hidden from other consumers

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `receiptHandle` | string | Yes | Receipt handle returned by sqs\_receive\_message for the message to update |
  | `visibilityTimeout` | number | Yes | New visibility timeout in seconds, 0-43200 (12 hours). 0 makes the message immediately visible again |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
</ReferenceDetails>

### SQS Change Message Visibility Batch [#sqs-change-message-visibility-batch]

Change the visibility timeout of up to 10 received Amazon SQS messages at once

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `entries` | array | Yes | Up to 10 entries, each \{ "id": "unique-id", "receiptHandle": "...", "visibilityTimeout": 0-43200 }. Receipt handles come from sqs\_receive\_message |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
  | `successful` | array | Entries that were updated |
  | ↳ `id` | string | Id supplied for this batch entry |
  | `failed` | array | Entries that were rejected |
  | ↳ `id` | string | Id supplied for this batch entry |
  | ↳ `senderFault` | boolean | Whether the sender caused the failure |
  | ↳ `code` | string | Error code for the failure |
  | ↳ `message` | string | Human-readable failure message |
  | `successCount` | number | Number of messages updated |
  | `failureCount` | number | Number of messages rejected |
</ReferenceDetails>

### SQS List Queues [#sqs-list-queues]

List Amazon SQS queue URLs in a region, optionally filtered by name prefix

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueNamePrefix` | string | No | Return only queues whose name begins with this string (case-sensitive) |
  | `maxResults` | number | No | Maximum queues to return, 1-1000. Must be set to receive a nextToken (default returns up to 1000) |
  | `nextToken` | string | No | Pagination token from a previous request |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `queueUrls` | array | Queue URLs returned by the request |
  | `nextToken` | string | Pagination token for the next page of results |
  | `count` | number | Number of queue URLs returned |
</ReferenceDetails>

### SQS Get Queue URL [#sqs-get-queue-url]

Resolve an Amazon SQS queue name to its queue URL

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueName` | string | Yes | Queue name, up to 80 characters of letters, digits, hyphens and underscores. A FIFO queue name ends in .fifo |
  | `queueOwnerAwsAccountId` | string | No | 12-digit AWS account ID of the queue owner, when the queue belongs to another account |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `queueUrl` | string | URL of the queue |
</ReferenceDetails>

### SQS Get Queue Attributes [#sqs-get-queue-attributes]

Read configuration and message-count attributes of an Amazon SQS queue

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `attributeNames` | array | No | Attributes to return, e.g. \["All"], \["ApproximateNumberOfMessages"], \["QueueArn"], \["VisibilityTimeout"], \["RedrivePolicy"]. Omitting this returns no attributes |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `attributes` | json | Queue attributes as string values keyed by attribute name (e.g., ApproximateNumberOfMessages, QueueArn, VisibilityTimeout, RedrivePolicy) |
</ReferenceDetails>

### SQS Set Queue Attributes [#sqs-set-queue-attributes]

Update configuration attributes of an existing Amazon SQS queue

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `attributes` | json | Yes | Attributes to set as string values, e.g. \{ "VisibilityTimeout": "60", "MessageRetentionPeriod": "345600", "RedrivePolicy": "\{...}" }. FifoQueue can only be set at creation |

  #### Output [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
</ReferenceDetails>

### SQS Create Queue [#sqs-create-queue]

Create a standard or FIFO Amazon SQS queue

<ReferenceDetails>
  #### Input [#input-11]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueName` | string | Yes | Queue name, up to 80 characters of letters, digits, hyphens and underscores. A FIFO queue name must end in .fifo |
  | `attributes` | json | No | Queue attributes as string values, e.g. \{ "FifoQueue": "true", "VisibilityTimeout": "30", "DelaySeconds": "0", "RedrivePolicy": "\{...}" } |
  | `tags` | json | No | Cost-allocation tags to apply to the new queue, as \{ "key": "value" } pairs |

  #### Output [#output-11]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
  | `queueUrl` | string | URL of the created queue |
</ReferenceDetails>

### SQS Delete Queue [#sqs-delete-queue]

Delete an Amazon SQS queue and every message still in it

<ReferenceDetails>
  #### Input [#input-12]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |

  #### Output [#output-12]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
</ReferenceDetails>

### SQS Purge Queue [#sqs-purge-queue]

Delete every message in an Amazon SQS queue while keeping the queue itself

<ReferenceDetails>
  #### Input [#input-13]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |

  #### Output [#output-13]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
</ReferenceDetails>

### SQS List Dead-Letter Source Queues [#sqs-list-dead-letter-source-queues]

List the Amazon SQS queues that use a given queue as their dead-letter queue

<ReferenceDetails>
  #### Input [#input-14]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | URL of the dead-letter queue whose source queues should be listed |
  | `maxResults` | number | No | Maximum source queues to return, 1-1000. Must be set to receive a nextToken (default returns up to 1000) |
  | `nextToken` | string | No | Pagination token from a previous request |

  #### Output [#output-14]

  | Parameter | Type | Description |
  | - | - | - |
  | `queueUrls` | array | URLs of the source queues that redrive to this dead-letter queue |
  | `nextToken` | string | Pagination token for the next page of results |
  | `count` | number | Number of source queues returned |
</ReferenceDetails>

### SQS List Queue Tags [#sqs-list-queue-tags]

List the cost-allocation tags attached to an Amazon SQS queue

<ReferenceDetails>
  #### Input [#input-15]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |

  #### Output [#output-15]

  | Parameter | Type | Description |
  | - | - | - |
  | `tags` | json | Tags attached to the queue, as string values keyed by tag key |
</ReferenceDetails>

### SQS Tag Queue [#sqs-tag-queue]

Add or overwrite cost-allocation tags on an Amazon SQS queue

<ReferenceDetails>
  #### Input [#input-16]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `tags` | json | Yes | Tags to apply as \{ "key": "value" } pairs. An existing key is overwritten. AWS recommends no more than 50 tags per queue |

  #### Output [#output-16]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
</ReferenceDetails>

### SQS Untag Queue [#sqs-untag-queue]

Remove cost-allocation tags from an Amazon SQS queue

<ReferenceDetails>
  #### Input [#input-17]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `queueUrl` | string | Yes | SQS queue URL (e.g., [https://sqs.us-east-1.amazonaws.com/123456789012/my-queue](https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)) |
  | `tagKeys` | array | Yes | Tag keys to remove, e.g. \["env", "team"] |

  #### Output [#output-17]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
</ReferenceDetails>

### SQS Start Message Move Task [#sqs-start-message-move-task]

Start redriving messages out of an Amazon SQS dead-letter queue

<ReferenceDetails>
  #### Input [#input-18]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `sourceArn` | string | Yes | ARN of the dead-letter queue to move messages out of (e.g., arn:aws:sqs:us-east-1:123456789012:my-dlq) |
  | `destinationArn` | string | No | ARN of the queue to move messages into. Omit to redrive each message to its original source queue |
  | `maxNumberOfMessagesPerSecond` | number | No | Throttle the move to at most this many messages per second, up to 500. Omit to move as fast as possible |

  #### Output [#output-18]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
  | `taskHandle` | string | Handle identifying the move task, accepted by sqs\_cancel\_message\_move\_task |
</ReferenceDetails>

### SQS List Message Move Tasks [#sqs-list-message-move-tasks]

List the most recent message move tasks for an Amazon SQS source queue

<ReferenceDetails>
  #### Input [#input-19]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `sourceArn` | string | Yes | ARN of the queue whose move tasks should be listed (e.g., arn:aws:sqs:us-east-1:123456789012:my-dlq) |
  | `maxResults` | number | No | Maximum move tasks to return, 1-10 (default 1) |

  #### Output [#output-19]

  | Parameter | Type | Description |
  | - | - | - |
  | `results` | array | Move tasks for the source queue |
  | ↳ `taskHandle` | string | Handle of the task, populated only while its status is RUNNING |
  | ↳ `status` | string | RUNNING, COMPLETED, CANCELLING, CANCELLED, or FAILED |
  | ↳ `sourceArn` | string | ARN of the source queue |
  | ↳ `destinationArn` | string | ARN of the destination queue, absent when redriving to source queues |
  | ↳ `maxNumberOfMessagesPerSecond` | number | Per-second throttle applied to the move |
  | ↳ `approximateNumberOfMessagesMoved` | number | Approximate number of messages moved so far |
  | ↳ `approximateNumberOfMessagesToMove` | number | Approximate number of messages still to move |
  | ↳ `failureReason` | string | Why the task failed, set only when the status is FAILED |
  | ↳ `startedTimestamp` | number | Epoch milliseconds when the task started |
  | `count` | number | Number of move tasks returned |
</ReferenceDetails>

### SQS Cancel Message Move Task [#sqs-cancel-message-move-task]

Cancel an in-progress Amazon SQS message move task

<ReferenceDetails>
  #### Input [#input-20]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `region` | string | Yes | AWS region (e.g., us-east-1) |
  | `accessKeyId` | string | Yes | AWS access key ID |
  | `secretAccessKey` | string | Yes | AWS secret access key |
  | `taskHandle` | string | Yes | Task handle returned by sqs\_start\_message\_move\_task or sqs\_list\_message\_move\_tasks. Only a RUNNING task can be cancelled |

  #### Output [#output-20]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Operation status message |
  | `approximateNumberOfMessagesMoved` | number | Approximate number of messages already moved before the task was cancelled |
</ReferenceDetails>