Importowanie interfejsu API gRPC (wersja zapoznawcza)

  • Artykuł

DOTYCZY: Developer | Premium

W tym artykule pokazano, jak zaimportować definicję usługi gRPC jako interfejs API w usłudze API Management. Następnie możesz zarządzać interfejsem API w usłudze API Management, zabezpieczyć dostęp i zastosować inne zasady oraz przekazać żądania interfejsu API gRPC za pośrednictwem bramy do zaplecza usługi gRPC.

Aby dodać interfejs API gRPC do usługi API Management, musisz:

  • Przekazywanie pliku definicji Protobuf (buforu protokołu) interfejsu API do usługi API Management
  • Określanie lokalizacji usługi gRPC
  • Konfigurowanie interfejsu API w usłudze API Management

Usługa API Management obsługuje przekazywanie z następującymi typami metod usługi gRPC: jednoargumentowe, przesyłanie strumieniowe serwera, przesyłanie strumieniowe klienta i dwukierunkowe przesyłanie strumieniowe. Aby uzyskać informacje o gRPC, zobacz Wprowadzenie do gRPC.

Uwaga

  • Importowanie interfejsu API gRPC jest w wersji zapoznawczej. Obecnie interfejsy API gRPC są obsługiwane tylko w bramie hostowanej samodzielnie, a nie w bramie zarządzanej dla wystąpienia usługi API Management.
  • Obecnie testowanie interfejsów API gRPC nie jest obsługiwane w konsoli testowej witryny Azure Portal ani w portalu deweloperów usługi API Management.

Wymagania wstępne

  • Wystąpienie usługi API Management. Jeśli jeszcze go nie masz, wykonaj czynności opisane w następującym przewodniku Szybki start: Tworzenie wystąpienia usługi Azure API Management.

  • Zasób bramy aprowizowany w wystąpieniu. Jeśli jeszcze go nie masz, zobacz Aprowizuj własną bramę w usłudze Azure API Management.

  • Plik gRPC Protobuff (proto) dostępny lokalnie i usługa gRPC, która jest dostępna za pośrednictwem protokołu HTTPS.

Dodawanie interfejsu API gRPC

  1. W witrynie Azure Portal przejdź do wystąpienia usługi API Management.

  2. W menu po lewej stronie wybierz pozycję Interfejsy> API+ Dodaj interfejs API.

  3. W obszarze Definiowanie nowego interfejsu API wybierz pozycję gRPC.

    Zrzut ekranu przedstawiający tworzenie interfejsu API gRPC w portalu.

  4. W oknie Tworzenie interfejsu API gRPC wybierz pozycję Pełny.

  5. W przypadku interfejsu API gRPC należy określić następujące ustawienia:

    1. W obszarze Przekazywanie schematu wybierz lokalny plik proto skojarzony z interfejsem API do zaimportowania.

    2. W adresie URL serwera gRPC wprowadź adres usługi gRPC. Adres musi być dostępny za pośrednictwem protokołu HTTPS.

    3. W obszarze Bramy wybierz zasób bramy, którego chcesz użyć do uwidocznienia interfejsu API.

      Ważne

      W publicznej wersji zapoznawczej możesz wybrać tylko bramę hostowaną samodzielnie. Brama zarządzana nie jest obsługiwana.

  6. Wprowadź pozostałe ustawienia, aby skonfigurować interfejs API. Te ustawienia zostały wyjaśnione w samouczku Importowanie i publikowanie pierwszego interfejsu API .

  7. Wybierz pozycję Utwórz.

    Interfejs API jest dodawany do listy interfejsów API. Ustawienia można wyświetlić, przechodząc do karty Ustawienia interfejsu API.

Dołączanie innych interfejsów API

Możesz utworzyć interfejs API interfejsów API udostępnianych przez różne usługi, w tym:

  • Specyfikacja interfejsu OpenAPI
  • Interfejs API PROTOKOŁU SOAP
  • Interfejs API graphQL
  • Aplikacja internetowa hostowana w usłudze aplikacja systemu Azure
  • Aplikacja funkcji platformy Azure
  • Azure Logic Apps
  • Azure Service Fabric

Dołącz inny interfejs API do istniejącego interfejsu API, wykonując następujące kroki.

Uwaga

Po zaimportowaniu innego interfejsu API operacje są dołączane do bieżącego interfejsu API.

  1. Przejdź do wystąpienia Azure API Management w Azure Portal.

    Przejdź do wystąpienia narzędzia Mgmt interfejsu API platformy Azure

  2. Wybierz pozycję Interfejsy API na stronie Przegląd lub z menu po lewej stronie.

    Wybierz interfejsy API

  3. Kliknij przycisk ... obok interfejsu API, który chcesz dołączyć do innego interfejsu API.

  4. Z menu rozwijanego wybierz pozycję Importuj.

    Wybieranie opcji importu

  5. Wybierz usługę, z której chcesz zaimportować interfejs API.

    Wybieranie usługi