Delen via

Een gRPC-API importeren

VAN TOEPASSING OP: Ontwikkelaar | Premie

In dit artikel wordt beschreven hoe u een gRPC-servicedefinitie importeert als een API in API Management. Vervolgens kunt u de API beheren in API Management, toegang beveiligen en ander beleid toepassen en gRPC-API-aanvragen doorgeven via de gateway naar de gRPC-back-end.

Als u een gRPC-API wilt toevoegen aan API Management, moet u het volgende doen:

  • Upload het Protobuf-definitiebestand van de API (protocolbuffer) naar API Management
  • Geef de locatie van uw gRPC-service op
  • De API configureren in API Management

API Management ondersteunt passthrough met de volgende typen gRPC-servicemethoden: unaire, serverstreaming, clientstreaming en bidirectionele streaming. Zie Inleiding tot gRPC voor achtergrondinformatie over gRPC.

Opmerking

  • Momenteel worden gRPC-API's alleen ondersteund in de zelf-hostende gateway, niet de beheerde gateway voor uw API Management-exemplaar.
  • Het testen van gRPC-API's wordt momenteel niet ondersteund in de testconsole van Azure Portal of in de API Management-ontwikkelaarsportal.
  • Importeren is beperkt tot één Protobuff-bestand (.proto).

Vereiste voorwaarden

Een gRPC-API toevoegen

  1. Blader in Azure Portal naar uw API Management-exemplaar.

  2. Selecteer in het linkermenu API's>+ API toevoegen.

  3. Selecteer gRPC onder Een nieuwe API definiëren.

    Schermopname van het maken van een gRPC-API in de portal.

  4. Selecteer Volledig in het venster Een gRPC-API maken.

  5. Voor een gRPC-API moet u de volgende instellingen opgeven:

    1. Selecteer in het uploadschema een lokaal PROTO-bestand dat is gekoppeld aan de API die u wilt importeren.

    2. Voer in de URL van de gRPC-server het adres van de gRPC-service in. Het adres moet toegankelijk zijn via HTTPS.

    3. Selecteer in Gateways de gatewayresource die u wilt gebruiken om de API beschikbaar te maken.

      Belangrijk

      In openbare preview kunt u alleen een zelf-hostende gateway selecteren. De beheerde gateway wordt niet ondersteund.

  6. Voer de resterende instellingen in om uw API te configureren. Deze instellingen worden uitgelegd in de Importeer en publiceer je eerste API tutorial.

  7. Klik op Creëren.

    De API wordt toegevoegd aan de lijst met API's . U kunt uw instellingen bijwerken bekijken door naar het tabblad Instellingen van de API te gaan.

GRPC-services aanroepen met .NET

Zie de volgende artikelen voor informatie over het aanroepen van gRPC-services met .NET:

Andere API's toevoegen

U kunt een API samenstellen uit API's die worden weergegeven door verschillende services, waaronder:

  • Een OpenAPI-specificatie
  • Een SOAP-API
  • Een GraphQL-API
  • Een web-app die wordt gehost in Azure App Service
  • Azure Functions (serverloze computerdiensten van Azure)
  • Azure Logic Apps
  • Azure Service Fabric

Opmerking

Wanneer u een API importeert, worden de bewerkingen toegevoegd aan uw huidige API.

Een API toevoegen aan een bestaande API:

  1. Ga naar uw Azure API Management-exemplaar in Azure Portal:

    Schermopname van de pagina API Management-services.

  2. Selecteer API's op de Overzicht pagina of selecteer API's>API's in het menu aan de linkerkant.

    Screenshot van de selectie van API's op de pagina 'Overzicht'.

  3. Selecteer het beletselteken (#A0 ... #A1) naast de API waaraan u een andere API wilt toevoegen.

  4. Selecteer Import uit het vervolgkeuzemenu.

    Schermopname van de opdracht importeren.

  5. Selecteer de service waaruit een API moet worden geïmporteerd.

Verwante inhoud