Déclencheurs et liaisons Azure Functions

Dans cet article, vous allez découvrir les concepts généraux entourant les déclencheurs et les liaisons pour les fonctions.

Les déclencheurs sont à l’origine de l’exécution d’une fonction. Un déclencheur définit la façon dont une fonction est appelée et une fonction doit avoir exactement un déclencheur. Les déclencheurs peuvent également transmettre des données à votre fonction, comme vous le feriez avec des appels de méthode.

La liaison à une fonction est un moyen de connecter de manière déclarative vos fonctions à d’autres ressources. Les liaisons passent des données dans votre fonction ( une liaison d’entrée) ou vous permettent d’écrire des données à partir de votre fonction (une liaison de sortie) à l’aide de paramètres de liaison. Votre déclencheur de fonction est essentiellement un type spécial de liaison d’entrée.

Vous pouvez combiner et adapter des liaisons selon les besoins spécifiques de votre fonctionnalité. Les liaisons sont facultatives et une fonction peut avoir une ou plusieurs liaisons d’entrée et/ou de sortie.

Les déclencheurs et les liaisons vous évitent d’avoir à coder en dur l’accès aux autres services. Votre fonction reçoit des données (par exemple, le contenu d’un message de la file d’attente) dans les paramètres de fonction. Vous envoyez des données (par exemple pour créer un message de la file d’attente) en utilisant la valeur de retour de la fonction.

Tenez compte des exemples suivants de la façon dont vous pouvez implémenter des fonctions :

Exemple de scénario	Déclencheur	Liaison d’entrée	Liaison de sortie
Un nouveau message en file d’attente arrive, qui exécute une fonction pour écrire des données dans une autre file d’attente.	File d’attente^*	Aucun	File d’attente^*
Une tâche planifiée lit le contenu du stockage Blob Azure et crée un document Azure Cosmos DB.	Minuterie	Stockage Blob	Base de données Azure Cosmos DB
Azure Event Grid est utilisé pour lire une image à partir du stockage Blob et un document d’Azure Cosmos DB pour envoyer un e-mail.	Grid d'événements	Stockage d’objets blob et Azure Cosmos DB	SendGrid

^* Représente différentes files d’attente.

Ces exemples ne sont pas destinés à être exhaustifs, mais ils illustrent comment vous pouvez utiliser des déclencheurs et des liaisons ensemble. Pour obtenir un ensemble plus complet de scénarios, consultez scénarios Azure Functions.

Conseil

Azure Functions ne vous oblige pas à utiliser des liaisons d’entrée et de sortie pour vous connecter aux services Azure. Vous pouvez toujours créer un client du Kit de développement logiciel (SDK) Azure dans votre code et l’utiliser à la place pour vos transferts de données. Pour en savoir plus, référez-vous à la section Se connecter aux services.

Définitions de liaisons et de déclencheurs

L’exemple suivant montre une fonction déclenchée par HTTP avec une liaison de sortie qui écrit un message dans une file d’attente de stockage Azure.

Pour les fonctions de bibliothèque de classes C#, vous configurez des déclencheurs et des liaisons en décorant des méthodes et des paramètres avec des attributs C#. L’attribut spécifique que vous appliquez peut dépendre du modèle d’exécution C# :

Modèle Worker isolé
Modèle in-process

Le déclencheur HTTP (HttpTrigger) est défini sur la méthode Run pour une fonction nommée HttpExample qui retourne un objet MultiResponse :

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

Cet exemple montre la définition d’objet MultiResponse . La définition d’objet retourne HttpResponse à la requête HTTP et écrit un message dans une file d’attente de stockage à l’aide d’une liaison de QueueOutput :

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

Pour plus d’informations, consultez le Guide C# des modèles Worker isolés.

Le déclencheur HTTP (HttpTrigger) est défini sur la Run méthode d’une fonction nommée HttpExample. Cette fonction écrit dans une file d’attente de stockage que les attributs Queue et StorageAccount définissent sur le paramètre msg :

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

Pour plus d’informations, consultez le guide C# pour les modèles in-process.

Les fonctions de script C# héritées utilisent un function.json fichier de définition. Pour plus d’informations, consultez la référence du développeur de script C# (.csx) Azure Functions.

Pour les fonctions Java, vous configurez des déclencheurs et des liaisons en annoteant des méthodes et des paramètres spécifiques. Ce déclencheur HTTP (@HttpTrigger) est défini sur la run méthode d’une fonction nommée HttpExample. La fonction écrit dans une file d’attente de stockage nommée outqueue que l’annotation @QueueOutput définit sur le msg paramètre :

@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.");

Pour plus d’informations, consultez le guide des développeurs Java.

La façon dont vous définissez des déclencheurs et des liaisons pour les fonctions Node.js dépend de la version spécifique de Node.js pour Azure Functions :

Dans Node.js pour Azure Functions version 4, vous configurez des déclencheurs et des liaisons à l’aide d’objets exportés à partir du @azure/functions module. Pour plus d’informations, consultez le guide pour développeurs Node.js.

La http méthode sur l’objet exporté app définit un déclencheur HTTP. La méthode storageQueue sur output définit une liaison de sortie sur ce déclencheur.

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.' };
    },
});

Cet exemple de function.json fichier définit la fonction de déclencheur HTTP qui retourne une réponse HTTP et écrit dans une file d’attente de stockage :

{
  "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"
    }
  ]
}

La http méthode sur l’objet exporté app définit un déclencheur HTTP. La méthode storageQueue sur output définit une liaison de sortie sur ce déclencheur.

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,
});

Cet exemple de function.json fichier définit la fonction de déclencheur HTTP qui retourne une réponse HTTP et écrit dans une file d’attente de stockage :

{
  "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"
    }
  ]
}

Cet exemple de fichier function.json définit la fonction :

    {
      "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"
    }
  ]
}

Pour plus d’informations, consultez le guide des développeurs PowerShell.

La façon dont la fonction est définie dépend de la version de Python pour Azure Functions :

Dans Python pour Azure Functions version 2, vous définissez la fonction directement dans le code à l’aide de décorateurs :

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.')

Dans Python pour Azure Functions version 1, cet exemple function.json de fichier définit une fonction de déclencheur HTTP qui retourne une réponse HTTP et écrit dans une file d’attente de stockage :

    {
      "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"
    }
  ]
}

Considérations relatives à la liaison

Tous les services ne prennent pas en charge les liaisons d’entrée et de sortie. Consultez votre extension de liaison spécifique pour des exemples de code spécifiques pour les liaisons.
La définition des déclencheurs et des liaisons varie selon le langage de développement. Veillez à sélectionner votre langue en haut de cet article.
Les noms de déclencheur et de liaison sont limités aux caractères alphanumériques et _, le trait de soulignement.

Tâche d’ajouter des liaisons à une fonction

Vous pouvez connecter votre fonction à d’autres services en utilisant des liaisons d’entrée ou de sortie. Ajoutez une liaison en ajoutant ses définitions spécifiques à votre fonction. Pour savoir comment procéder, consultez Ajouter des liaisons à une fonction existante dans Azure Functions.

Azure Functions prend en charge plusieurs liaisons qui doivent être configurées correctement. Par exemple, une fonction peut simultanément lire des données d’une file d’attente (liaison d’entrée) et écrire des données dans une base de données (liaison de sortie).

Liaisons prises en charge

Ce tableau présente les liaisons qui sont prises en charge dans les versions majeures du runtime Azure Functions :

Type	4.x¹	1.x²	Déclencheur	Entrée	Output
Stockage Blob	✔	✔	✔	✔	✔
Azure Cosmos DB	✔	✔	✔	✔	✔
Explorateur de données Azure	✔			✔	✔
Azure SQL	✔		✔	✔	✔
Dapr⁴	✔		✔	✔	✔
Event Grid	✔	✔	✔		✔
Hubs d'événements	✔	✔	✔		✔
HTTP et webhooks	✔	✔	✔		✔
IoT Hub	✔	✔	✔
Kafka³	✔		✔		✔
Applications mobiles		✔		✔	✔
Protocole de contexte de modèle	✔		✔
Notification Hubs		✔		✔
Stockage de files d’attente	✔	✔	✔		✔
Redis	✔		✔	✔	✔
RabbitMQ³	✔		✔		✔
SendGrid	✔	✔			✔
Service Bus	✔	✔	✔		✔
Azure SignalR Service	✔		✔	✔	✔
Stockage de table	✔	✔		✔	✔
Minuteur	✔	✔	✔
Twilio	✔	✔			✔

Inscrivez toutes les liaisons, à l’exception de HTTP et du minuteur. Consultez Enregistrer les extensions de liaison Azure Functions. Cette étape n’est pas nécessaire lors de l’utilisation de la version 1.x du runtime Functions.
La prise en charge se termine pour la version 1.x du runtime Azure Functions le 14 septembre 2026. Migrez vos applications vers la version 4.x pour une prise en charge complète.
Les déclencheurs ne sont pas pris en charge dans le plan Consommation. Ce type de liaison nécessite des déclencheurs pilotés par l'exécution.
Ce type de liaison est pris en charge dans Kubernetes, Azure IoT Edge et d’autres modes auto-hébergés uniquement.

Pour plus d’informations sur les liaisons en préversion ou approuvées pour la production, consultez Langages pris en charge.

Les versions spécifiques des extensions de liaison ne sont prises en charge que lorsque le SDK de service sous-jacent est pris en charge. Les modifications apportées à la prise en charge dans la version du Kit de développement logiciel (SDK) de service sous-jacent affectent la prise en charge de l’extension consommatrice.

Types de SDK

Les extensions de liaison Azure Functions utilisent des sdk de service Azure pour se connecter aux services Azure. Les types de SDK spécifiques utilisés par les liaisons peuvent affecter la façon dont vous travaillez avec les données de vos fonctions. Certaines liaisons prennent en charge des types spécifiques au SDK qui fournissent des fonctionnalités plus riches et une meilleure intégration au service, tandis que d’autres utilisent des types génériques comme des chaînes ou des tableaux d’octets. Lorsqu’ils sont disponibles, l’utilisation de types spécifiques au KIT de développement logiciel (SDK) peut offrir des avantages tels que une meilleure sécurité des types, une manipulation des données plus facile et un accès aux fonctionnalités spécifiques au service.

Ce tableau indique les extensions de liaison qui prennent actuellement en charge les types de SDK :

Extension	Les types	Niveau du support
Stockage Blob Azure	`BlobClient` `BlobContainerClient` `BlockBlobClient` `PageBlobClient` `AppendBlobClient`	Déclencheur : GA Entrée : disponibilité générale
Azure Cosmos DB	`CosmosClient` `Database` `Container`	Entrée : GA
Azure Event Grid	`CloudEvent` `EventGridEvent`	Déclencheur : GA
Azure Event Hubs	`EventData` `EventHubProducerClient`	Déclencheur : GA
Stockage de files d'attente Azure	`QueueClient` `QueueMessage`	Déclencheur : disponibilité générale (GA)
Azure Service Bus	`ServiceBusClient` `ServiceBusReceiver` `ServiceBusSender` `ServiceBusMessage`	Déclencheur : GA
Stockage de tables Azure	`TableClient` `TableEntity`	Entrée : GA

Considérations relatives aux types de SDK :

Lorsque vous utilisez des expressions de liaison qui s’appuient sur des données de déclencheur, les types de SDK pour le déclencheur lui-même ne peuvent pas être utilisés.
Pour les scénarios de sortie où vous pouvez utiliser un type de KIT de développement logiciel (SDK), créez et travaillez directement avec des clients sdk au lieu d’utiliser une liaison de sortie.
Le déclencheur Azure Cosmos DB utilise le flux de modification Azure Cosmos DB et expose les éléments de flux de modification en tant que types sérialisables JSON. Par conséquent, les types de SDK ne sont pas pris en charge pour ce déclencheur.

Pour plus d’informations, consultez les types de SDK dans le guide du développeur C#.

Extension	Les types	Niveau du support	Exemples
Stockage Blob Azure	`BlobClient` `ContainerClient` `StorageStreamDownloader`	Déclencheur : GA Entrée : GA	Démarrage rapide `BlobClient` `ContainerClient` `StorageStreamDownloader`
Azure Cosmos DB	`CosmosClient` `DatabaseProxy` `ContainerProxy`	Entrée : préversion	Démarrage rapide `ContainerProxy` `CosmosClient` `DatabaseProxy`
Azure Event Hubs	`EventData`	Déclencheur : aperçu	Démarrage rapide `EventData`
Azure Service Bus	`ServiceBusReceivedMessage`	Déclencheur : aperçu	Démarrage rapide `ServiceBusReceivedMessage`

Considérations relatives aux types de SDK :

Pour les scénarios de sortie où vous pouvez utiliser un type de KIT de développement logiciel (SDK), créez et travaillez directement avec des clients sdk au lieu d’utiliser une liaison de sortie.
Le déclencheur Azure Cosmos DB utilise le flux de modification Azure Cosmos DB et expose les éléments de flux de modification en tant que types sérialisables JSON. Par conséquent, les types de SDK ne sont pas pris en charge pour ce déclencheur.

Les types de SDK sont pris en charge uniquement lors de l’utilisation du modèle de programmation Python v2. Pour plus d’informations, consultez les liaisons de type sdk dans le guide du développeur Python.

Extension	Les types	Niveau du support
Stockage Blob Azure	`BlobClient` `ContainerClient` `ReadableStream`	Preview
Azure Service Bus	`ServiceBusClient` `ServiceBusReceiver` `ServiceBusSender` `ServiceBusMessage`	Preview

Les types de SDK sont pris en charge uniquement lors de l’utilisation du modèle de programmation Node v4. Pour plus d’informations, consultez les types de SDK dans le guide du développeur Node.js.

Extension	Les types	Niveau du support
Stockage Blob Azure	`BlobClient` `BlobContainerClient`	Preview

Pour plus d’informations, consultez les types de SDK dans le guide du développeur Java.

Important

Les types de SDK ne sont actuellement pas pris en charge pour les applications PowerShell.

Exemples de code pour les liaisons

Utilisez le tableau suivant pour trouver davantage d’exemples de types de liaisons spécifiques qui vous montrent comment utiliser des liaisons dans vos fonctions. Tout d’abord, choisissez l’onglet du langage qui correspond à votre projet.

Le code de liaison pour C# dépend du modèle de processus spécifique.

Processus isolé
In-process

Service	Exemples	Exemples
Stockage Blob	Déclencheur Input Sortie	Lien
Base de données Azure Cosmos DB	Déclencheur Input Sortie	Lien
Explorateur de données Azure	Input Sortie	Lien
Azure SQL	Déclencheur Input Sortie	Lien
Grid d'événements	Déclencheur Sortie	Lien
Event Hubs	Déclencheur Sortie
IoT Hub	Déclencheur Sortie
HTTP	Déclencheur	Lien
Stockage File d’attente	Déclencheur Sortie	Lien
RabbitMQ	Déclencheur Sortie
SendGrid	Sortie
Bus de Service	Déclencheur Sortie	Lien
Azure SignalR Service	Déclencheur Input Sortie
Stockage Table	Input Sortie
Minuterie	Déclencheur	Lien
Twilio	Sortie	Lien

Service	Exemples	Exemples
Stockage Blob	Déclencheur Input Sortie	Lien
Base de données Azure Cosmos DB	Déclencheur Input Sortie	Lien
Explorateur de données Azure	Input Sortie	Lien
Azure SQL	Déclencheur Input Sortie	Lien
Grid d'événements	Déclencheur Sortie	Lien
Event Hubs	Déclencheur Sortie
IoT Hub	Déclencheur Sortie
HTTP	Déclencheur	Lien
Stockage File d’attente	Déclencheur Sortie	Lien
RabbitMQ	Déclencheur Sortie
SendGrid	Sortie
Bus de Service	Déclencheur Sortie	Lien
Azure SignalR Service	Déclencheur Input Sortie
Stockage Table	Input Sortie
Minuterie	Déclencheur	Lien
Twilio	Sortie	Lien

Service	Exemples	Exemples
Stockage Blob	Déclencheur Input Sortie	Lien
Base de données Azure Cosmos DB	Déclencheur Input Sortie	Lien
Explorateur de données Azure	Input Sortie	Lien
Azure SQL	Déclencheur Input Sortie
Grid d'événements	Déclencheur Sortie	Lien
Event Hubs	Déclencheur Sortie
IoT Hub	Déclencheur Sortie
HTTP	Déclencheur	Lien
Stockage File d’attente	Déclencheur Sortie	Lien
RabbitMQ	Déclencheur Sortie
SendGrid	Sortie
Bus de Service	Déclencheur Sortie	Lien
Azure SignalR Service	Déclencheur Input Sortie
Stockage Table	Input Sortie
Minuterie	Déclencheur	Lien
Twilio	Sortie

Service	Exemples	Exemples
Stockage Blob	Déclencheur Input Sortie	Lien
Base de données Azure Cosmos DB	Déclencheur Input Sortie	Lien
Explorateur de données Azure	Input Sortie
Azure SQL	Déclencheur Input Sortie	Lien
Grid d'événements	Déclencheur Sortie
Event Hubs	Déclencheur Sortie
IoT Hub	Déclencheur Sortie
HTTP	Déclencheur	Lien
Stockage File d’attente	Déclencheur Sortie	Lien
RabbitMQ	Déclencheur Sortie
SendGrid	Sortie
Bus de Service	Déclencheur Sortie	Lien
Azure SignalR Service	Déclencheur Input Sortie
Stockage Table	Input Sortie
Minuterie	Déclencheur
Twilio	Sortie

Service	Exemples	Exemples
Stockage Blob	Déclencheur Input Sortie
Base de données Azure Cosmos DB	Déclencheur Input Sortie
Azure SQL	Déclencheur Input Sortie
Grid d'événements	Déclencheur Sortie
Event Hubs	Déclencheur Sortie
IoT Hub	Déclencheur Sortie
HTTP	Déclencheur	Lien
Stockage File d’attente	Déclencheur Sortie
RabbitMQ	Déclencheur Sortie
SendGrid	Sortie
Bus de Service	Déclencheur Sortie
Azure SignalR Service	Déclencheur Input Sortie
Stockage Table	Input Sortie
Minuterie	Déclencheur
Twilio	Sortie

Le code de liaison pour Python dépend de la version du modèle Python.

Service	Exemples	Exemples
Stockage Blob	Déclencheur Input Sortie	Lien
Base de données Azure Cosmos DB	Déclencheur Input Sortie	Lien
Explorateur de données Azure	Input Sortie
Azure SQL	Déclencheur Input Sortie	Lien
Grid d'événements	Déclencheur Sortie
Event Hubs	Déclencheur Sortie
IoT Hub	Déclencheur Sortie
HTTP	Déclencheur	Lien
Stockage File d’attente	Déclencheur Sortie
RabbitMQ	Déclencheur Sortie
SendGrid	Sortie
Bus de Service	Déclencheur Sortie	Lien
Azure SignalR Service	Déclencheur Input Sortie
Stockage Table	Input Sortie
Minuterie	Déclencheur
Twilio	Sortie

Service	Exemples	Exemples
Stockage Blob	Déclencheur Input Sortie
Base de données Azure Cosmos DB	Déclencheur Input Sortie
Explorateur de données Azure	Input Sortie
Azure SQL	Déclencheur Input Sortie	Lien
Grid d'événements	Déclencheur Sortie
Event Hubs	Déclencheur Sortie
IoT Hub	Déclencheur Sortie
HTTP	Déclencheur
Stockage File d’attente	Déclencheur Sortie
RabbitMQ	Déclencheur Sortie
SendGrid	Sortie
Bus de Service	Déclencheur Sortie
Azure SignalR Service	Déclencheur Input Sortie
Stockage Table	Input Sortie
Minuterie	Déclencheur
Twilio	Sortie

Liaisons personnalisées

Vous pouvez créer des liaisons d’entrée et de sortie personnalisées. Les liaisons doivent être créées dans .NET, mais elles peuvent être consommées à partir de n’importe quel langage pris en charge. Pour plus d’informations sur la création de liaisons personnalisées, consultez Création de liaisons d’entrée et de sortie personnalisées.

Rétroaction

Cette page vous a-t-elle été utile ?

Last updated on 2025-12-17