Een Azure-functie uitvoeren met een HTTP-aanvraag

  • 10 minuten

Een HTTP-aanvraag is een veelvoorkomende bewerking op de meeste platforms en apparaten. We verzenden continu HTTP-aanvragen, of het nu gaat om een verzoek om een woord op te zoeken in een woordenlijst of om het lokale weerbericht op te vragen. Met Azure Functions kunnen we snel een stukje logica maken dat moet worden uitgevoerd wanneer er een HTTP-aanvraag wordt ontvangen.

In deze les leert u hoe u een functie maakt en aanroept met behulp van een HTTP-trigger. U verkent ook enkele van de aanpassingsopties die beschikbaar zijn voor HTTP-triggers.

Wat is een HTTP-trigger?

Een HTTP-trigger is een trigger waarmee code wordt uitgevoerd wanneer er een HTTP-aanvraag wordt ontvangen. HTTP-triggers bieden veel mogelijkheden en aanpassingen, zoals:

  • Geautoriseerde toegang verlenen door sleutels op te geven.
  • Beperken welke HTTP-woorden worden ondersteund.
  • Gegevens terugsturen naar de beller.
  • Gegevens ontvangen via queryreeksparameters of via de aanvraagbody.
  • Ondersteuning voor URL-routesjablonen om de functie-URL te wijzigen.

Wanneer u een HTTP-trigger maakt, moet u een naam voor de trigger opgeven en een autorisatieniveau kiezen.

Wat is een autorisatieniveau voor een HTTP-trigger ?

Een HTTP-triggerautorisatieniveau is een vlag die aangeeft of een binnenkomende HTTP-aanvraag een API-sleutel nodig heeft voor autorisatie.

Er zijn drie autorisatieniveaus:

  1. Functie
  2. Anoniem
  3. Beheerder

Voor de niveaus Functie en Beheerder is een sleutel vereist. Als u een HTTP-aanvraag wilt verzenden, moet u een sleutel opgeven voor autorisatie. Er zijn twee soorten sleutels: functiesleutels en hostsleutels. Het verschil tussen de twee sleutels is het bereik. Functiesleutels zijn specifiek voor een functie. Hostsleutels worden gebruikt voor alle functies in de functie-app. Als het autorisatieniveau is ingesteld op Functie, kunt u een functiesleutel of een hostsleutel gebruiken. Als het autorisatieniveau is ingesteld op Beheerder, moet u een hostsleutel opgeven.

Belangrijk

Omdat hostsleutels verhoogde toegang bieden tot uw functie-app, moet u ze veilig transporteren en opslaan.

Het anonieme niveau betekent dat autorisatie niet vereist is. In deze oefening wordt het niveau anonieme autorisatie gebruikt.

Een HTTP-trigger maken

Net als bij een timertrigger kunt u een HTTP-trigger maken via de Azure-portal. Selecteer in uw Azure-functie HTTP-trigger in de lijst met vooraf gedefinieerde triggertypen, voer vervolgens de logica in die u wilt uitvoeren en pas aanpassingen aan, zoals het gebruik van bepaalde HTTP-woorden beperken.

Een instelling die belangrijk is om te kennen, is Aanvraagparameternaam. Deze instelling is een tekenreeks die staat voor de naam van de parameter die de informatie over een inkomende HTTP-aanvraag bevat. De naam van de parameter is standaard req.

Een HTTP-trigger aanroepen

Als u een HTTP-trigger wilt aanroepen, verzendt u een HTTP-aanvraag naar de URL voor de functie. Als u deze URL wilt ophalen, gaat u naar de codepagina voor de functie en selecteert u de koppeling Functie-URL ophalen.

Schermopname van Azure Portal met een deelvenster met een Functions-app met de knop Functie-URL ophalen van de app gemarkeerd.

Als u beschikt over de URL voor de functie, kunt u HTTP-aanvragen verzenden. Als uw functie gegevens ontvangt, moet u er rekening mee houden dat u queryreeksparameters kunt gebruiken of de gegevens via de aanvraagbody kunt opgeven.

Een HTTP-trigger wordt uitgevoerd wanneer deze een HTTP-aanvraag ontvangt naar de bijbehorende functie-URL. Met HTTP-triggers kunt u gegevens ontvangen, logica uitvoeren en optioneel gegevens terugsturen naar de aanroeper.