Lambda with Amazon API Gateway

 AWS Lambda function can be invoked on HTTPS url. It can be done on GET, POST, PUT. When the HTTPS url is invoked, the AWS Lambda function can also triggered and the data passed to HTTPS using get/post can be made available inside AWS Lambda to be used to insert in DynamoDB or to send mail etc.

This chapter discusses in detail about various processes involved in work in with AWS lambda and API Gateway.

Processes involved

The following are the processes involved in working with AWS lambda and API Gateway −

  • Create IAM role for permission
  • Create AWS lambda function
  • Create API Gateway
  • Link lambda function to api gateway
  • Passing data to api gateway

A basic diagram that explains the working of API gateway and AWS Lambda is given here −

Processes Involved

These processes are explained in detail further in this chapter with relevant screenshots.

Create IAM role for permission

From Amazon services as shown below, select IAM for creating roles to be used by Lambda function.

Create Iam

Go to IAM and select Roles from left side section as shown below −

Dashboard Menu

Click Create role for Lambda function.

Additional resources

Select Lambda and click Permissions at the bottom. Select the permission required for the API Gateway and Lambda.

Select Type

Search for API gateway in the search and it will list you all the related permissions. Here we have chosen full access to API gateway as shown below −

Attach Permission

Now, search for API gateway and it will list you all the related permissions. Here we have chosen full access to API gateway as shown below −

Api Gateway

You have to repeat the same process for Policies also.

Policies

Once you are done choosing the necessary policies, click Review for the next step. Enter the name of the role as per your choice as shown below −

Review

It displays the policies attached to the role. Click Create role and we are done with the role creation and can proceed with the lambda function.

Create AWS Lambda Function

Go to AWS services and click on lambda service to create a function for connecting it with api gateway.

Compute

The UI screen for Lambda function is shown below. Click Create function button to proceed with creation of Lambda function.

UI Screen

Enter the name of the function and choose the existing role which we have created above.

Enter Name

It flashes a message that the function with the name lambdawithapigateway is created successfully.

Lambda Gateway

Note that here we will use nodejs runtime to write the code. The AWS code with helloworld message is as shown below −

Environment

AWS Lambda code is present in index.js file. The function called handler has the params namely events, context and callback.

Callback function basically has the error and the success message. Note that here we do not have any error related code, so null is passed and the success message is HelloWorld from lambda.

Lastly, save the changes added and let us proceed to add the Lambda function to the API gateway.

Create API Gateway

Login to your AWS account and open API Gateway as shown below −

Content Delivery

Click API Gateway and it will lead you to the screen where new API gateway can be created.

Amazon Gateway

Click Create API and add details as shown below −

Create New

Click the Create API button on right side of the screen. This will display the newly created API on to left side of the screen.

Create New Api

Click the Actions dropdown to create a new resource for the API.

Action Dropdown

Now, create a new resource as shown below −

Resource Group

Enter the Resource Name as shown below. You will see the name of the resource entered in the url created at the end. Click Create Resource and you will see it on the screen as follows −

Child Resource

Resource Service

Add GET/POST methods to the resource created as shown below. Select the method from Actions dropdown.

Get Method

Click the GET method to add the method to the API.

Api Method

Next step is the integration which will integrate it with Lambda function. Now add the Lambda function to it as shown below −

Get Setup
Link Lambda Function to API Gateway

Select the lambda function created earlier.

hello Setup

Save the changes and you can see a dialog box asking for permission as shown below −

Add Permission

Click OK for the permission. This is the execution details between the API gateway HTTP request and the Lambda function −

Method Execution

Now, let us deploy the API gateway changes. For this purpose, we need to select the Deploy API from Actions dropdown as shown below −

Deploy Api

Select Deploy API. It will ask for the deployment state. Select New Stage from Deployment stage dropdown and add the stage name as Production.

Select Deploy

Click Deploy button and it will redirect you to the url as shown below −

Click Deploy

Select the GET method from left side to get the url. Open the url in a new tab to see the message from Lambda function.

Select Get

This is a basic example of working with AWS Lambda and AWS API Gateway. In the above example, we have hardcoded the message in Lambda function.

Now, let us take the message details from the API Gateway. Incase if the HTTPS call has to be called from a different domain, for example AJAX call to the API, we need to enable CORS for the API gateway created.

Select the reSource created for the API and click Actions dropdown −

Hello Method

Now, Enable CORS will open up the following screen −

Enable Cors

You can use few methods to ENABLE CORS. Access-Control-Allow-Origin is marked as * which means it will allow to get contents from API gateway from any domain.

You can also specify the domain name you want to work with the API. Click Enable CORS and replace existing CORS headers button and it will display confirmation message as shown below −

Conform Method

Click Yes, replace existing values button to enable it. The Enable CORS screen looks as shown below −

Replace Existing Values
Passing Data to API Gateway

Open the API created in API Gateway displayhelloworld as shown below −

Passing Data

Click Integration Request to send data as shown below −

Integration Request

Choose Body Mapping Templates and add the Content-Type for this example as application/json. Click on the content type added add the details as follows −

Body Mapping

Now, add the template in JSON format as shown below −

Json

Observe that we have taken the message as the parameter to get data from API Gateway and share it with AWS Lambda. The syntax to get the details is as shown above.

Now, deploy the API to make the changes available on the API Gateway URL. For this, we need to change Lambda function to display the data based on the API Gateway URL. The code for Lambda function is givn below. Note that we are taking the message from the event and passing to callback.

exports.handler = (event, context, callback) => {
   let message = event.message;
   callback(null, message);
};

Now, save the changes in Lambda and hit the URL to see the changes. Observe the screenshot given below −

Observe Screenshot

Click the URL as shown below −

https://rw2ek1xung.execute-api.us-east-
1.amazonaws.com/prod/hello?message=hello%20from%20api%20gateway

Observe that here we are passing message as query string to the GET url. Then you can observe the output as shown below −

Passing Message

It reads the details sent to message from the URL and displays the same in the browser.

Comments

Post a Comment

Popular posts from this blog

LINUX Move and copy files using SSH

Often you will need to move one or more files/folders or copy them to a different location. You can do so easily using an SSH connection. The commands which you would need to use are mv (short from move) and cp (short from copy). The mv command syntax looks like this: mv configuration.php-dist configuration.php By issuing the above command we will move (rename) the file configuration.php-dist to configuration.php. You can also use mv to move a whole directory and its content: mv includes/* ./ This will move all files (and folders) in the includes/ directory to the current working directory. In some cases however, we will need to only update the files and move only files that were changed, which we can do by passing ‘ -u ’ as argument to the command: mv -u includes/* admin/includes The copy (cp) command works the same way as mv, but instead of moving the files/folders it copies them. For example: cp configuration.php-dist configuration.php The command will copy the co
Read more

PHP Predefined Variables

PHP provides a large number of predefined variables to any script which it runs.PHP provides an additional set of predefined arrays containing variables from the web server the environment, and user input. These new arrays are called superglobals: All the following variables are automatically available in every scope. PHP Superglobals: Variable Description $GLOBALS Contains a reference to every variable which is currently available within the global scope of the script. The keys of this array are the names of the global variables. $_SERVER This is an array containing information such as headers, paths, and script locations. The entries in this array are created by the web server. There is no guarantee that every web server will provide any of these. See next section for a complete list of all the SERVER variables. $_GET An associative array of variables passed to the current script via the HTTP GET method. $_POST An associative array of variable
Read more

Java : Variables Declaring

[1]. Java Variables Variables are containers for storing data values. In Java, there are different types of variables, for example: String - stores text, such as "Hello". String values are surrounded by double quotes int - stores integers (whole numbers), without decimals, such as 123 or -123 float - stores floating point numbers, with decimals, such as 19.99 or -19.99 char - stores single characters, such as 'a' or 'B'. Char values are surrounded by single quotes boolean - stores values with two states: true or false [2]. Declaring (Creating) Variables To create a variable, you must specify the type and assign it a value: Syntax type variable = value ; Where type is one of Java's types (such as int or String), and variable is the name of the variable (such as x or name). The equal sign is used to assign values to the variable. To create a variable that should store text, look at the following example: Example Create a variable called  name  of type  Stri
Read more