Sdílet prostřednictvím

Import rozhraní API gRPC

PLATÍ PRO: Vývojář | Základní | Standardní | Premium

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:

  • Rozhraní API gRPC jsou podporována v bráně v místním prostředí a ve spravované bráně pro instance klasické úrovně vytvořené od ledna 2026 (náhled). Pokud chcete povolit podporu rozhraní API gRPC v instancích klasické vrstvy vytvořených před tímto datem, obraťte se na technickou podporu. Rozhraní API gRPC nejsou v současnosti podporována v úrovních v2.
  • 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

  • Instance služby správy rozhraní API. Pokud ho ještě nemáte, proveďte následující rychlý start: Vytvořte instanci služby Azure API Management.

  • Místně dostupný soubor gRPC protobuf (.proto) a služba gRPC, která je přístupná přes PROTOKOL HTTPS.

  • Podpora protokolu HTTP/2 je povolená pro klientský provoz. Další informace najdete v tématu Správa protokolů a šifer ve službě Azure API Management.

Přidejte rozhraní API gRPC

  1. Na webu Azure Portal přejděte do vaší instance 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 zadejte 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.

  6. Zadejte všechna zbývající nastavení pro konfiguraci rozhraní API. Úvodní tutoriál 'Import a publikování vašeho prvního API' vysvětluje tato nastavení.

  7. Vyberte Vytvořit.

    Portál přidá rozhraní API do seznamu API. Nastavení můžete zobrazit a aktualizovat 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 místní 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