Delivers up to ten messages to the specified queue. This is a batch version of
SendMessage. For a FIFO queue, multiple messages within a single batch
are enqueued in the order they are sent.
The result of sending each message is reported individually in the response. Because
the batch request can result in a combination of successful and unsuccessful actions,
you should check for batch errors even when the call returns an HTTP status code of
The maximum allowed individual message size and the maximum total payload size (the sum of the individual lengths of all of the batched messages) are both 256 KB (262,144 bytes).
A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:
Any characters not included in this list will be rejected. For more information, see the W3C specification for characters.
If you don't specify the
DelaySeconds parameter for an entry, Amazon
SQS uses the default value for the queue.
Some actions take lists of parameters. These lists are specified using the
notation. Values of
n are integers starting from 1. For example, a parameter
list with two elements looks like this:
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginSendMessageBatch and EndSendMessageBatch. For Unity the operation does not take CancellationToken as a parameter, and instead takes AmazonServiceCallback<SendMessageBatchRequest, SendMessageBatchResponse> and AsyncOptions as additional parameters.
public abstract Task<SendMessageBatchResponse> SendMessageBatchAsync( String queueUrl, List<SendMessageBatchRequestEntry> entries, CancellationToken cancellationToken )
The URL of the Amazon SQS queue to which batched messages are sent. Queue URLs are case-sensitive.
A list of SendMessageBatchRequestEntry items.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
|BatchEntryIdsNotDistinctException||Two or more batch entries in the request have the same Id.|
|BatchRequestTooLongException||The length of all the messages put together is more than the limit.|
|EmptyBatchRequestException||The batch request doesn't contain any entries.|
|InvalidBatchEntryIdException||The Id of a batch entry in a batch request doesn't abide by the specification.|
|TooManyEntriesInBatchRequestException||The batch request contains more entries than permissible.|
|UnsupportedOperationException||Error code 400. Unsupported operation.|
Supported in: 1.3
Supported in: 4.5
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms
Supported Versions: 4.6 and above
Supported Platforms: Android, iOS, Standalone