Freigeben über


Importieren einer gRPC-API

GILT FÜR: Developer | Premium

In diesem Artikel wird gezeigt, wie Sie eine gRPC-Dienstdefinition als API in API Management importieren. Anschließend können Sie die API in API Management verwalten, den Zugriff schützen und andere Richtlinien anwenden sowie gRPC-API-Anforderungen über das Gateway an das gRPC-Back-End übergeben.

Zum Hinzufügen einer gRPC-API zu API Management müssen Sie folgende Schritte ausführen:

  • Hochladen der Protobuf-Definitionsdatei (Protokollpuffer) der API in API Management
  • Angeben des Standorts Ihres gRPC-Diensts
  • Konfigurieren der API in API Management

API Management unterstützt Passthrough mit den folgenden Arten von GRPC-Dienstmethoden: unär, Serverstreaming, Clientstreaming und bidirektionales Streaming. Hintergrundinformationen zu gRPC finden Sie unter Einführung in gRPC.

Hinweis

  • Derzeit werden gRPC-APIs nur im selbst gehosteten Gateway unterstützt, nicht im verwalteten Gateway für Ihre API Management-Instanz.
  • Derzeit wird das Testen von gRPC-APIs in der Testkonsole des Azure-Portals und im API Management Entwicklerportal nicht unterstützt.
  • Der Import ist auf eine einzelne Protobuff-Datei (.proto) beschränkt.

Voraussetzungen

Hinzufügen einer gRPC-API

  1. Navigieren Sie im Azure-Portal zu Ihrer API Management-Instanz.

  2. Wählen Sie im linken Menü APIs>+ API hinzufügen aus.

  3. Wählen Sie unter Neue API definieren die Option gRPC aus.

    Screenshot des Erstellens einer gRPC-API im Portal.

  4. Wählen Sie im Fenster gRPC-API erstellen die Option Vollständig aus.

  5. Für eine gRPC-API müssen Sie die folgenden Einstellungen angeben:

    1. Wählen Sie unter Schema hochladeneine lokale PROTO-Datei aus, die der zu importierenden API zugeordnet ist.

    2. Geben Sie unter gRPC-Server-URL die Adresse des gRPC-Diensts ein. Auf diese Adresse muss über HTTPS zugegriffen werden können.

    3. Wählen Sie unter Gateways die Gatewayressource aus, die Sie zum Verfügbarmachen der API verwenden möchten.

      Wichtig

      In der öffentlichen Vorschau können Sie nur ein selbstgehostetes Gateway auswählen. Das verwaltete Gateway wird nicht unterstützt.

  6. Geben Sie die verbleibenden Einstellungen ein, um Ihre API zu konfigurieren. Diese Einstellungen werden im Tutorial Importieren und Veröffentlichen Ihrer ersten API erläutert.

  7. Klicken Sie auf Erstellen.

    Die API wird der Liste APIs hinzugefügt. Sie können Ihre Einstellungen anzeigen oder aktualisieren, indem Sie zur Registerkarte Einstellungen der API wechseln.

Aufrufen von gRPC-Diensten mit .NET

Informationen zum Aufrufen von gRPC-Diensten mit .NET finden Sie in den folgenden Artikeln:

Anfügen weiterer APIs

Sie können eine API aus APIs zusammensetzen, die von verschiedenen Diensten verfügbar gemacht werden, u. a.:

  • Eine OpenAPI-Spezifikation
  • SOAP-API
  • Eine GraphQL-API
  • In Azure App Service gehostete Web-App
  • Azure-Funktionen-App
  • Azure Logic Apps
  • Azure Service Fabric

Führen Sie zum Anfügen einer anderen API an eine vorhandene API die folgenden Schritte aus.

Hinweis

Wenn Sie eine andere API importieren, werden die Vorgänge an Ihre aktuelle API angefügt.

  1. Navigieren Sie im Azure-Portal zu Ihrer Azure API Management-Instanz.

    Navigieren zur Azure API Management-Instanz

  2. Wählen Sie auf der Seite Übersicht oder im Menü auf der linken Seite die Option APIs aus.

    Auswählen von „APIs“

  3. Klicken Sie neben der API, die Sie an eine andere API anfügen möchten, auf ....

  4. Wählen Sie im Dropdownmenü Importieren aus.

    Auswählen von „Importieren“

  5. Wählen Sie einen Dienst aus, aus dem eine API importiert werden soll.

    Auswählen des Diensts