Обзор
Расширение x-yc-apigateway
Расширение x-yc-apigateway
позволяет задать верхнеуровневые параметры API-шлюза, значения которых будут наследоваться вложенными расширениями.
Поддерживаемые параметры
В таблице ниже перечислены параметры, специфичные для API-шлюза сервиса API Gateway. Описание остальных параметров читайте в спецификации OpenAPI 3.0.
Параметр | Тип | Описание |
---|---|---|
service_account_id |
string |
Идентификатор сервисного аккаунта, от имени которого API-шлюз будет выполнять операции. |
Спецификация расширения
x-yc-apigateway:
service_account_id: <ID сервисного аккаунта>
Расширение x-yc-apigateway-integration
Расширение x-yc-apigateway-integration
— это точка входа для интеграции API-шлюза с другими сервисами.
Поддерживаемые параметры
В таблице ниже перечислены параметры, специфичные для API-шлюза сервиса API Gateway. Описание остальных параметров читайте в спецификации OpenAPI 3.0.
Параметр | Тип | Описание |
---|---|---|
type |
string |
Тип расширения. Доступные значения: dummy , cloud_functions , http , object_storage , cloud_datasphere , cloud_datastreams и serverless_containers . |
Спецификация расширения
<Запрос>:
<Метод>:
x-yc-apigateway-integration:
type: <Тип>
<Список параметров в виде пары ключ: значение>
Содержимое расширения меняется в зависимости от указанного типа (type
) в блоке x-yc-apigateway-integration
:
- dummy — возвращает фиксированное содержимое с указанным кодом ответа и необходимыми заголовками без участия стороннего сервиса.
- cloud_functions — вызывает указанную функцию, передавая ей на вход информацию об HTTP-запросе, и возвращает клиенту результат выполнения этой функции.
- http — перенаправляет запрос в указанный URL.
- object_storage — передает обработку запроса в Object Storage с целью раздачи статических файлов.
- cloud_datasphere — вызывает указанную ноду DataSphere, передавая ей тело запроса со значениями входных переменных, и возвращает результат выполнения ноды в теле ответа.
- cloud_datastreams — обращается к Yandex Data Streams для выполнения операции с указанным потоком.
- serverless_containers — перенаправляет запрос в указанный контейнер.
- cloud_ymq — обращается к Yandex Message Queue для выполнения операции с указанной очередью.
Все типы поддерживают подстановку параметров — замену всех ключей на соответствующее значение. Ключ должен быть определен как параметр соответствующей операции (допускаются все типы параметров, определенные в OpenAPI-Specification — path
, query
, header
, cookie
).
Подстановка параметров производится только в некоторых значениях, в зависимости от типа расширения.