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. Обращение по HTTP

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

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

Расширение x-yc-apigateway-integration:http перенаправляет запрос в указанный URL.

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

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

Параметр Тип Описание
url string URL, по которому необходимо перенаправить вызов (должен быть доступен из интернета).
В url осуществляется подстановка параметров.
method enum Необязательный параметр. HTTP-метод, используемый для вызова. Если параметр не указан, используется метод запроса к API Gateway.
headers map[string]string HTTP-заголовки, которые будут переданы. Заголовки исходного запроса не передаются.
В headers осуществляется подстановка параметров.
timeouts object Необязательный параметр. read и connect таймауты для выполнения вызова, в секундах.

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

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

x-yc-apigateway-integration:
  type: http
  url: https://example.com/backend1
  method: POST
  headers:
    Authorization: Basic ZjTqBB3f$IF9gdYAGlMrs2fuINjHsz
  timeouts:
    connect: 0.5
    read: 5

Особенности расширения:

  • По умолчанию заголовки, кроме User-Agent, и параметры исходного запроса не передаются. Их необходимо указать в спецификации. Заголовок User-Agent передается, если не переопределен в спецификации.
В этой статье:
  • Поддерживаемые параметры
  • Спецификация расширения
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»