Расширение x-yc-apigateway-integration:cloud_functions

Поддерживаемые параметры
Спецификация расширения

Расширение x-yc-apigateway-integration:cloud_functions вызывает указанную функцию. В качестве входных данных функция получает информацию о HTTP-запросе и значения параметров, указанных в спецификации, на выходе клиенту возвращается результат выполнения функции. Информация о запросе передается в том же формате, что и в текущей версии HTTP-интеграции при вызове функции с указанием параметра строки запроса integration=raw, который по большей части совместим с форматом AWS API Gateway. Значения параметров, указанных в спецификации, передаются в поле params параметра data.

Поддерживаемые параметры

В таблице ниже перечислены параметры, специфичные для API-шлюза сервиса API Gateway. Описание остальных параметров читайте в спецификации OpenAPI 3.0.

Параметр	Тип	Описание
`function_id`	`string`	Идентификатор функции.
`tag`	`string`	Необязательный параметр. Тег версии функции. Значение по умолчанию — `$latest`. В `tag` осуществляется подстановка параметров.
`service_account_id`	`string`	Идентификатор сервисного аккаунта для авторизации при обращении к функции. Если параметр не указан, используется значение верхнеуровнего параметра `service_account_id`. Если верхнеуровнего параметра тоже нет, функция вызывается без авторизации.

Спецификация расширения

Пример спецификации:

/example/{ID}:
    get:
      summary: Get ID
      operationId: getID
      tags:
        - example
      parameters:
        - name: ID
          in: path
          description: Return ID
          required: true
          schema:
            type: string
      x-yc-apigateway-integration:
        type: cloud_functions
        function_id: b095c95icnvbuf4v755l
        tag: "$latest"
        service_account_id: ajehfe41hhliq4n93q1g

Пример функции:

exports.handler= async function (data, context) {
    return {
        'statusCode': 200,
        'isBase64Encoded': false,
        'body': JSON.stringify({
            'petId': data.params.ID
        }),
    }
};