Oefening: Een Azure-functie maken die is geactiveerd door een webhook

6 minuten

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

Een functie-app maken

Meld u met uw MSLearn-account aan bij Azure Portal.
Selecteer Een resource maken. Het deelvenster Een resource maken wordt weergegeven.
Selecteer Compute in het linkermenuvenster onder Categorieën, en zoek in het zoekvak Search-service s en Marketplace naar functie-app en selecteer deze. Het deelvenster Functie-app wordt weergegeven.
Selecteer Maken. 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 als <uw naam of initialen>triggerapp te gebruiken. Gebruik deze naam overal in deze oefening waar u <your-functionapp-name> ziet staan.

Instelling	Weergegeven als
Projectgegevens
Abonnement	Concierge-abonnement
Resourcegroep	Selecteer in de vervolgkeuzelijst de sandbox-resourcegroep ,[naam sandbox-resourcegroep].
Exemplaardetails
Naam van functie-app	<your-functionapp-name>
Publiceren	Code
Runtimestack	Node.js
Versie	Standaard accepteren
Regio	Kies de dichtstbijzijnde locatie die wordt weergegeven in de lijst met goedgekeurde Sandbox-regio's.
Besturingssysteem
Besturingssysteem	Vensters
Hosting
Hostingopties en -abonnementen	Verbruik (serverloos)

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

VS - west 2
VS - zuid-centraal
Central US
VS - oost
Europa -west

Azië - zuidoost
Japan East
Brazilië - zuid
Australië - zuidoost
India - centraal

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

Instelling Weergegeven als

Storage

Opslagaccount (nieuw) en accepteer de standaardnaam.
Selecteer Controleren + maken.
Azure controleert uw vermeldingen. Wanneer dit is geverifieerd, selecteert u Maken.

Instelling	Weergegeven als
Storage
Opslagaccount	(nieuw) en accepteer de standaardnaam.

Een door een webhook geactiveerde functie maken

Selecteer Ga naar resource als uw implementatie is voltooid. Het deelvenster Overzicht wordt weergegeven voor uw functie-app.
Selecteer Onder Functions maken in De Azure-portal.
Het deelvenster Functie maken wordt weergegeven.
Selecteer onder Selecteer een sjabloon de HTTP-trigger en selecteer vervolgens Maken. Het deelvenster HttpTrigger1 wordt weergegeven voor uw functie, met essentiële functies voor uw nieuwe trigger.

Selecteer code + test in het linkermenuvenster onder Ontwikkelaars. Het deelvenster Code en test wordt weergegeven voor uw functie, met daarin het JavaScript-bestand dat is gemaakt op basis 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 bestand index.js is de JavaScript-functie die door de portal wordt gegenereerd. De aanvraag leest de naam, doorgegeven als een querytekenreeks of als onderdeel van de hoofdtekst van de aanvraag, en reageert met een 'Hallo'-bericht.

Boven de code bevindt zich het pad met een vervolgkeuzelijst met de bestandsnaam. Selecteer function.json in 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 waarmee u uw functie activeert

Selecteer in de bovenste menubalk functie-URL ophalen.
Selecteer in het dialoogvenster Functie-URL ophalen in de vervolgkeuzelijst Sleutel onder Functietoets de standaardwaarde. Selecteer in het URL-veld het pictogram Kopiëren naar klembord . De URL ziet er ongeveer zo 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 querytekenreeksparameter toe: &name=<uwnaam>, bijvoorbeeld &name=Dick en Jane.
Druk op Enter om de aanvraag uit te voeren. In de browser wordt het antwoord van de functie weergegeven. Deze 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 is geactiveerd door een webhook

Een functie-app maken

Een door een webhook geactiveerde functie maken

Test waarmee u uw functie activeert

Feedback