Обзор
Расширение 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 . |
Спецификация расширения
<Запрос>:
<Метод>:
x-yc-apigateway-integration:
type: <Тип>
<Список параметров в виде пары ключ: значение>
Содержимое расширения меняется в зависимости от указанного типа (type
) в блоке x-yc-apigateway-integration
:
- dummy — возвращает фиксированное содержимое с указанным кодом ответа и необходимыми заголовками без участия стороннего сервиса.
- cloud_functions — вызывает указанную функцию, передав ей на вход информацию об HTTP-запросе, и возвращает клиенту результат выполнения этой функции.
- http — перенаправляет запрос в указанный URL.
- object_storage — передает обработку запроса в Object Storage с целью раздачи статических файлов.
Все типы поддерживают подстановку параметров — замену всех ключей на соответствующее значение. Ключ должен быть определен как параметр соответствующей операции (допускаются все типы параметров, определенные в OpenAPI-Specification — path
, query
, header
, cookie
).
Подстановка параметров производится только в некоторых значениях, в зависимости от типа расширения.