Подключиться
Yandex Cloud Functions

Контекст вызова

Статья создана

Контекст вызова — это объект, который принимается обработчиком запросов в качестве второго аргумента.

Контекст вызова содержит дополнительную информацию о свойствах версии функции:

  • functionName — идентификатор функции;
  • functionVersion — идентификатор версии функции;
  • memoryLimitInMB — объем памяти, указанный при создании версии, МБ;
  • requestId — идентификатор обрабатываемого запроса;
  • token — параметры для аутентификации в API сервисов Yandex.Cloud.

Контекст также содержит вспомогательные методы:

  • getRemainingTimeInMillis() — возвращает время, оставшееся на выполнение текущего запроса в миллисекундах;
  • getPayload() — возвращает тело запроса, если используется HTTP-интеграция. По умолчанию HTTP-интеграция используется для всех вызовов функции, если не указан параметр integration=raw.

Использование контекста вызова

С помощью контекста вызова вы можете аутентифицироваться в API сервисов Yandex.Cloud, а также управлять получением тела HTTP-запроса (параметр body).

Аутентификация в API сервисов Yandex.Cloud

Если в функции указан сервисный аккаунт, то параметр token содержит информацию для аутентификации от имени этого сервисного аккаунта:

  • access_token — IAM-токен;
  • expires_in — время жизни токена в секундах;
  • token_type — тип токена (Bearer).

Также данную информацию можно получить с помощью сервиса метаданных. Подробнее об этом способе читайте в разделе Аутентификация изнутри виртуальной машины.

Получение тела запроса

getPayload() — это вспомогательный метод, который упрощает получение тела запроса (параметр body). В зависимости от содержимого тела запроса и заголовка, функция обрабатывает данные разными методами:

  • Если в качестве тела запроса был передан JSON-документ и был установлен заголовок Content-Type: application/json, функция возвращает результат выполнения метода JSON.parse над данными, которые были переданы в теле запроса.
  • Если в качестве тела запроса были переданы параметры формы и был установлен заголовок Content-Type: application/x-www-form-urlencoded, функция возвращает результат выполнения метода querystring.parse: объект, содержащий ключи полей и переданные значения.