Serverloze API's van HTTP-eindpunten beschikbaar maken met behulp van Azure API Management

Azure Functions integreert met Azure API Management in de portal, zodat u de eindpunten van uw HTTP-triggerfunctie beschikbaar kunt maken als REST API's. Deze API's worden beschreven met behulp van een OpenAPI-definitie. Dit JSON-bestand (of YAML)-bestand bevat informatie over welke bewerkingen beschikbaar zijn in een API. Het bevat informatie over hoe de aanvraag- en antwoordgegevens voor de API moeten worden gestructureerd. Door uw functie-app te integreren, kunt u deze OpenAPI-definities API Management genereren.

In dit artikel wordt beschreven hoe u uw functie-app integreert met API Management. Deze integratie werkt voor functie-apps die zijn ontwikkeld in elke ondersteunde taal. U kunt uw functie-app ook importeren vanuit Azure API Management.

Voor C#-klassenbibliotheekfuncties kunt u Visual Studio ook gebruiken om serverloze API's te maken en te publiceren die zijn geïntegreerd met API Management.

Het API Management-exemplaar maken

Een API Management exemplaar maken dat is gekoppeld aan uw functie-app:

  1. Selecteer de functie-app, kies in het linkermenu API Management en selecteer vervolgens Nieuwe maken onder API Management.

    API Management kiezen

  2. Gebruik de API Management-instellingen zoals die in de volgende tabel zijn opgegeven:

    Instelling Voorgestelde waarde Beschrijving
    Naam Wereldwijd unieke naam Er wordt een naam gegenereerd op basis van de naam van uw functie-app.
    Abonnement Uw abonnement Het abonnement waarmee deze nieuwe resource is gemaakt.
    Resourcegroep myResourceGroup Dezelfde resource als uw functie-app, die voor u moet worden ingesteld.
    Locatie Locatie van de service Overweeg om dezelfde locatie te kiezen als uw functie-app.
    Naam van de organisatie Contoso De organisatienaam die in de ontwikkelaarsportal en voor e-mailmeldingen wordt gebruikt.
    E-mailadres van de beheerder uw e-mailadres E-mailadres waarop systeemmeldingen van API Management werden ontvangen.
    Prijscategorie Verbruik De verbruikscategorie is niet in alle regio's beschikbaar. Raadpleeg voor alle prijzen de pagina met API Management-prijzen

    Nieuwe API Management-service maken

  3. Kies Exporteren om het API Management-exemplaar te maken. Dit kan enkele minuten duren.

  4. Nadat Azure het exemplaar heeft gemaakt, wordt de optie Application Insights inschakelen op de pagina ingeschakeld. Selecteer deze optie om logboeken te verzenden naar dezelfde locatie als de functietoepassing.

Importfuncties

Nadat het API Management-exemplaar is gemaakt, kunt u de door HTTP geactiveerde functie-eindpunten importeren. In dit voorbeeld wordt een eindpunt met de naam TurbineRepair geïmporteerd.

  1. Selecteer koppelings-API op de pagina API Management.

  2. Azure Functions importeren wordt geopend, waarbij de functie TurbineRepair is gemarkeerd. Klik op Selecteren om door te gaan.

    Azure Functions in API Management importeren

  3. Accepteer op de pagina Maken op basis van functie-app de standaardinstellingen en selecteer vervolgens Maken.

    Maken op basis van functie-app

    Azure maakt de API voor de functie.

De OpenAPI-definitie downloaden

Nadat uw functies zijn geïmporteerd, kunt u de OpenAPI-definitie downloaden van het API Management-exemplaar.

  1. Selecteer bovenaan de pagina OpenAPI-definitie downloaden.

    OpenAPI-definitie downloaden

  2. Sla het gedownloade JSON-bestand op en open het. Controleer de definitie.

Volgende stappen

U kunt nu de definitie verfijnen in API Management in de portal. Ook kunt u meer informatie over API Management raadplegen.