Overzicht van HTTP-triggers en bindingen in Azure Functions

  • Artikel

Azure Functions kan worden aangeroepen via HTTP-aanvragen om serverloze API's te bouwen en te reageren op webhooks.

Actie Type
Een functie uitvoeren vanuit een HTTP-aanvraag Trigger
Een HTTP-antwoord van een functie retourneren Uitvoerbinding

De extensie installeren

Het NuGet-extensiepakket dat u installeert, is afhankelijk van de C#-modus die u gebruikt in uw functie-app:

Functies worden uitgevoerd in een geïsoleerd C#-werkproces. Zie De handleiding voor het uitvoeren van C# Azure Functions in een geïsoleerd werkproces voor meer informatie.

De functionaliteit van de extensie varieert afhankelijk van de extensieversie:

Voeg de extensie toe aan uw project door het NuGet-pakket, versie 3.x, te installeren.

Notitie

Er is een extra uitbreidingspakket nodig voor ASP.NET Core-integratie in .NET Isolated

Bundel installeren

Vanaf Functions versie 2.x maakt de HTTP-extensie deel uit van een extensiebundel, die is opgegeven in uw host.json projectbestand. Zie uitbreidingsbundel voor meer informatie.

Deze versie van de extensie moet al beschikbaar zijn voor uw functie-app met extensiebundel, versie 2.x.

host.json-instellingen

In deze sectie worden de configuratie-instellingen beschreven die beschikbaar zijn voor deze binding in versie 2.x en hoger. Instellingen in het bestand host.json van toepassing op alle functies in een exemplaar van een functie-app. Het onderstaande voorbeeld host.json bestand bevat alleen de instellingen voor versie 2.x+ voor deze binding. Zie host.json naslaginformatie voor Azure Functions voor meer informatie over configuratie-instellingen voor functie-apps in versies 2.x en latere versies.

Notitie

Zie host.json-verwijzing voor Azure Functions 1.x voor een verwijzing naar host.json in Functions 1.x.

{
    "extensions": {
        "http": {
            "routePrefix": "api",
            "maxOutstandingRequests": 200,
            "maxConcurrentRequests": 100,
            "dynamicThrottlesEnabled": true,
            "hsts": {
                "isEnabled": true,
                "maxAge": "10"
            },
            "customHeaders": {
                "X-Content-Type-Options": "nosniff"
            }
        }
    }
}
Eigenschappen Standaard Beschrijving
customHeaders Geen Hiermee kunt u aangepaste headers instellen in het HTTP-antwoord. In het vorige voorbeeld wordt de X-Content-Type-Options header toegevoegd aan het antwoord om te voorkomen dat inhoudstypen worden gesniffing. Deze aangepaste header is van toepassing op alle door HTTP geactiveerde functies in de functie-app.
dynamicThrottlesEnabled Waar* Wanneer deze instelling is ingeschakeld, zorgt deze ervoor dat de aanvraagverwerkingspijplijn periodiek systeemprestatiemeteritems controleert, zoals connections/threads/processes/memory/cpu/etc en als een van deze tellers een ingebouwde hoge drempelwaarde (80%) overschrijdt, worden aanvragen geweigerd met een 429 "Too Busy" antwoord totdat de prestatiemeteritems weer normaal zijn.
*De standaardwaarde in een verbruiksabonnement is true. De standaardwaarde in een Dedicated-abonnement is false.
hsts niet ingeschakeld Wanneer isEnabled dit is ingesteld trueop, wordt het GEDRAG van HSTS (HTTP Strict Transport Security) van .NET Core afgedwongen, zoals gedefinieerd in de HstsOptions klasse. In het bovenstaande voorbeeld wordt de maxAge eigenschap ook ingesteld op 10 dagen. Ondersteunde eigenschappen zijn hsts :
EigenschappenBeschrijving
excludedHostsEen tekenreeksmatrix met hostnamen waarvoor de HSTS-header niet wordt toegevoegd.
includeSubDomainsBooleaanse waarde die aangeeft of de parameter includeSubDomain van de header Strict-Transport-Security is ingeschakeld.
maxAgeTekenreeks die de parameter max-age van de header Strict-Transport-Security definieert.
PreloadBooleaanse waarde die aangeeft of de parameter preload van de header Strict-Transport-Security is ingeschakeld.
maxConcurrentRequests 100* Het maximum aantal HTTP-functies dat parallel wordt uitgevoerd. Met deze waarde kunt u gelijktijdigheid beheren, wat kan helpen bij het beheren van resourcegebruik. U hebt bijvoorbeeld een HTTP-functie die gebruikmaakt van een groot aantal systeembronnen (geheugen/cpu/sockets), zodat er problemen optreden wanneer gelijktijdigheid te hoog is. Of u hebt een functie waarmee uitgaande aanvragen worden verzonden naar een service van derden. Deze aanroepen moeten beperkt zijn. In deze gevallen kan het toepassen van een beperking hier helpen.
*De standaardwaarde voor een verbruiksabonnement is 100. De standaardwaarde voor een Dedicated-abonnement is niet gebonden (-1).
maxOutstandingRequests 200* Het maximum aantal openstaande aanvragen dat op elk gewenst moment wordt bewaard. Deze limiet omvat aanvragen die in de wachtrij worden geplaatst, maar die niet zijn gestart, evenals eventuele actieve uitvoeringen. Eventuele binnenkomende aanvragen die deze limiet overschrijden, worden geweigerd met een antwoord van 429 'Te bezet'. Hierdoor kunnen bellers strategieën voor opnieuw proberen op basis van tijd gebruiken en kunt u ook maximale latenties voor aanvragen beheren. Dit bepaalt alleen wachtrijen die plaatsvinden binnen het uitvoeringspad van de scripthost. Andere wachtrijen, zoals de ASP.NET-aanvraagwachtrij, zijn nog steeds van kracht en worden niet beïnvloed door deze instelling.
*De standaardwaarde voor een verbruiksabonnement is 200. De standaardwaarde voor een Dedicated-abonnement is niet gebonden (-1).
routePrefix api Het routevoorvoegsel dat van toepassing is op alle routes. Gebruik een lege tekenreeks om het standaardvoorvoegsel te verwijderen.

Volgende stappen