Импорт API gRPC (предварительная версия)

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: Разработчик | Премиум

В этой статье показано, как импортировать определение службы gRPC в качестве API в Управление API. Затем вы можете управлять API в Управление API, безопасного доступа и применять другие политики, а также передавать запросы API gRPC через шлюз в серверную часть gRPC.

Чтобы добавить API gRPC в Управление API, необходимо выполнить следующие действия.

  • Отправьте файл определения protobuf (буфер протокола) API в Управление API
  • Укажите расположение службы gRPC
  • Настройка API в Управление API

Управление API поддерживает сквозную передачу со следующими типами методов службы gRPC: унарная, потоковая передача сервера, потоковая передача клиентов и двунаправленная потоковая передача. Общие сведения о gRPC см. в разделе "Общие сведения о gRPC".

Примечание.

  • Импорт API gRPC находится в предварительной версии. В настоящее время API gRPC поддерживаются только в локальном шлюзе, а не в управляемом шлюзе для вашего экземпляра Управление API.
  • В настоящее время тестирование API gRPC не поддерживается в тестовой консоли портал Azure или на портале разработчика Управление API.

Необходимые компоненты

  • Экземпляр управления API. Если у вас еще нет одного, выполните следующее краткое руководство. Создайте экземпляр Azure Управление API.

  • Ресурс шлюза, подготовленный в вашем экземпляре. Если у вас еще нет шлюза, см. статью "Подготовка локального шлюза в Azure Управление API".

  • Файл gRPC Protobuff (PROTO) доступен локально и служба gRPC, доступная по протоколу HTTPS.

Добавление API gRPC

  1. Перейдите к экземпляру Управления API на портале Azure.

  2. В меню слева выберите API>+ Добавить API.

  3. В разделе "Определение нового API" выберите gRPC.

    Снимок экрана: создание API gRPC на портале.

  4. В окне "Создание API gRPC" выберите "Полный".

  5. Для API gRPC необходимо указать следующие параметры:

    1. В разделе "Отправка схемы" выберите локальный proto-файл, связанный с API для импорта.

    2. В URL-адресе сервера gRPC введите адрес службы gRPC. Адрес должен быть доступен по протоколу HTTPS.

    3. В шлюзах выберите ресурс шлюза, который требуется использовать для предоставления API.

      Внимание

      В общедоступной предварительной версии можно выбрать только локальный шлюз. Управляемый шлюз не поддерживается.

  6. Введите оставшиеся параметры для настройки API. Эти параметры описаны в руководстве по импорту и публикации первого руководства по API .

  7. Нажмите кнопку создания.

    API добавляется в список API . Вы можете просмотреть параметры, перейдя на вкладку Параметры API.

Добавление других интерфейсов API

Вы можете составить API из API, предоставляемых различными службами, включая:

  • Спецификация OpenAPI
  • A SOAP API
  • A GraphQL API
  • Веб-приложение, размещенное в Службе приложений Azure
  • Приложение-функция Azure
  • Приложения логики Azure
  • Azure Service Fabric

Добавьте другой API к уже существующему API, выполнив следующие действия.

Примечание.

После импорта другого API операции добавляются к текущему API.

  1. Перейдите в свой экземпляр службы "Управление API" на портале Azure.

    Перейдите к экземпляру управления API Azure

  2. Выберите API на странице Обзор или в меню слева.

    Выберите API

  3. Щелкните ...рядом с API, к которому нужно добавить другой API.

  4. В раскрывающемся меню выберите Импорт.

    Выберите импорт

  5. Выберите службу, из которой следует импортировать API.

    Выбор службы