Импорт API gRPC

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

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

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

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

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

Примечание.

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

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

Добавьте API gRPC

  1. На портале Azure откройте экземпляр API Management.

  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.

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

Сведения о вызове служб 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