Een gRPC-API importeren (preview)

  • Artikel

VAN TOEPASSING OP: Ontwikkelaar | Premium

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.

Notitie

  • Het importeren van een gRPC-API is in preview. 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.

Vereisten

  • Een API Management-exemplaar. Als u nog geen exemplaar hebt, voltooit u de volgende quickstart: Een Azure API Management-exemplaar maken.

  • Een gatewayresource die is ingericht in uw exemplaar. Zie Een zelf-hostende gateway inrichten in Azure API Management als u er nog geen hebt.

  • Een gRPC Protobuff-bestand (.proto) dat lokaal beschikbaar is en gRPC-service die toegankelijk is via HTTPS.

Een gRPC-API toevoegen

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

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

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

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

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

  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 zelfstudie Importeren en publiceren van uw eerste API .

  7. Selecteer Maken.

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

Andere API's toevoegen

U kunt een API opstellen van API's die beschikbaar worden gesteld door verschillende services, waaronder:

  • Een OpenAPI-specificatie
  • Een SOAP-API
  • Een GraphQL-API
  • Een web-app die wordt gehost in Azure-app Service
  • Azure Function-app
  • Azure Logic-apps
  • Azure Service Fabric

Voeg een andere API toe aan uw bestaande API met behulp van de volgende stappen.

Notitie

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

  1. Ga naar uw Azure API Management-exemplaar in de Azure-portal.

    Ga naar azure API Mgmt-exemplaar

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

    API's selecteren

  3. Selecteer het beletselsteken (... ) naast de API waaraan u een andere API wilt toevoegen.

  4. Selecteer Importeren in de vervolgkeuzelijst.

    Importeren selecteren

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

    Service selecteren