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 der API-Verwaltung verwalten, den sicheren Zugriff sichern und andere Richtlinien anwenden und 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:

Laden Sie die Protobuf-Definitionsdatei (Protokollpuffer) der API in die API-Verwaltung hoch.
Geben Sie den Standort Ihres gRPC-Diensts an.
Konfigurieren Sie die API in der API-Verwaltung.

API Management unterstützt Passthrough mit den folgenden Arten von GRPC-Dienstmethoden: unär, Serverstreaming, Clientstreaming und bidirektionales Streaming. Weitere Informationen zu gRPC finden Sie in der 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 Protobuf-Datei (.proto) beschränkt.

Voraussetzungen

Eine API Management-Instanz. Falls Sie nicht bereits über einen API Management-Dienst verfügen, arbeiten Sie die folgende Schnellstartanleitung durch: Erstellen einer Azure API Management-Instanz.
Eine Gatewayressource, die in Ihrer Instanz bereitgestellt wird. Wenn Sie noch keine besitzen, lesen Sie die Informationen unter Bereitstellen eines selbstgehosteten Gateways in Azure API Management.
Eine gRPC protobuf (.proto)-Datei, die lokal verfügbar ist, und gRPC-Dienst, auf den über HTTPS zugegriffen werden kann.

Hinzufügen einer gRPC-API

Navigieren Sie im Azure-Portal zu Ihrer API Management-Instanz.
Wählen Sie unter APIs im Randleistenmenü APIs aus.
Wählen Sie unter Neue API definieren die Option gRPC aus.
Wählen Sie im Fenster gRPC-API erstellen die Option Vollständig aus.
Für eine gRPC-API müssen Sie die folgenden Einstellungen angeben:
1. Geben Sie einen Anzeigenamen ein.
2. Wählen Sie für das Uploadschema eine lokale PROTO-Datei aus, die der zu importierenden API zugeordnet ist.
3. Geben Sie für die gRPC-Server-URL die Adresse des gRPC-Diensts ein. Auf diese Adresse muss über HTTPS zugegriffen werden können.
4. Wählen Sie für Gateways die Gatewayressource aus, die Sie verwenden möchten, um die API verfügbar zu machen.
  
  Wichtig
  
  In der öffentlichen Vorschau können Sie nur ein selbstgehostetes Gateway auswählen. Das verwaltete Gateway wird nicht unterstützt.
Geben Sie alle verbleibenden Einstellungen ein, um Ihre API zu konfigurieren. Diese Einstellungen werden im Tutorial Importieren und Veröffentlichen Ihrer ersten API erläutert.
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 erstellen, die von verschiedenen Diensten verfügbar gemacht werden, einschließlich:

Einer OpenAPI-Spezifikation
Einer SOAP-API
Einer GraphQL-API
Eine Web-App, die in Azure App Service gehostet wird
Azure-Funktionen
Azure Logic Apps
Azure Service Fabric

Hinweis

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

So fügen Sie eine API an eine vorhandene API an:

Wechseln Sie im Azure-Portal zu Ihrer Azure-API-Verwaltungsinstanz:
Wählen Sie auf der Seite "Übersicht"APIs aus, oder wählen Sie im Menü auf der linken Seite APIs> aus.
Wählen Sie die Ellipse (...) neben der API aus, zu der Sie eine andere API hinzufügen möchten.
Wählen Sie im Dropdownmenü " Importieren" aus:
Wählen Sie einen Dienst aus, aus dem eine API importiert werden soll.

Feedback

War diese Seite hilfreich?

Last updated on 2025-11-19