First commit

Author: alfonsof

awslambdahttprequest/README.md

@@ -0,0 +1,95 @@
+# AWS Lambda Function Http Request Python example
+
+This folder contains an AWS Lambda Function example in Python on AWS (Amazon Web Services).
+
+It handles an AWS Lambda function that it is invoked by an http request. It shows the parameters of the request and reponds a message including the parameters.
+
+## Requirements
+
+* You must have an [Amazon Web Services (AWS)](http://aws.amazon.com/) account.
+
+* The code was written for Python 3.
+
+## Using the code
+
+* Access the AWS console.
+
+* Select AWS Lambda in the services menu.
+
+* Create an AWS lambda function.
+  * Name: `<LAMBDA_NAME>`
+  * Runtime: `Python 3.8`
+  * Handler: `lambda_function.lambda_handler`
+  * Role: `lambda-basic-execution`
+  * Runtime Settings for the lambda function:
+    * Memory (MB): `128`
+    * Timeout: `3 sec`
+  * The resources that the function's role has access to:
+    * `Amazon CloudWatch Logs`
+
+* Write the code of the Lambda funtion.
+
+  The content of `lambda_function.py` file.
+
+* Deploy the Lambda function.
+
+  It deploys the Lambda function to AWS.
+
+* Create an `API Gateway` trigger.
+
+  This allows to call the lambda function using an HTTP API.
+
+  * Name: `<LAMBDA_NAME>-API`
+  * API: `Create an API`
+  * API type: `HTTP API`
+  * Security: `Open`
+
+  You will get an API endpoint, which can be copied and run in your browser's address bar.
+  
+  It looks like the following URL:
+  
+  ```bash
+  https://<API_ID>.execute-api.<REGION>.amazonaws.com/<STAGE_NAME>/<LAMBDA_NAME>
+  ```
+
+  For example:
+
+  ```bash
+  https://abcdefg5jk.execute-api.eu-west-1.amazonaws.com/default/HttpRequestPython`
+  ```
+
+* Run the code.
+
+  To run the code, you need to use 2 parameters:
+
+  * `first_name`
+  * `last_name`
+
+  You call the API endpoint with this format: 
+  
+  ```bash
+  https://<API_ID>.execute-api.<REGION>.amazonaws.com/<STAGE_NAME>/<LAMBDA_NAME>?first_name=<FIRST_NAME>&last_name=<LAST_NAME>
+  ```
+
+  For example:
+
+  ```bash
+  https://abcdefg5jk.execute-api.eu-west-1.amazonaws.com/default/HttpRequestPython?first_name=Peter&last_name=Parker
+  ```
+
+* Test the AWS Lambda function.
+
+  Go to the URL of API endpoint that you have got: `https://<API_ID>.execute-api.<REGION>.amazonaws.com/<STAGE_NAME>/<LAMBDA_NAME>?first_name=Peter&last_name=Parker` using a browser.
+
+  You should see the next response if you have added the right paramenters:
+
+  ```bash
+  "Hello Peter Parker!"
+  ```
+
+  You should see the next response if you do not have added any paramenter:
+
+  ```bash
+  "Who are you?"
+  ```
+  

awslambdahttprequest/lambda_function.py

@@ -0,0 +1,25 @@
+# lamdda_function.py
+# It handles an AWS Lambda function that it is invoked by an http request.
+# It shows the parameters of the request and reponds a message including the parameters.
+
+import json
+
+def lambda_handler(event, context):
+    if 'queryStringParameters' in event:    # If parameters
+        print(event['queryStringParameters']['first_name'])
+        print(event['queryStringParameters']['last_name'])
+        body = 'Hello {} {}!'.format(event['queryStringParameters']['first_name'], 
+                                    event['queryStringParameters']['last_name'])  
+    else:    # If no parameters
+        print('No parameters!')
+        body = 'Who are you?'
+        
+    return {
+        'statusCode': 200,
+        'body': json.dumps(body)
+    }
+
+# https://oesnotu7ne.execute-api.eu-west-1.amazonaws.com/default/HttpRequestPython?first_name=Peter&last_name=Parker
+
+
+{'version': '2.0', 'routeKey': 'GET /HttpRequestPython', 'rawPath': '/default/HttpRequestPython', 'rawQueryString': 'first_name=Peter&last_name=Parker', 'headers': {'accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8', 'accept-encoding': 'gzip, deflate, br', 'accept-language': 'es-ES,es;q=0.8,en-US;q=0.5,en;q=0.3', 'cache-control': 'max-age=0', 'content-length': '0', 'host': 'oesnotu7ne.execute-api.eu-west-1.amazonaws.com', 'upgrade-insecure-requests': '1', 'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:89.0) Gecko/20100101 Firefox/89.0', 'x-amzn-trace-id': 'Root=1-60edae76-099272b12272fd32162fc1ee', 'x-forwarded-for': '87.125.176.151', 'x-forwarded-port': '443', 'x-forwarded-proto': 'https'}, 'queryStringParameters': {'first_name': 'Peter', 'last_name': 'Parker'}, 'requestContext': {'accountId': '617184998144', 'apiId': 'oesnotu7ne', 'domainName': 'oesnotu7ne.execute-api.eu-west-1.amazonaws.com', 'domainPrefix': 'oesnotu7ne', 'http': {'method': 'GET', 'path': '/default/HttpRequestPython', 'protocol': 'HTTP/1.1', 'sourceIp': '87.125.176.151', 'userAgent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:89.0) Gecko/20100101 Firefox/89.0'}, 'requestId': 'CagyliOujoEEJmg=', 'routeKey': 'GET /HttpRequestPython', 'stage': 'default', 'time': '13/Jul/2021:15:17:10 +0000', 'timeEpoch': 1626189430751}, 'isBase64Encoded': False}