Menu
Open source

sendMessage

SQSClient.sendMessageBatch(queueUrl, entries) delivers up to ten messages to the specified Amazon Simple Queue Service (SQS) queue.

Parameters

NameTypeDescription
queueUrlstringThe URL of the Amazon SQS queue to which a message is sent. Queue URLs and names are case-sensitive.
entriesSendMessageBatchEntryA list of up to ten messages to send.

SendMessageBatchEntry

NameTypeDescription
messageIdstringThe identifier of the batch entry message.
messageBodystringThe message to send. The minimum size is one character. The maximum size is 256 KB.
messageOptions?SendMessageOptions>) (optional)Options for the request.

Returns

TypeDescription
Promise<[MessageBatchResponse](#messagebatchresponse)>A Promise that fulfills with a batch message creation response.

MessageBatchResponse

NameTypeDescription
successfulobject[]A list of succesful messages as objects containing an id string property holding the unique identifier for the message, and a bodyMD5 string property holding the MD5 digest of the non-URL-encoded message body string..
failedSQSServiceError[]A list of error responses.

Example

JavaScript
import exec from 'k6/execution';

import {
  AWSConfig,
  SQSClient,
} from 'https://jslib.k6.io/aws/0.12.3/sqs.js';

const awsConfig = new AWSConfig({
  region: __ENV.AWS_REGION,
  accessKeyId: __ENV.AWS_ACCESS_KEY_ID,
  secretAccessKey: __ENV.AWS_SECRET_ACCESS_KEY,
  sessionToken: __ENV.AWS_SESSION_TOKEN,
});

const sqs = new SQSClient(awsConfig);
const testQueue = 'https://sqs.us-east-1.amazonaws.com/000000000/test-queue';

export default async function () {
  // If our test queue does not exist, abort the execution.
  const queuesResponse = await sqs.listQueues();
  if (queuesResponse.queueUrls.filter((q) => q === testQueue).length == 0) {
    exec.test.abort();
  }

  // Prepare a bunch of batch messages to add to the queue
  const messageBatch = [
    { messageId: '0', messageBody: 'test0' },
    { messageId: '1', messageBody: 'test1' },
  ];

  // Send the batch of messages to the queue
  await sqs.sendMessageBatch(testQueue, messageBatch);
}