Dela via

Importera ett gRPC-API

  • Artikel

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. Bakgrund 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 Protobuff-fil (.proto).

Förutsättningar

Lägga till ett gRPC-API

  1. I Azure Portal navigerar du till din API Management-instans.

  2. I den vänstra menyn väljer du API:er>+ Lägg till API.

  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. I Ladda upp schema väljer du en lokal .proto-fil som är associerad med API:et som ska importeras.

    2. I gRPC-server-URL anger du adressen till gRPC-tjänsten. Adressen måste vara tillgänglig via HTTPS.

    3. I 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 å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 för 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-funktionsapp
  • Azure Logic Program-program
  • Azure Service Fabric

Lägg till ett annat API i ditt befintliga API med hjälp av följande steg.

Kommentar

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

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

    Skärmbild av att navigera till API Management-instansen i portalen.

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

    Skärmbild av att välja API:er på översiktssidan i portalen.

  3. Klicka på ... intill det API som du vill lägga till ett annat API till.

  4. Välj Import från den nedrullningsbara menyn.

    Välj Importera

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

    Skärmbild av att välja en tjänst i portalen.