Udostępnij za pośrednictwem

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, 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

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 uzyskać informacje 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 Protobuff (.proto).

Wymagania wstępne

Dodawanie interfejsu API gRPC

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

  2. W menu po lewej stronie wybierz API>+ Dodaj 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 zaznacz 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. 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
  • Funkcje platformy Azure
  • Azure Logic Apps
  • 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ść