Поделиться через

Импорт API gRPC

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

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

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

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

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

Примечание.

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

Предварительные условия

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

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

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

Добавьте API gRPC

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

  2. В разделе API в боковом меню выберите API.

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

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

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

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

    1. Введите отображаемое имя.

    2. Чтобы отправить схему, выберите локальный proto-файл , связанный с API для импорта.

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

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

      Внимание

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

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

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

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

Использование .NET для вызова служб gRPC

Сведения о вызове служб gRPC с помощью .NET см. в следующих статьях:

Добавление других API

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

  • Спецификация OpenAPI
  • SOAP API (интерфейс программирования приложений на основе SOAP)
  • Графический интерфейс программы GraphQL
  • Веб-приложение, размещенное в службе приложений Azure
  • Функции Azure
  • Приложения логики Azure
  • Azure Service Fabric

Примечание.

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

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

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

    снимок экрана со страницей служб управления API.

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

    снимок экрана, на котором показан выбор API на странице обзора.

  3. Выберите многоточие (...) рядом с API, к которому требуется добавить другой API.

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

    снимок экрана, на котором показана команда импорта.

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

Связанный контент

  • Last updated on