Configuring a queue to trigger an Amazon Lambda function (console) - Amazon Simple Queue Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Configuring a queue to trigger an Amazon Lambda function (console)

You can use an Amazon Lambda function to process messages in an Amazon SQS queue. Lambda polls the queue and invokes your Lambda function synchronously with an event that contains queue messages. To allow your function time to process each batch of records, set the source queue's visibility timeout to at least six times the timeout that you configure on your function. The extra time allows for Lambda to retry if your function is throttled while processing a previous batch.

You can specify another queue to act as a dead-letter queue for messages that your Lambda function can't process.

A Lambda function can process items from multiple queues (using one Lambda event source for each queue). You can use the same queue with multiple Lambda functions.

If you associate an encrypted queue with a Lambda function but Lambda doesn't poll for messages, add the kms:Decrypt permission to your Lambda execution role.

Note the following restrictions:

  • Your queue and the Lambda function must be in the same Amazon Region.

For information about implementing the Lambda function, see Using Amazon Lambda with Amazon SQS in the Amazon Lambda Developer Guide.

Prerequisites

To configure Lambda function triggers, you must meet the following requirements:

  • If you use a user, your Amazon SQS role must include the following permissions:

    • lambda:CreateEventSourceMapping

    • lambda:ListEventSourceMappings

    • lambda:ListFunctions

  • The Lambda execution role must include the following permissions:

    • sqs:DeleteMessage

    • sqs:GetQueueAttributes

    • sqs:ReceiveMessage

  • If you associate an encrypted queue with a Lambda function, add the kms:Decrypt permission to the Lambda execution role.

For more information, see Overview of managing access in Amazon SQS.

To configure a queue to trigger a Lambda function (console)
  1. Open the Amazon SQS console at https://console.amazonaws.cn/sqs/.

  2. In the navigation pane, choose Queues.

  3. On the Queues page, choose the queue to configure.

  4. On the queue's page, choose the Lambda triggers tab.

  5. On the Lambda triggers page, choose a Lambda trigger.

    If the list doesn't include the Lambda trigger that you need, choose Configure Lambda function trigger. Enter the Amazon Resource Name (ARN) of the Lambda function or choose an existing resource. Then choose Save.

  6. Choose Save. The console saves the configuration and displays the Details page for the queue.

    On the Details page, the Lambda triggers tab displays the Lambda function and its status. It takes approximately 1 minute for the Lambda function to become associated with your queue.

  7. To verify the results of the configuration, send a message to your queue and then view the triggered Lambda function in the Lambda console.