python-programming-model-handler-types.md

AWS Lambda Function Handler in Python

At the time you create a Lambda function, you specify a handler, which is a function in your code, that AWS Lambda can invoke when the service executes your code. Use the following general syntax structure when creating a handler function in Python.

def handler_name(event, context): 
    ...
    return some_value

In the syntax, note the following:

• event – AWS Lambda uses this parameter to pass in event data to the handler. This parameter is usually of the Python dict type. It can also be list, str, int, float, or NoneType type.
• context – AWS Lambda uses this parameter to provide runtime information to your handler. This parameter is of the LambdaContext type.
• Optionally, the handler can return a value. What happens to the returned value depends on the invocation type you use when invoking the Lambda function:

  • If you use the RequestResponse invocation type (synchronous execution), AWS Lambda returns the result of the Python function call to the client invoking the Lambda function (in the HTTP response to the invocation request, serialized into JSON). For example, AWS Lambda console uses the RequestResponse invocation type, so when you invoke the function using the console, the console will display the returned value.

    If the handler returns NONE, AWS Lambda returns null.

  • If you use the Event invocation type (asynchronous execution), the value is discarded.

For example, consider the following Python example code.

def my_handler(event, context):
    message = 'Hello {} {}!'.format(event['first_name'], 
                                    event['last_name'])  
    return { 
        'message' : message
    }

This example has one function called my_handler. The function returns a message containing data from the event it received as input.