Sdílet prostřednictvím

Import rozhraní API gRPC

  • Článek

PLATÍ PRO: Vývojář | Prémie

Tento článek ukazuje, jak importovat definici služby gRPC jako rozhraní API ve službě API Management. Rozhraní API pak můžete spravovat ve službě API Management, zabezpečit přístup a používat další zásady a předávat požadavky rozhraní gRPC API prostřednictvím brány do back-endu gRPC.

Pokud chcete do služby API Management přidat rozhraní API gRPC, musíte:

  • Nahrání definičního souboru protobuf rozhraní API (vyrovnávací paměti protokolu) do služby API Management
  • Zadejte umístění služby gRPC.
  • Konfigurace rozhraní API ve službě API Management

Api Management podporuje průchozí s následujícími typy metod služby gRPC: unární, serverové streamování, streamování klientů a obousměrné streamování. Základní informace o gRPC najdete v tématu Úvod do gRPC.

Poznámka:

  • V současné době se rozhraní API gRPC podporují jenom v bráně v místním prostředí, nikoli ve spravované bráně pro vaši instanci služby API Management.
  • Testování rozhraní API gRPC se v současné době nepodporuje v testovací konzole webu Azure Portal ani na portálu pro vývojáře služby API Management.
  • Import je omezen na jeden soubor Protobuff (.proto).

Požadavky

Přidání rozhraní API gRPC

  1. Na webu Azure Portal přejděte k vaší instanci služby API Management.

  2. V nabídce vlevo vyberte rozhraní API> + Přidat rozhraní API.

  3. V části Definovat nové rozhraní API vyberte gRPC.

    Snímek obrazovky s vytvořením rozhraní API gRPC na portálu

  4. V okně Vytvořit rozhraní API gRPC vyberte Úplné.

  5. Pro rozhraní API gRPC musíte zadat následující nastavení:

    1. Ve schématu nahrání vyberte místní soubor .proto přidružený k rozhraní API pro import.

    2. Do adresy URL serveru gRPC zadejte adresu služby gRPC. Adresa musí být přístupná přes PROTOKOL HTTPS.

    3. V bránách vyberte prostředek brány, který chcete použít ke zveřejnění rozhraní API.

      Důležité

      Ve verzi Public Preview můžete vybrat jenom bránu v místním prostředí. Spravovaná brána není podporovaná.

  6. Zadejte zbývající nastavení pro konfiguraci rozhraní API. Tato nastavení jsou vysvětlená v kurzu importu a publikování vašeho prvního kurzu rozhraní API .

  7. Vyberte Vytvořit.

    Rozhraní API se přidá do seznamu rozhraní API . Nastavení můžete zobrazit tak, že přejdete na kartu Nastavení rozhraní API.

Volání služeb gRPC pomocí .NET

Informace o volání služeb gRPC pomocí rozhraní .NET najdete v následujících článcích:

Připojení dalších rozhraní API

Můžete vytvořit rozhraní API rozhraní API vystavených různými službami, mezi které patří:

  • Specifikace OpenAPI
  • Rozhraní API SOAP
  • Rozhraní GraphQL API
  • Webová aplikace hostovaná ve službě Aplikace Azure Service
  • Aplikace funkcí Azure
  • Azure Logic Apps
  • Azure Service Fabric

Pomocí následujícího postupu připojte k existujícímu rozhraní API jiné rozhraní API.

Poznámka:

Při importu dalšího rozhraní API se k aktuálnímu rozhraní API připojí příslušné operace.

  1. Na webu Azure Portal přejděte do instance Azure API Management.

    Snímek obrazovky s přechodem na instanci služby API Management na portálu

  2. Na stránce Přehled nebo v nabídce vlevo vyberte rozhraní API.

    Snímek obrazovky s výběrem rozhraní API na stránce Přehled na portálu

  3. Klikněte na … vedle rozhraní API, ke kterému chcete připojit jiné rozhraní API.

  4. V rozevírací nabídce vyberte Importovat.

    Výběr importu

  5. Vyberte službu, ze které se má importovat rozhraní API.

    Snímek obrazovky s výběrem služby na portálu