Invoke Lambda Functions with AWS CLI - Complete Guide

Table of Contents #

1. Synchronously Invoke Lambda Functions with the AWS CLI
2. Synchronously Invoke Lambda with a File Payload
3. Synchronously Invoke Different Versions of Lambda
4. Asynchronously Invoke Lambda Functions with AWS CLI

Synchronously Invoke Lambda Functions with the AWS CLI #

To invoke a lambda function synchronously, use the invoke command, passing it the function name, the payload and the output filename as parameters.

Copied!
aws lambda invoke --function-name testFunction --cli-binary-format raw-in-base64-out --payload '{"name": "John Smith"}' response.json

If you're on Windows, escape the double quotes of the --payload parameter, e.g. '{\"name\": \"John Smith\"}'.

We passed the following parameters to the invoke command.

The --payload parameter is the event the lambda function gets invoked with.

Here is the code for the Node.js lambda function I'll invoke with the next command.

Copied!
exports.handler = async (event) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify(`Hello ${event.name}!`),
    };
    return response;
};

By running the above command, I get the following output (stored in a response.json file).

Synchronously Invoke Lambda with a File Payload #

Sometimes the payload is too complex to be directly passed using the CLI.

To invoke a lambda function, passing it a file as a payload:

1. Create a file on your local system that stores valid json in the form of the event your lambda function expects.
2. Invoke the lambda function, passing it the file as the --payload parameter

Create a file called event.json with the following json in it.

Copied!
{
  "name": "John Doe"
}

Open your terminal in the directory where you stored the event.json file. Then invoke the lambda function, passing it the event.json file as the --payload.

Copied!
aws lambda invoke --function-name testFunction --cli-binary-format raw-in-base64-out --payload file://event.json response.json

Take a look at the response.json file to make sure the response matches your expectations.

For instance, if I update the code of my lambda function to respond with a 400 status code.

Copied!
exports.handler = async (event) => {
    const response = {
        statusCode: 400,
        body: JSON.stringify(`Hello ${event.name}!`),
    };
    return response;
};

The statusCode in the CLI response would still be 200.

However, the response.json file stores the lambda function's response with status code of 400.

Synchronously Invoke Different Versions of Lambda #

To invoke a specific version or an alias of a lambda function using the AWS CLI, pass the --qualifier parameter to the invoke command.

I've deployed a version 2 of the lambda function. The new version consists of the following code:

Copied!
exports.handler = async (event) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify(`Goodbye ${event.name}!`),
    };
    return response;
};

Let's invoke version 2 of the lambda function, passing it the --qualifier parameter:

Copied!
aws lambda invoke --function-name testFunction --cli-binary-format raw-in-base64-out --payload file://event.json --qualifier 2 response.json

The response shows that version 2 of the function ran.

Asynchronously Invoke Lambda Functions with AWS CLI #

When a lambda function is invoked asynchronously, the CLI doesn't wait for the function's response. The request is sent to lambda, which queues the events and sends them to the function.

We will invoke a lambda function that's written in Node.js and contains the following code.

Copied!
exports.handler = async (event) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify(`Favorite fruit: ${event.fruit}`),
    };
    return response;
};

To asynchronously invoke a lambda function with the AWS CLI, set the --invocation-type parameter to Event.

Copied!
aws lambda invoke --function-name testFunction --cli-binary-format raw-in-base64-out --invocation-type Event --payload '{"fruit": "tomato"}' response.json

If you are on Windows, you must escape the double quotes in the json string, e.g. '{\"fruit\": \"tomato\"}'.

We set the --invocation-type parameter to Event to mark the invocation as asynchronous.

The response.json file where the lambda function's response is stored is empty because the CLI returns instantly and doesn't wait for the function to respond.

We also set the --cli-binary-format parameter to raw-in-base64-out to be able to pass a raw json string as --payload.

All the other scenarios are the same as invoking a lambda function synchronously:

1. To invoke the function with a file, store valid json in a file on your local file system and prefix the --payload parameter with file://

Here is the event.json file I'll use for the next command.

Copied!
{
  "fruit": "avocado"
}

Open your terminal in the directory where the event.json file is stored and run the invoke command:

Copied!
aws lambda invoke --function-name testFunction --cli-binary-format raw-in-base64-out --invocation-type Event --payload file://event.json response.json

2. To invoke a specific version or an alias of the function, use the --qualifier parameter to specify the version of the function you want to invoke

Copied!
aws lambda invoke --function-name testFunction --cli-binary-format raw-in-base64-out --invocation-type Event --qualifier 2 --payload file://event.json response.json

Further Reading #

• Create a Lambda Function with AWS CLI - Complete Guide
• Create a Role with AWS CLI - Complete Guide
• View your AWS CLI logs in Real Time (tail)
• How to turn off the Pager in AWS CLI
• AWS CDK Tutorial for Beginners - Step-by-Step Guide
• How to use Parameters in AWS CDK