Обработчик запросов функции на Python

Обработчик запросов — это метод, который используется для обработки каждого вызова функции на Python. При создании версии функции необходимо указать точку входа, которая состоит из имени файла и имени обработчика запросов (например, main.handler).

При вызове обработчика среда выполнения передает следующие аргументы:

1. Тело запроса (параметр event):

   • Если тело запроса — JSON-документ, то оно будет преобразовано в dict c помощью метода json.loads.
   • Если функция была вызвана с параметром строки запроса integration=raw, тело HTTP-запроса передается в функцию как есть, без обработки.

2. Контекст вызова (параметр context).

   Контекст содержит необходимую информацию о версии функции. Структура этого объекта описана в разделе Контекст вызова функции на Python.

Виды обработчика

Функция может использовать как синхронный, так и асинхронный обработчик.

Синхронный обработчик

Чтобы вернуть результат выполнения, используйте оператор return или сигнализируйте об исключении с помощью оператора raise. Синхронная функция обязана возвращать результат или завершаться исключением.

Асинхронный обработчик

Обработчик может быть асинхронной функцией async def. В этом случае вы можете использовать следующие операторы:

• return — возвращает ответ функции.
• raise — сообщает среде выполнения об ошибке.
• await — отслеживает выполнение вызова асинхронных функций.

Подробнее о разработке с помощью async/await читайте в соответстующем разделе документации.

Примеры

Вывод структуры HTTP-запроса

Следующая функция выводит структуру запроса и контекста вызова одновременно и в журнал выполнения, и в ответ функции:

import json


def handler(event, context):
    return {
        'statusCode': 200,
        'body': json.dumps({
            'event': event,
        }),
    }