Concepten van Azure Functions-triggers en -bindingen

Artikel
10/28/2024

In dit artikel leert u de concepten op hoog niveau rondom functiestriggers en bindingen.

Triggers zorgen ervoor dat een functie wordt uitgevoerd. Een trigger definieert hoe een functie wordt aangeroepen en een functie moet precies één trigger hebben. Triggers kunnen ook gegevens doorgeven aan uw functie, net als bij methode-aanroepen.

Binding met een functie is een manier om uw functies declaratief te verbinden met andere resources; bindingen geven gegevens door aan uw functie (een invoerbinding) of stellen u in staat om gegevens uit uw functie (een uitvoerbinding) te schrijven met behulp van bindingsparameters. Uw functietrigger is in feite een speciaal type invoerbinding.

U kunt verschillende bindingen combineren en aanpassen aan het specifieke scenario van uw functie. Bindingen zijn optioneel en een functie kan een of meerdere invoer- en/of uitvoerbindingen hebben.

Met triggers en bindingen kunt u de toegang tot andere services voorkomen. Uw functie ontvangt gegevens (bijvoorbeeld de inhoud van een wachtrijbericht) in functieparameters. U verzendt gegevens (bijvoorbeeld om een wachtrijbericht te maken) door de retourwaarde van de functie te gebruiken.

Bekijk de volgende voorbeelden van hoe u verschillende functies kunt implementeren.

Voorbeeldscenario	Activator	Invoerbinding	Uitvoerbinding
Er wordt een nieuw wachtrijbericht binnengekomen waarmee een functie wordt uitgevoerd om naar een andere wachtrij te schrijven.	Rij^*	Geen	Rij^*
Een geplande taak leest de inhoud van Blob Storage en maakt een nieuw Azure Cosmos DB-document.	Timer	Blob Storage	Azure Cosmos DB
Event Grid wordt gebruikt om een afbeelding uit Blob Storage en een document van Azure Cosmos DB te lezen om een e-mailbericht te verzenden.	Event Grid	Blob Storage en Azure Cosmos DB	SendGrid

^* Vertegenwoordigt verschillende wachtrijen

Deze voorbeelden zijn niet volledig bedoeld, maar worden gegeven om te laten zien hoe u triggers en bindingen samen kunt gebruiken. Zie Azure Functions-scenario's voor een uitgebreidere set scenario's.

Tip

Voor Functions hoeft u geen invoer- en uitvoerbindingen te gebruiken om verbinding te maken met Azure-services. U kunt altijd een Azure SDK-client maken in uw code en deze gebruiken voor uw gegevensoverdracht. Zie Verbinding maken met services voor meer informatie.

Trigger- en bindingsdefinities

Een functie heeft één trigger en een of meer bindingen. Het type binding is invoer of uitvoer. Niet alle services ondersteunen zowel invoer- als uitvoerbindingen. Bekijk de specifieke bindingsextensie voor specifieke codevoorbeelden voor bindingen.

Triggers en bindingen worden verschillend gedefinieerd, afhankelijk van de ontwikkeltaal. Zorg ervoor dat u uw taal bovenaan het artikel selecteert.

In dit voorbeeld ziet u een door HTTP geactiveerde functie met een uitvoerbinding waarmee een bericht naar een Azure Storage-wachtrij wordt geschreven.

Voor C#-klassebibliotheekfuncties worden triggers en bindingen geconfigureerd door methoden en parameters te decoreren met C#-kenmerken, waarbij het toegepaste specifieke kenmerk afhankelijk kan zijn van het C#-runtimemodel:

Geïsoleerde werkrolmodel
Model in proces

De HTTP-trigger (HttpTrigger) wordt gedefinieerd voor de Run methode voor een functie met de naam HttpExample die een MultiResponse object retourneert:

[Function("HttpExample")]
public static MultiResponse Run([HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequestData req,
    FunctionContext executionContext)
{

In dit voorbeeld ziet u de MultiResponse objectdefinitie die beide een HttpResponse HTTP-aanvraag retourneert en ook een bericht naar een opslagwachtrij schrijft met behulp van een QueueOutput binding:

public class MultiResponse
{
    [QueueOutput("outqueue",Connection = "AzureWebJobsStorage")]
    public string[] Messages { get; set; }
    public HttpResponseData HttpResponse { get; set; }
}

Zie de handleiding voor het C#-geïsoleerde werkrolmodel voor meer informatie.

De HTTP-trigger (HttpTrigger) wordt gedefinieerd voor de methode voor een functie met de Run naam HttpExample die naar een opslagwachtrij schrijft die is gedefinieerd door de Queue en StorageAccount kenmerken van de msg parameter:

[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, 
    [Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg, 
    ILogger log)
{

Zie de C#-handleiding voor in-process model voor meer informatie.

Verouderde C#-scriptfuncties maken gebruik van een function.json definitiebestand. Zie de naslaginformatie voor ontwikkelaars van Azure Functions C#-scripts (.csx) voor meer informatie.

Voor Java-functies worden triggers en bindingen geconfigureerd door aantekeningen te maken op specifieke methoden en parameters. Deze HTTP-trigger (@HttpTrigger) wordt gedefinieerd voor de methode voor een functie met de run naam HttpTriggerQueueOutput, die naar een opslagwachtrij schrijft die is gedefinieerd door de @QueueOutput aantekening voor de message parameter:

@FunctionName("HttpExample")
public HttpResponseMessage run(
        @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS) 
        HttpRequestMessage<Optional<String>> request, 
        @QueueOutput(name = "msg", queueName = "outqueue", 
        connection = "AzureWebJobsStorage") OutputBinding<String> msg, 
        final ExecutionContext context) {
    context.getLogger().info("Java HTTP trigger processed a request.");

Zie de Java-ontwikkelaarshandleiding voor meer informatie.

De manier waarop triggers en bindingen worden gedefinieerd voor Node.js functies, is afhankelijk van de specifieke versie van Node.js voor Functions:

In Node.js voor Functions versie 4 configureert u triggers en bindingen met behulp van objecten die uit de @azure/functions module zijn geëxporteerd. Zie de Node.js ontwikkelaarshandleiding voor meer informatie.

Dit voorbeeld is een door HTTP geactiveerde functie waarmee een wachtrijitem wordt gemaakt voor elke ontvangen HTTP-aanvraag.

De http methode voor het geëxporteerde app object definieert een HTTP-trigger en de storageQueue methode voor output het definiëren van een uitvoerbinding voor deze trigger.

const { app, output } = require('@azure/functions');

const queueOutput = output.storageQueue({
    queueName: 'outqueue',
    connection: 'MyStorageConnectionAppSetting',
});

app.http('httpTrigger1', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    extraOutputs: [queueOutput],
    handler: async (request, context) => {
        const body = await request.text();
        context.extraOutputs.set(queueOutput, body);
        return { body: 'Created queue item.' };
    },
});

Dit voorbeeldbestand function.json definieert de HTTP-triggerfunctie die een HTTP-antwoord retourneert en schrijft naar een opslagwachtrij.

{
  "bindings": [
    {
      "type": "httpTrigger",
      "direction": "in",
      "authLevel": "function",
      "name": "input"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "myQueueItem",
      "queueName": "outqueue",
      "connection": "MyStorageConnectionAppSetting"
    }
  ]
}

De http methode voor het geëxporteerde app object definieert een HTTP-trigger en de storageQueue methode voor output het definiëren van een uitvoerbinding voor deze trigger.

import { app, HttpRequest, HttpResponseInit, InvocationContext, output } from '@azure/functions';

const queueOutput = output.storageQueue({
    queueName: 'outqueue',
    connection: 'MyStorageConnectionAppSetting',
});

export async function httpTrigger1(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    const body = await request.text();
    context.extraOutputs.set(queueOutput, body);
    return { body: 'Created queue item.' };
}

app.http('httpTrigger1', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    extraOutputs: [queueOutput],
    handler: httpTrigger1,
});

Dit voorbeeldbestand function.json definieert de HTTP-triggerfunctie die een HTTP-antwoord retourneert en schrijft naar een opslagwachtrij.

{
  "bindings": [
    {
      "type": "httpTrigger",
      "direction": "in",
      "authLevel": "function",
      "name": "input"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "myQueueItem",
      "queueName": "outqueue",
      "connection": "MyStorageConnectionAppSetting"
    }
  ]
}

In dit voorbeeldbestand function.json wordt de functie gedefinieerd:

    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "Request",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "Response"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

Zie de Ontwikkelaarshandleiding voor PowerShell voor meer informatie.

De manier waarop de functie wordt gedefinieerd, is afhankelijk van de versie van Python voor Functions:

In Python voor Functions versie 2 definieert u de functie rechtstreeks in code met behulp van decorators.

app = func.FunctionApp(http_auth_level=func.AuthLevel.ANONYMOUS)

@app.route(route="HttpExample")
@app.queue_output(arg_name="msg", queue_name="outqueue", connection="AzureWebJobsStorage")
def HttpExample(req: func.HttpRequest, msg: func.Out [func.QueueMessage]) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')

In Python voor Functions versie 1 definieert dit voorbeeldbestand function.json een HTTP-triggerfunctie die een HTTP-antwoord retourneert en schrijft naar een opslagwachtrij.

    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "Request",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "Response"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

Bindingen toevoegen aan een functie

U kunt uw functie verbinden met andere services met behulp van invoer- of uitvoerbindingen. Voeg een binding toe door de specifieke definities toe te voegen aan uw functie. Zie Bindingen toevoegen aan een bestaande functie in Azure Functions voor meer informatie.

Azure Functions ondersteunt meerdere bindingen, die correct moeten worden geconfigureerd. Een functie kan bijvoorbeeld gegevens lezen uit een wachtrij (invoerbinding) en tegelijkertijd gegevens schrijven naar een database (uitvoerbinding).

Ondersteunde bindingen

Dit tabel geeft de bindingen weer die worden ondersteund in de belangrijkste versies van de Azure Functions-runtime:

Type	1.x¹	2.x en hoger²	Activator	Invoer	Uitvoer
Blob Storage	✔	✔	✔	✔	✔
Azure Cosmos DB	✔	✔	✔	✔	✔
Azure Data Explorer		✔		✔	✔
Azure SQL		✔	✔	✔	✔
Dapr⁴		✔	✔	✔	✔
Event Grid	✔	✔	✔		✔
Event Hubs	✔	✔	✔		✔
HTTP en webhooks	✔	✔	✔		✔
IoT Hub	✔	✔	✔
Kafka³		✔	✔		✔
Mobile Apps	✔			✔	✔
Notification Hubs	✔				✔
Queue Storage	✔	✔	✔		✔
Redis		✔	✔
RabbitMQ³		✔	✔		✔
SendGrid	✔	✔			✔
Service Bus	✔	✔	✔		✔
SignalR		✔	✔	✔	✔
Table Storage	✔	✔		✔	✔
Timer	✔	✔	✔
Twilio	✔	✔			✔

Opmerkingen:

De ondersteuning wordt beëindigd voor versie 1.x van de Azure Functions-runtime op 14 september 2026. We raden u ten zeerste aan uw apps te migreren naar versie 4.x voor volledige ondersteuning.
Vanaf de runtime van versie 2.x moeten alle bindingen behalve HTTP en Timer worden geregistreerd. Raadpleeg Bindingextensies registreren.
Triggers worden niet ondersteund in het verbruiksabonnement. Vereist runtime-gestuurde triggers.
Alleen ondersteund in Kubernetes-, IoT Edge- en andere zelf-hostende modi.

Zie Ondersteunde talen voor informatie over welke bindingen in preview zijn of zijn goedgekeurd voor productiegebruik.

Specifieke versies van bindingsuitbreidingen worden alleen ondersteund terwijl de onderliggende service-SDK wordt ondersteund. Wijzigingen in ondersteuning in de onderliggende service-SDK-versie zijn van invloed op de ondersteuning voor de verbruikende extensie.

Voorbeelden van bindingscode

Gebruik de volgende tabel voor meer voorbeelden van specifieke bindingstypen die laten zien hoe u met bindingen in uw functies kunt werken. Kies eerst het taaltabblad dat overeenkomt met uw project.

Bindingscode voor C# is afhankelijk van het specifieke procesmodel.

Geïsoleerd proces
In-proces

Service	Voorbeelden	Voorbeelden
Blob-opslag	Trigger Invoer Uitvoer	Koppeling
Azure Cosmos DB	Trigger Invoer Uitvoer	Koppeling
Azure Data Explorer	Invoer Uitvoer	Koppeling
Azure SQL	Trigger Invoer Uitvoer	Koppeling
Event Grid	Trigger Uitvoer	Koppeling
Event Hubs	Trigger Uitvoer
IoT Hub	Trigger Uitvoer
HTTP	Trigger	Koppeling
Queue Storage	Trigger Uitvoer	Koppeling
RabbitMQ	Trigger Uitvoer
SendGrid	Uitvoer
Service Bus	Trigger Uitvoer	Koppeling
SignalR	Trigger Invoer Uitvoer
Table Storage	Invoer Uitvoer
Timer	Trigger	Koppeling
Twilio	Uitvoer	Koppeling

Service	Voorbeelden	Voorbeelden
Blob-opslag	Trigger Invoer Uitvoer	Koppeling
Azure Cosmos DB	Trigger Invoer Uitvoer	Koppeling
Azure Data Explorer	Invoer Uitvoer	Koppeling
Azure SQL	Trigger Invoer Uitvoer	Koppeling
Event Grid	Trigger Uitvoer	Koppeling
Event Hubs	Trigger Uitvoer
IoT Hub	Trigger Uitvoer
HTTP	Trigger	Koppeling
Queue Storage	Trigger Uitvoer	Koppeling
RabbitMQ	Trigger Uitvoer
SendGrid	Uitvoer
Service Bus	Trigger Uitvoer	Koppeling
SignalR	Trigger Invoer Uitvoer
Table Storage	Invoer Uitvoer
Timer	Trigger	Koppeling
Twilio	Uitvoer	Koppeling

Service	Voorbeelden	Voorbeelden
Blob-opslag	Trigger Invoer Uitvoer	Koppeling
Azure Cosmos DB	Trigger Invoer Uitvoer	Koppeling
Azure Data Explorer	Invoer Uitvoer	Koppeling
Azure SQL	Trigger Invoer Uitvoer
Event Grid	Trigger Uitvoer	Koppeling
Event Hubs	Trigger Uitvoer
IoT Hub	Trigger Uitvoer
HTTP	Trigger	Koppeling
Queue Storage	Trigger Uitvoer	Koppeling
RabbitMQ	Trigger Uitvoer
SendGrid	Uitvoer
Service Bus	Trigger Uitvoer	Koppeling
SignalR	Trigger Invoer Uitvoer
Table Storage	Invoer Uitvoer
Timer	Trigger	Koppeling
Twilio	Uitvoer	Koppeling

Service	Voorbeelden	Voorbeelden
Blob-opslag	Trigger Invoer Uitvoer	Koppeling
Azure Cosmos DB	Trigger Invoer Uitvoer	Koppeling
Azure Data Explorer	Invoer Uitvoer
Azure SQL	Trigger Invoer Uitvoer	Koppeling
Event Grid	Trigger Uitvoer	Koppeling
Event Hubs	Trigger Uitvoer
IoT Hub	Trigger Uitvoer
HTTP	Trigger	Koppeling
Queue Storage	Trigger Uitvoer	Koppeling
RabbitMQ	Trigger Uitvoer
SendGrid	Uitvoer
Service Bus	Trigger Uitvoer	Koppeling
SignalR	Trigger Invoer Uitvoer
Table Storage	Invoer Uitvoer
Timer	Trigger	Koppeling
Twilio	Uitvoer	Koppeling

Service	Voorbeelden	Voorbeelden
Blob-opslag	Trigger Invoer Uitvoer	Koppeling
Azure Cosmos DB	Trigger Invoer Uitvoer	Koppeling
Azure SQL	Trigger Invoer Uitvoer
Event Grid	Trigger Uitvoer	Koppeling
Event Hubs	Trigger Uitvoer
IoT Hub	Trigger Uitvoer
HTTP	Trigger	Koppeling
Queue Storage	Trigger Uitvoer	Koppeling
RabbitMQ	Trigger Uitvoer
SendGrid	Uitvoer
Service Bus	Trigger Uitvoer	Koppeling
SignalR	Trigger Invoer Uitvoer
Table Storage	Invoer Uitvoer
Timer	Trigger	Koppeling
Twilio	Uitvoer	Koppeling

Bindingscode voor Python is afhankelijk van de python-modelversie.

Service	Voorbeelden	Voorbeelden
Blob-opslag	Trigger Invoer Uitvoer	Koppeling
Azure Cosmos DB	Trigger Invoer Uitvoer	Koppeling
Azure Data Explorer	Invoer Uitvoer
Azure SQL	Trigger Invoer Uitvoer	Koppeling
Event Grid	Trigger Uitvoer	Koppeling
Event Hubs	Trigger Uitvoer
IoT Hub	Trigger Uitvoer
HTTP	Trigger	Koppeling
Queue Storage	Trigger Uitvoer	Koppeling
RabbitMQ	Trigger Uitvoer
SendGrid	Uitvoer
Service Bus	Trigger Uitvoer	Koppeling
SignalR	Trigger Invoer Uitvoer
Table Storage	Invoer Uitvoer
Timer	Trigger	Koppeling
Twilio	Uitvoer	Koppeling

Service	Voorbeelden	Voorbeelden
Blob-opslag	Trigger Invoer Uitvoer	Koppeling
Azure Cosmos DB	Trigger Invoer Uitvoer	Koppeling
Azure Data Explorer	Invoer Uitvoer
Azure SQL	Trigger Invoer Uitvoer	Koppeling
Event Grid	Trigger Uitvoer	Koppeling
Event Hubs	Trigger Uitvoer
IoT Hub	Trigger Uitvoer
HTTP	Trigger	Koppeling
Queue Storage	Trigger Uitvoer	Koppeling
RabbitMQ	Trigger Uitvoer
SendGrid	Uitvoer
Service Bus	Trigger Uitvoer	Koppeling
SignalR	Trigger Invoer Uitvoer
Table Storage	Invoer Uitvoer
Timer	Trigger	Koppeling
Twilio	Uitvoer	Koppeling

Aangepaste bindingen

U kunt aangepaste invoer- en uitvoerbindingen maken. Bindingen moeten worden gemaakt in .NET, maar kunnen worden gebruikt vanuit elke ondersteunde taal. Zie Aangepaste invoer- en uitvoerbindingen maken voor meer informatie over het maken van aangepaste bindingen.

Delen via

Concepten van Azure Functions-triggers en -bindingen

Trigger- en bindingsdefinities

Bindingen toevoegen aan een functie

Ondersteunde bindingen

Voorbeelden van bindingscode

Aangepaste bindingen

Feedback

Aanvullende resources

Delen via

Concepten van Azure Functions-triggers en -bindingen

Trigger- en bindingsdefinities

Bindingen toevoegen aan een functie

Ondersteunde bindingen

Voorbeelden van bindingscode

Aangepaste bindingen

Gerelateerde inhoud

Feedback

Aanvullende resources