Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex API Gateway
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Создание API-шлюза
    • Изменение API-шлюза и его спецификации
    • Подключение домена
    • Удаление API-шлюза
    • Просмотр графика мониторинга
    • Просмотр журнала выполнения
  • Концепции
    • Взаимосвязь ресурсов сервиса
    • Расширения спецификации
      • Обзор
      • Статический ответ
      • Вызов функции
      • Обращение по HTTP
      • Интеграция с Object Storage
    • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
  • Справочник API
    • Аутентификация в API
    • gRPC
      • Обзор
      • ApiGatewayService
      • OperationService
    • REST
      • Обзор
      • ApiGateway
        • Обзор
        • create
        • delete
        • get
        • getOpenapiSpec
        • list
        • listAccessBindings
        • listOperations
        • setAccessBindings
        • update
        • updateAccessBindings
  • Вопросы и ответы
  1. Концепции
  2. Расширения спецификации
  3. Обзор

Обзор

  • Расширение x-yc-apigateway
    • Поддерживаемые параметры
    • Спецификация расширения
  • Расширение x-yc-apigateway-integration
    • Поддерживаемые параметры
    • Спецификация расширения

Расширение 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).
Подстановка параметров производится только в некоторых значениях, в зависимости от типа расширения.

В этой статье:
  • Расширение x-yc-apigateway
  • Поддерживаемые параметры
  • Спецификация расширения
  • Расширение x-yc-apigateway-integration
  • Поддерживаемые параметры
  • Спецификация расширения
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»