Dela via


Importera ett gRPC-API

GÄLLER FÖR: Utvecklare | Grundläggande | Standard | Premie

Den här artikeln visar hur du importerar en gRPC-tjänstdefinition som ett API i API Management. Du kan sedan hantera API:et i API Management, skydda åtkomsten och tillämpa andra principer och skicka gRPC API-begäranden via gatewayen till gRPC-serverdelen.

Om du vill lägga till ett gRPC-API i API Management måste du:

  • Ladda upp API:ets protobuf-definitionsfil (protokollbuffert) till API Management.
  • Ange platsen för din gRPC-tjänst.
  • Konfigurera API:et i API Management.

API Management stöder direktströmning med följande typer av gRPC-tjänstmetoder: unary, serverströmning, klientströmning och dubbelriktad direktuppspelning. Mer information om gRPC finns i Introduktion till gRPC.

Kommentar

  • gRPC-API:er stöds i den lokalt installerade gatewayen och i den hanterade gatewayen för klassiska nivåinstanser som skapats från och med januari 2026 (förhandsversion). Kontakta supporten för att aktivera gRPC API-stöd i klassiska nivåinstanser som skapats före det här datumet. gRPC-API:er stöds för närvarande inte på v2-nivåerna.
  • För närvarande stöds inte testning av gRPC-API:er i testkonsolen för Azure Portal eller i API Management-utvecklarportalen.
  • Importen är begränsad till en enda protobuf-fil (.proto).

Förutsättningar

Lägga till ett gRPC-API

  1. I Azure-portalen går du till din API Management-instans.

  2. Under API:er i sidomenyn väljer du API:er.

  3. Under Definiera ett nytt API väljer du gRPC.

    Skärmbild av att skapa ett gRPC-API i portalen.

  4. I fönstret Skapa ett gRPC-API väljer du Fullständig.

  5. Ange följande inställningar för ett gRPC-API:

    1. Ange ett visningsnamn.

    2. För Ladda upp schema väljer du en lokal .proto-fil som är associerad med API:et som ska importeras.

    3. För gRPC-server-URL anger du adressen till gRPC-tjänsten. Adressen måste vara tillgänglig via HTTPS.

    4. För Gatewayer väljer du den gatewayresurs som du vill använda för att exponera API:et.

  6. Ange eventuella återstående inställningar för att konfigurera ditt API. I självstudien Importera och publicera ditt första API beskrivs de här inställningarna.

  7. Välj Skapa.

    Portalen lägger till API:et i LISTAN ÖVER API:er . Du kan visa och uppdatera inställningarna genom att gå till fliken Inställningar i API:et.

Anropa gRPC-tjänster med hjälp av .NET

Information om hur du anropar gRPC-tjänster med hjälp av .NET finns i följande artiklar:

Lägg till andra API:er

Du kan skapa ett API av API:er som exponeras av olika tjänster, inklusive:

  • En OpenAPI-specifikation
  • ETT SOAP-API
  • Ett GraphQL-API
  • En webbapp som finns i Azure App Service
  • Azure-funktioner
  • Azure Logic-appar
  • Azure Service Fabric

Kommentar

När du importerar ett API läggs åtgärderna till i ditt aktuella API.

Så här lägger du till ett API i ett befintligt API:

  1. Gå till din Azure API Management-instans i Azure-portalen:

    Skärmbild som visar sidan API Management-tjänster.

  2. Välj API:er på sidan Översikt eller välj API:er>API:er på menyn till vänster.

    Skärmbild som visar valet av API:er på sidan Översikt.

  3. Välj ellipsen (...) bredvid det API som du vill lägga till ett annat API till.

  4. Välj Importera på snabbmenyn:

    Skärmbild som visar kommandot Importera.

  5. Välj en tjänst som ett API ska importeras från.