Lambda handler function structure in AWS - Step-by-Step Execution

Process Flow - Lambda handler function structure

Event received

↓

Lambda handler invoked

↓

Process event data

↓

Perform logic or call services

↓

Return response or error

↓

Lambda execution ends

This flow shows how AWS Lambda receives an event, runs the handler function, processes data, and returns a response.

Execution Sample

AWS

def lambda_handler(event, context):
    message = event.get('message', 'Hello')
    return {'statusCode': 200, 'body': message}

A simple Lambda handler that reads a message from the event and returns it with a 200 status.

Process Table

Step	Action	Input	Output	Notes
1	Lambda receives event	{"message": "Hi"}	Invoke lambda_handler	Event triggers function
2	Extract message	event.get('message', 'Hello')	"Hi"	Reads 'message' key from event
3	Prepare response	statusCode=200, body='Hi'	{"statusCode": 200, "body": "Hi"}	Response formatted as dict
4	Return response	response dict	Function returns response	Lambda execution ends

💡 Function returns response dict, Lambda execution completes

Status Tracker

Variable	Start	After Step 2	After Step 3	Final
event	{"message": "Hi"}	{"message": "Hi"}	{"message": "Hi"}	{"message": "Hi"}
message	N/A	"Hi"	"Hi"	"Hi"
response	N/A	N/A	{"statusCode": 200, "body": "Hi"}	{"statusCode": 200, "body": "Hi"}

Key Moments - 3 Insights

Why do we use event.get('message', 'Hello') instead of event['message']?

Using event.get('message', 'Hello') safely returns 'Hello' if 'message' is missing, avoiding errors. See execution_table step 2 where message is extracted.

What is the role of the context parameter in the handler?

Context provides info about the Lambda execution environment but is not used here. The handler must accept it even if unused.

Why must the handler return a dictionary with statusCode and body?

This format is required for API Gateway integrations to understand the response. See execution_table step 3 for response preparation.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of 'message' after step 2?

A "Hello"

B None

C "Hi"

D Error

💡 Hint

Check the 'Output' column in step 2 of execution_table where message is extracted.

At which step does the Lambda function prepare the response dictionary?

A Step 3

B Step 2

C Step 1

D Step 4

💡 Hint

Look at the 'Action' column in execution_table for response preparation.

If the event did not have a 'message' key, what would 'message' be after step 2?

A "Hi"

B "Hello"

C None

D Error

💡 Hint

Refer to the default value in event.get('message', 'Hello') in the code sample.

Concept Snapshot

AWS Lambda handler is a function with two parameters: event and context.
It processes the event data and returns a response dictionary.
Use event.get() to safely access event keys.
Return format often includes statusCode and body for API Gateway.
The context parameter provides runtime info but can be unused.

Full Transcript

AWS Lambda runs a handler function when triggered by an event. The handler takes two inputs: event and context. The event contains data that triggered the function. The handler processes this data, often extracting values safely using event.get(). It then prepares a response, usually a dictionary with statusCode and body keys, and returns it. The context parameter provides information about the execution environment but is optional to use. The function ends after returning the response.

Practice

1. What are the two main parameters that every AWS Lambda handler function must accept?

easy

A. event and context

B. request and response

C. input and output

D. data and callback

Solution

1. Step 1: Understand Lambda handler inputs

   The AWS Lambda handler function always receives two parameters: event which contains the input data, and context which provides runtime information.

2. Step 2: Match parameters to options

   Only event and context correctly lists these two parameters as event and context.

3. Final Answer:

   event and context -> Option A

4. Quick Check:

   Lambda handler parameters = event and context [OK]

Hint: Remember: Lambda handler always gets event and context [OK]

Common Mistakes:

• Confusing event with request or input
• Using callback instead of context
• Swapping parameter names

2. Which of the following is the correct syntax for a Python AWS Lambda handler function?

easy

A. function handler(event, context) { return 'Hello World'; }

B. def handler(event, context): return 'Hello World'

C. lambda handler(event, context): print('Hello World')

D. def handler(): return 'Hello World'

Solution

1. Step 1: Identify Python function syntax

   In Python, functions are defined with def and must include parameters if expected. The handler must accept event and context.

2. Step 2: Check each option

   def handler(event, context): return 'Hello World' correctly defines a Python function with two parameters and returns a string. function handler(event, context) { return 'Hello World'; } is JavaScript syntax. lambda handler(event, context): print('Hello World') misuses lambda keyword. def handler(): return 'Hello World' lacks parameters.

3. Final Answer:

   def handler(event, context): return 'Hello World' -> Option B

4. Quick Check:

   Python Lambda handler syntax = def with event, context [OK]

Hint: Python Lambda handler uses def with event and context [OK]

Common Mistakes:

• Omitting event or context parameters
• Using JavaScript syntax in Python
• Misusing lambda keyword for handler

3. Given this Python Lambda handler code:

def handler(event, context):
    return {'statusCode': 200, 'body': event['message']}

What will be the output if the event is {'message': 'Hi'}?

medium

A. {'statusCode': 404, 'body': 'Hi'}

B. Error: KeyError 'message'

C. {'statusCode': 200, 'body': 'Hi'}

D. None

Solution

1. Step 1: Analyze the return statement

   The function returns a dictionary with statusCode set to 200 and body set to the value of event['message'].

2. Step 2: Substitute event value

   Given event = {'message': 'Hi'}, event['message'] is 'Hi'. So the return is {'statusCode': 200, 'body': 'Hi'}.

3. Final Answer:

   {'statusCode': 200, 'body': 'Hi'} -> Option C

4. Quick Check:

   Return body matches event message [OK]

Hint: Return uses event['message'] directly for body [OK]

Common Mistakes:

• Assuming wrong statusCode
• Expecting error when key exists
• Returning None by mistake

4. What is wrong with this AWS Lambda handler function in Python?

def handler(event):
    return 'Done'

medium

A. Missing the required context parameter

B. Return value must be a dictionary

C. Function name must be lambda_handler

D. No error, this is valid

Solution

1. Step 1: Check function parameters

   AWS Lambda handler functions must accept two parameters: event and context. This function only has event.

2. Step 2: Validate other options

   Return type can vary by trigger, so returning a string is allowed. Function name can be configured, so handler is acceptable. Hence, only missing context is an error.

3. Final Answer:

   Missing the required context parameter -> Option A

4. Quick Check:

   Lambda handler needs event and context parameters [OK]

Hint: Always include event and context parameters [OK]

Common Mistakes:

• Omitting context parameter
• Thinking return must be dict always
• Assuming fixed function name

5. You want your AWS Lambda handler to process an event with optional user key. If user is missing, return status 400 with message 'User missing'. Otherwise, return status 200 with 'Hello, <user>'. Which handler code correctly implements this?

hard

A. def handler(event):
if 'user' in event:
return {'statusCode': 400, 'body': 'User missing'}
return {'statusCode': 200, 'body': f"Hello, {event['user']}"}

B. def handler(event, context):
return {'statusCode': 200, 'body': f"Hello, {event['user']}"}

C. def handler(event, context):
if event['user'] == None:
return {'statusCode': 400, 'body': 'User missing'}
return {'statusCode': 200, 'body': 'Hello, user'}

D. def handler(event, context):
if 'user' not in event:
return {'statusCode': 400, 'body': 'User missing'}
return {'statusCode': 200, 'body': f"Hello, {event['user']}"}

Solution

1. Step 1: Check parameter correctness

   Lambda handler must have event and context parameters.

2. Step 2: Validate logic for user key

   def handler(event, context): if 'user' not in event: return {'statusCode': 400, 'body': 'User missing'} return {'statusCode': 200, 'body': f"Hello, {event['user']}"} correctly checks if 'user' key is missing and returns 400 with message. Then returns 200 with personalized greeting. def handler(event, context): return {'statusCode': 200, 'body': f"Hello, {event['user']}"} does not check for missing user. def handler(event, context): if event['user'] == None: return {'statusCode': 400, 'body': 'User missing'} return {'statusCode': 200, 'body': 'Hello, user'} incorrectly checks if event['user'] == None which causes error if key missing. def handler(event): if 'user' in event: return {'statusCode': 400, 'body': 'User missing'} return {'statusCode': 200, 'body': f"Hello, {event['user']}"} reverses logic and misses context.

3. Final Answer:

   def handler(event, context): if 'user' not in event: return {'statusCode': 400, 'body': 'User missing'} return {'statusCode': 200, 'body': f"Hello, {event['user']}" } -> Option D

4. Quick Check:

   Check key presence before access to avoid errors [OK]

Hint: Check key exists before access; include event and context [OK]

Common Mistakes:

• Missing context parameter
• Accessing missing keys without check
• Returning wrong status codes