Udostępnij za pomocą

Importuj API gRPC

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, zabezpieczać dostęp i stosować inne zasady oraz przekazywać żądania interfejsu API gRPC za pośrednictwem bramy do zaplecza usługi gRPC.

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

  • Przekaż plik definicji protobuf interfejsu API (bufor protokołu) do usługi API Management.
  • Określ lokalizację usługi gRPC.
  • Konfigurowanie interfejsu API w usłudze API Management.

API Management obsługuje przesyłanie dla następujących typów metod usługi gRPC: jednorzędowe, przesyłanie strumieniowe od serwera, przesyłanie strumieniowe od klienta i dwukierunkowe przesyłanie strumieniowe. Aby dowiedzieć się więcej o gRPC, zobacz Wprowadzenie do gRPC.

Uwaga

  • 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.
  • Importowanie jest ograniczone do pojedynczego pliku protobuf (proto).

Wymagania wstępne

Dodawanie interfejsu API gRPC

  1. Na portalu Azure przejdź do instancji zarządzania API.

  2. W obszarze Interfejsy API w menu paska bocznego wybierz pozycję Interfejsy 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. Wprowadź nazwę wyświetlaną.

    2. W polu Przekaż schemat wybierz lokalny plik proto skojarzony z interfejsem API do zaimportowania.

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

    4. W obszarze Bramy wybierz zasób bramy, którego chcesz użyć do udostępnienia interfejsu API.

      Ważne

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

  6. Wprowadź wszystkie 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. Możesz wyświetlić aktualizację ustawień, przechodząc do karty Ustawienia interfejsu API.

Wywoływanie usług gRPC za pomocą platformy .NET

Aby uzyskać informacje na temat wywoływania usług gRPC za pomocą platformy .NET, zobacz następujące artykuły:

Dołączanie innych interfejsów API

Interfejs API można zbudować z API, które są udostępniane przez różne usługi, w tym:

  • Specyfikacja interfejsu OpenAPI
  • Interfejs SOAP
  • API GraphQL
  • Aplikacja internetowa hostowana w usłudze Azure App Service
  • Azure Functions
  • Aplikacje logiki Azure
  • Azure Service Fabric

Uwaga

Podczas importowania interfejsu API operacje są dołączane do bieżącego interfejsu API.

Aby dodać interfejs API do istniejącego:

  1. Przejdź do instancji Azure API Management w portalu Azure.

    Zrzut ekranu przedstawiający stronę usług API Management.

  2. Wybierz interfejsy API na stronie Przegląd lub wybierz interfejsy API>interfejsy API w menu po lewej stronie.

    Zrzut ekranu przedstawiający wybór interfejsów API na stronie przeglądowej.

  3. Wybierz wielokropek (...) obok interfejsu API, do którego chcesz dołączyć inny.

  4. Wybierz Importuj z menu rozwijanego:

    Zrzut ekranu przedstawiający polecenie Importuj.

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

Powiązana zawartość

  • Last updated on