Sdílet prostřednictvím

Import rozhraní API gRPC

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:

  • Nahrajte definiční soubor protokolu rozhraní (protobuf) do služby API Management.
  • Zadejte umístění služby gRPC.
  • Nakonfigurujte rozhraní API ve službě API Management.

API Management podporuje průchozí režim s následujícími typy metod služby gRPC: unární, serverové streamování, klientské streamování a obousměrné streamování. Další informace o gRPC najdete v tématu Úvod do gRPC.

Poznámka:

  • V současné době jsou rozhraní API gRPC podporována pouze v samohosované bráně, 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 protobuf (.proto).

Požadavky

Přidejte rozhraní API gRPC

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

  2. V části Rozhraní API v nabídce bočního panelu vyberte 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 Kompletní.

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

    1. Zadejte zobrazovaný název.

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

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

    4. V části Brány 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 hostovanou u zákazníka. Spravovaná brána není podporovaná.

  6. Zadejte všechna zbývající nastavení pro konfiguraci rozhraní API. Tato nastavení jsou vysvětlena v kurzu Import a publikace vaší první API.

  7. Vyberte Vytvořit.

    Přidá se 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 z rozhraní API, která jsou poskytovaná různými službami, včetně:

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

Poznámka:

Při importu rozhraní API se operace připojí k aktuálnímu rozhraní API.

Připojení API k existujícímu API:

  1. Na webu Azure Portal přejděte do své instance služby Azure API Management:

    snímek obrazovky se stránkou služby API Management

  2. Na stránce přehledu vyberte rozhraní API nebo v nabídce vlevo vyberte rozhraní API>.

    Snímek obrazovky znázorňující výběr rozhraní API na stránce Přehled

  3. Vyberte ikonu se třemi tečkami (...) vedle rozhraní API, k němuž chcete přidat další rozhraní API.

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

    Snímek obrazovky s příkazem Importovat

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

Související obsah

  • Last updated on