Menu
AWS SDK for JavaScript
Developer Guide for SDK version 2.122.0

Using Queues in Amazon SQS


                                        Relationship between JavaScript environments, the SDK, and Lambda

This Node.js example shows you how to:

  • Get a list of all of your message queues

  • Obtain the URL for a particular queue

  • Create and delete queues

The Scenario

In this example, a series of Node.js modules are used to work with queues. The Node.js modules use the SDK for JavaScript to use queues using these methods of the AWS.SQS client class:

For more information about Amazon SQS messages, see How Queues Work in the Amazon Simple Queue Service Developer Guide.

Prerequisite Tasks

To set up and run this example, you must first complete these tasks:

Configuring the SDK

Configure the SDK for JavaScript by creating a global configuration object, setting the region, and providing credentials for your code. In this example, the credentials are provided using the JSON file you created.

Copy
// Load the SDK for JavaScript var AWS = require('aws-sdk'); // Load credentials and set the region from the JSON file AWS.config.loadFromPath('./config.json');

Listing Your Queues

Create a Node.js module with the file name sqs_listqueues.js. Be sure to configure the SDK as previously shown. To access Amazon SQS, create an AWS.SQS service object. Create a JSON object containing the parameters needed to list your queues, which by default is an empty object. Call the listQueues method to retrieve the list of queues. The callback returns the URLs of all queues.

Copy
// Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Load credentials and set the region from the JSON file AWS.config.loadFromPath('./config.json'); // Create an SQS service object var sqs = new AWS.SQS({apiVersion: '2012-11-05'}); var params = {}; sqs.listQueues(params, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.QueueUrls); } });

To run the example, type the following at the command line.

Copy
node sqs_listqueues.js

This sample code can be found here on GitHub.

Creating a Queue

Create a Node.js module with the file name sqs_createqueue.js. Be sure to configure the SDK as previously shown. To access Amazon SQS, create an AWS.SQS service object. Create a JSON object containing the parameters needed to list your queues, which must include the name for the queue created. The parameters can also contain attributes for the queue, such as the number of seconds for which message delivery is delayed or the number of seconds to retain a received message. Call the createQueue method. The callback returns the URL of the created queue.

Copy
// Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Load credentials and set the region from the JSON file AWS.config.loadFromPath('./config.json'); // Create an SQS service object var sqs = new AWS.SQS({apiVersion: '2012-11-05'}); var params = { QueueName: 'SQS_QUEUE_NAME', Attributes: { 'DelaySeconds': '60', 'MessageRetentionPeriod': '86400' } }; sqs.createQueue(params, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.QueueUrl); } });

To run the example, type the following at the command line.

Copy
node sqs_createqueue.js

This sample code can be found here on GitHub.

Getting the URL for a Queue

Create a Node.js module with the file name sqs_getqueueurl.js. Be sure to configure the SDK as previously shown. To access Amazon SQS, create an AWS.SQS service object. Create a JSON object containing the parameters needed to list your queues, which must include the name of the queue whose URL you want. Call the getQueueUrl method. The callback returns the URL of the specified queue.

Copy
// Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Load credentials and set the region from the JSON file AWS.config.loadFromPath('./config.json'); // Create an SQS service object var sqs = new AWS.SQS({apiVersion: '2012-11-05'}); var params = { QueueName: 'SQS_QUEUE_NAME' }; sqs.getQueueUrl(params, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data.QueueUrl); } });

To run the example, type the following at the command line.

Copy
node sqs_getqueueurl.js

This sample code can be found here on GitHub.

Deleting a Queue

Create a Node.js module with the file name sqs_deletequeue.js. Be sure to configure the SDK as previously shown. To access Amazon SQS, create an AWS.SQS service object. Create a JSON object containing the parameters needed to delete a queue, which consists of the URL of the queue you want to delete. Call the deleteQueue method.

Copy
// Load the AWS SDK for Node.js var AWS = require('aws-sdk'); // Load credentials and set the region from the JSON file AWS.config.loadFromPath('./config.json'); // Create an SQS service object var sqs = new AWS.SQS({apiVersion: '2012-11-05'}); var params = { QueueUrl: 'SQS_QUEUE_URL' }; sqs.deleteQueue(params, function(err, data) { if (err) { console.log("Error", err); } else { console.log("Success", data); } });

To run the example, type the following at the command line.

Copy
node sqs_deletequeue.js

This sample code can be found here on GitHub.