Oefening: een Azure-functie maken die wordt geactiveerd door een webhook

6 minuten

In deze eerste oefening maakt u uw code voor het parseren van de GitHub-wiki-gebeurtenisberichten in Azure Functions. U configureert de functie die moet worden uitgevoerd wanneer een webhookbericht wordt ontvangen.

Een functie-app maken

Meld u aan bij de Azure Portal met uw MS Learn-account.
Selecteer Een resource maken. Het deelvenster Een bron maken wordt weergegeven.
Selecteer in het linkermenuvenster, onder Categorieën, Computeen zoek in het zoekvak Zoekservices en Marketplace zoekvak naar Functie-app. Het deelvenster Functie-app wordt weergegeven.
Selecteer Maak. Het deelvenster Functie-app maken wordt weergegeven.

Voer op het tabblad Basisinformatie de volgende waarden in voor elke instelling.

Notitie

De naam van de functie-app moet uniek zijn. We raden u aan iets te gebruiken zoals <uw naam of initialen>triggerapp. Gebruik deze naam overal waar u <uw functietoepassingsnaam tegenkomt> in deze oefening.

Instelling	Waarde
projectdetails
Abonnement	Concierge-abonnement
Resourcegroep	Selecteer in de vervolgkeuzelijst de sandbox-resourcegroep [naam sandbox-resourcegroep].
Instantiegegevens
Naam van functie-app	<uw functie-app-naam>
Uitgeven	Code
Runtime stack	Node.js
Versie	Standaard accepteren
Regio	Kies de dichtstbijzijnde locatie die ook een van de toegestane Sandbox-regio's is.
besturingssysteem
Besturingssysteem	Ramen
Hosting
Hostingopties en -abonnementen	Verbruik (serverloos)

Met de gratis sandbox kunt u resources maken in een subset van de globale Azure-regio's. Selecteer een regio in de volgende lijst wanneer u resources maakt:

West VS 2
Zuid-Centraal VS
Centraal-Verenigde Staten
Oost-VS
West-Europa

Zuidoost-Azië
Japan Oost
Brazilië - zuid
Australië - zuidoost
Centraal India

Selecteer Volgende: Opslag om het tabblad Storage te openen. Voer de volgende waarden in voor elke instelling.

Instelling Waarde

Opslag

Opslagaccount (Nieuw) en accepteer de standaardnaam.
Selecteer Beoordelen enmaken.
Azure controleert uw vermeldingen. Wanneer dit is geverifieerd, selecteert u Maken.

Instelling	Waarde
Opslag
Opslagaccount	(Nieuw) en accepteer de standaardnaam.

Een door webhook geactiveerde functie maken

Wanneer uw implementatie is voltooid, selecteert u Ga naar de resource. Het deelvenster Overzicht wordt weergegeven voor uw functie-app.
Selecteer onder FunctionsMaken in Azure Portal.
Het deelvenster Functie maken wordt weergegeven.
Bij Selecteer een sjabloon, selecteer HTTP-triggeren klik vervolgens op maken. Het deelvenster HttpTrigger1 wordt weergegeven voor uw Functie, met essentiële informatie voor uw nieuwe trigger.

Selecteer in het linkermenuvenster onder Developerde optie Code + Test. Het deelvenster Code + Test wordt weergegeven voor uw functie , waarbij het JavaScript-bestand wordt weergegeven dat is gemaakt van de sjabloon. Deze moet eruitzien als de volgende code.

module.exports = async function (context, req) {
    context.log('JavaScript HTTP trigger function processed a request.');

    const name = (req.query.name || (req.body && req.body.name));
    const responseMessage = name
        ? "Hello, " + name + ". This HTTP triggered function executed successfully."
        : "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.";

    context.res = {
        // status: 200, /* Defaults to 200 */
        body: responseMessage
    };
}

Het index.js-bestand is de JavaScript-functie die door de portal wordt gegenereerd. Het verzoek leest een naam uit, die ofwel wordt doorgegeven als een querytekenreeks of als onderdeel van de verzoektekst, en reageert met een "Hallo"-bericht.

Boven de code bevindt zich het pad met een vervolgkeuzelijst met de bestandsnaam. Selecteer function.jsonin de vervolgkeuzelijst. Het JSON-bestand dat door de sjabloon is gemaakt, wordt weergegeven. Deze moet eruitzien als de volgende code.
```
{
    "bindings": [
        {
            "authLevel": "function",
            "type": "httpTrigger",
            "direction": "in",
            "name": "req",
            "methods": [
                "get",
                "post"
            ]
        },
        {
            "type": "http",
            "direction": "out",
            "name": "res"
        }
    ]
}
```
De JSON-bindingen geven aan dat de functie wordt geactiveerd door HTTP GET- en POST-aanvragen die zijn gericht op de URL van de functie-app.

Test het activeren van uw functie

Selecteer in de bovenste menubalk Functie-URL ophalen.
Selecteer in het dialoogvenster Functie-URL ophalen in de vervolgkeuzelijst Sleutel, onder Functietoets, de optie standaard. Selecteer het pictogram Kopiëren naar Klembord in het veld URL. De URL ziet er ongeveer als volgt uit:
```
https://<your-functionapp-name>.azurewebsites.net/api/HttpTrigger1?code=aUjXIpqdJ0ZHPQuB0SzFegxGJu0nAXmsQBnmkCpJ6RYxleRaoxJ8cQ==
```
Plak deze URL in een browser en voeg aan het einde van de URL de parameter voor de querytekenreeks toe: &name=<uwnaam>, bijvoorbeeld &name=Dick en Jane.
Druk op Enter-om de aanvraag uit te voeren. Het antwoord dat door de functie wordt geretourneerd, wordt weergegeven in de browser. Het ziet er ongeveer als volgt uit:
```
Hello Dick and Jane. This HTTP triggered function executed successfully.
```

Gefeliciteerd! U hebt nu een functie die kan worden geactiveerd door een URL.

Oefening: een Azure-functie maken die wordt geactiveerd door een webhook

Een functie-app maken

Een door webhook geactiveerde functie maken

Test het activeren van uw functie

Feedback