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

Импорт 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 не поддерживается в тестовой консоли на портале Azure или на портале разработчика Управления API.
  • Импорт ограничен одним файлом Protobuff (PROTO).

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

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

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

  • Файл gRPC Protocol Buffers (.proto) доступен локально, а gRPC сервис доступен по протоколу HTTPS.

Добавьте API gRPC

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

  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.

Вызов служб gRPC с помощью .NET

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

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

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

  • Спецификация OpenAPI
  • A SOAP API
  • A GraphQL API
  • Веб-приложение, размещенное в службе приложений 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.

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