Dela via

Importera ett gRPC-API

GÄLLER FÖR: Utvecklare | 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

  • För närvarande stöds gRPC-API:er endast i den lokalt installerade gatewayen, inte den hanterade gatewayen för din API Management-instans.
  • 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 Portal navigerar 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. För ett gRPC-API måste du ange följande inställningar:

    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.

      Viktigt!

      I den offentliga förhandsversionen kan du bara välja en gateway med egen värd. Den hanterade gatewayen stöds inte.

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

  7. Välj Skapa.

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

Anropa gRPC-tjänster med .NET

Information om hur du anropar gRPC-tjänster med .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 från den nedrullningsbara menyn:

    Skärmbild som visar kommandot Importera.

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

Relaterat innehåll