Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure Functions fournit des extensions de déclenchement et de liaison qui s’intègrent à divers services, principalement les services Azure. L’extension Connector élargit ces intégrations via des connecteurs gérés dans Azure espace de noms Connector, permettant à vos fonctions de recevoir des événements provenant de systèmes métier et de plateformes de données tels que Office 365 Outlook, SharePoint Online, Microsoft Teams et Dataverse.
Pour les connecteurs Microsoft et gérés par des tiers disponibles, consultez la référence des connecteurs.
Note
Les connecteurs gérés prennent en charge les plans d’hébergement Flex Consumption, Dedicated et Elastic Premium pour les applications Linux Function dans toutes les régions. La disponibilité des applications Windows est limitée aujourd’hui.
Flex Consumption est le plan d’hébergement recommandé pour les fonctions déclenchées par le connecteur.
Note
Le déclencheur de connecteur n’est actuellement pas pris en charge pour ce langage.
| À | Utiliser |
|---|---|
| Exécuter une fonction en réponse à un événement dans un service connecté | Déclencheur de connecteur, fourni par l’extension de connecteur |
| Exécuter une action dans un service connecté à partir d’un code de fonction | Azure Connectors SDK, disponible pour .NET, Node.jset Python |
Vous pouvez utiliser les deux ensemble : le déclencheur de connecteur démarre votre fonction, et le SDK effectue des actions dans les services connectés. Si vous n’avez besoin que d’effectuer des actions, utilisez le SDK sans l’extension du connecteur.
Pour plus d’informations sur les connecteurs gérés, le moment de leur utilisation et la disponibilité des fonctionnalités, voir Utiliser les connecteurs gérés dans Azure Functions.
Déclencheur de connecteur dans Azure Functions
Une fonction déclenchée par un connecteur utilise ces composantes :
| Component | Responsabilité |
|---|---|
| Espace de noms du connecteur | Les hôtes géraient les connexions des connecteurs et les configurations de déclenchement. |
| Connexion de connecteur gérée | Authentifie auprès du service externe et gère la connectivité spécifique au service. |
| Configuration de déclencheur | Sélectionne l’événement du connecteur, les paramètres de fonctionnement et le mode de livraison. |
| Extension Azure Functions Connector | Reçoit les événements de l’espace de noms du connecteur, invoque la fonction et lie le corps de l’événement au paramètre de la fonction. |
| SDK Azure Connectors (optionnel) | Fournit des modèles et clients optionnels à charges utiles fortement saisies pour invoquer des opérations de connecteurs gérés, comme l’envoi d’un e-mail ou la création d’un fichier SharePoint. |
Un connecteur géré peut supporter plusieurs événements, et chaque événement que vous souhaitez surveiller nécessite sa propre configuration de déclencheurs. Par exemple, le connecteur Office 365 Outlook prend en charge des événements tels qu’un nouvel e-mail arrivant, un e-mail signalé, un événement de calendrier créé ou un événement de calendrier modifié. Créez une configuration de déclencheur distincte pour chaque événement que vous souhaitez utiliser pour exécuter une fonction.
Pour des exemples de code, voir Exemples de déclencheurs de connecteurs et Utilisation des SDK de connecteurs dans votre code.
Choisissez un mode de livraison
Les connecteurs gérés supportent la livraison webhook et polling. Choisissez un mode en fonction de la latence, de la capacité de traitement, des besoins réseau et d’authentification de votre scénario :
| Feature | Sondages | Webhook |
|---|---|---|
| Livraison des événements et latence | L’hôte Fonctions récupère les événements via des requêtes de sondage sortantes. Les événements attendent que l’hôte les vote pour eux. | L’espace de noms de connecteur envoie les événements vers le point de terminaison de rappel de l’application de fonction dès qu’elle les récupère depuis le service source, sans attendre que l’application interroge. Cela réduit la latence de livraison pour un traitement sensible au temps. |
| Capacité de traitement et protection en aval | L’hôte récupère davantage d’événements à mesure que la capacité de traitement devient disponible. Combinez les limites d’échelle des applications avec les paramètres de concurrence des sondages pour limiter un traitement simultané et protéger les bases de données ou API en aval. Les événements en attente restent en file d’attente dans l’espace de noms du connecteur, sous réserve de ses limites de rétention d’événements. | Les événements arrivent indépendamment de la capacité de traitement disponible de l’application. Les limites de mise en gamme peuvent entraîner des rappels limités ou échoués lorsque la demande dépasse la capacité ; les événements peuvent être perdus si la livraison ne réussit pas dans les limites de réévaluation du service. |
| Mise en réseau entrante | Aucun point de terminaison de rappel entrant n’est requis. Vous pouvez restreindre l’accès entrant à l’application de fonction tout en permettant les requêtes sortantes vers le point de sondage de l’espace de noms du connecteur. | L’espace de noms du connecteur doit pouvoir atteindre le point de terminaison de rappel de l’application. Les restrictions entrantes doivent permettre ces requêtes. |
| Authentification d’identité managée | L’hôte Fonctions peut utiliser l’identité gérée assignée par le système ou l’utilisateur de l’application de fonctions pour recevoir et accuser réception des événements. Accorder à cette identité une politique d’accès sur la connexion du connecteur géré. | Pour les rappels authentifiés avec Microsoft Entra ID, l’espace de noms du connecteur utilise son identité gérée. Configurez l’authentification intégrée du service d’application sur l’application de fonction réceptrice pour valider les jetons. L’authentification webhook par défaut utilise plutôt la clé système d’extension Connector. |
Selon votre forfait d’hébergement, vous pouvez restreindre l’accès entrant à l’application de fonctions via des points de terminaison privés ou des restrictions d’accès entrants, y compris les restrictions basées sur l’IP ou les restreintes de service endpoint, sans empêcher l’interrogation. L’application doit toujours pouvoir effectuer des requêtes HTTPS sortantes vers le point de sondage du Connector Namespace. Par ailleurs, l’identité gérée configurée de l’application de fonction doit avoir une politique d’accès sur la connexion du connecteur géré.
Le mode de livraison d’événements contrôle la manière dont les événements atteignent l’hôte Fonctions depuis l’espace de noms du connecteur, et non la manière dont le connecteur géré détecte les changements dans le service source.
La livraison Webhook évolue comme les déclencheurs HTTP, tandis que la livraison par sondage utilise une mise à l’échelle basée sur la cible. L’objectif de mise à l’échelle des sondages est indépendant de la concurrence des auditeurs et de la taille du lot. Pour plus de détails sur les deux modes, voir Mise à l’échelle et la concurrence du déclencheur du connecteur. Pour l’équation de mise à l’échelle et les paramètres de mise à l’échelle des sondages, voir Ajustement ciblé des connecteurs gérés.
Les deux modes utilisent [ConnectorTrigger] le paramètre de fonction qui reçoit le corps de l’événement et peuvent utiliser les mêmes modèles de charge utile. Pour des exemples des deux modes de distribution, voir les exemples du déclencheur du connecteur.
Installer des packages
Rallonge de connecteur
Le déclencheur de connecteur prend en charge le modèle de travailleur isolé .NET. Pour des informations sur les versions prises en charge de .NET dans les versions d’exécution d’Azure Functions, voir Langages par version d’exécution.
Ajoutez la version 1.0.0 ou ultérieure du paquet d’extension Connector à votre projet.
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Connector
SDKs des connecteurs Azure
Si votre fonction n'a besoin que d'effectuer des actions sur des services externes et n'a pas besoin d'être déclenchée par des événements, utilisez uniquement le SDK Azure Connectors. Vous n’avez pas besoin du package d’extension Connector.
Ajoutez le SDK Azure Connectors :
dotnet add package Azure.Connectors.Sdk
Pour les connecteurs populaires, le SDK fournit des clients fortement typés pour invoquer des actions de connecteur depuis vos fonctions ; voir la référence de référence de l’API Azure Connectors SDK pour .NET.
Installer l’extension
Utilisez Node.js 24 ou plus récent. Les deux modes de livraison utilisent les assistants d’enregistrement de déclencheurs avec le même nom ou génériques.
Installez les paquets utilisés par le déclencheur Connector :
npm install "@azure/functions@latest" "@azure/functions-extensions-connectors@latest" "@azure/connectors@latest"
Ces packages offrent les fonctionnalités suivantes :
-
@azure/functions fournit l’enregistrement de base
connectorTrigger, qui reçoit l’entrée de déclenchement sous forme de type générique par défautunknownsur . - @azure/functions-extensions-connectors encapsule l’entrée dans un contexte de déclenchement de connecteur normalisé et fournit des contextes typés pour les opérations de connecteur prises en charge.
- @azure/connectors, le SDK Azure Connectors pour Node.js, fournit les modèles de charge utile utilisés par ces contextes et clients pour appeler les opérations de connecteur.
Configurez le bundle d’extensions dans le fichier host.json . Le bundle fournit l’extension hôte Connector pour les deux modes de livraison :
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.*, 5.0.0)"
}
}
Azure Connectors SDK
Si votre fonction n'a besoin d'effectuer que des actions sur des services externes et n'a pas besoin d'être déclenchée par des événements, installez uniquement le SDK Azure Connectors pour Node.js. Vous n’avez pas besoin des paquets déclencheurs Connector.
npm install "@azure/connectors@latest"
Le SDK fournit des clients fortement typés pour invoquer les actions de connecteur depuis vos fonctions.
Pour les versions actuelles des paquets et les projets complets, voir les exemples de connecteurs Azure Functions pour TypeScript.
Les deux modes de livraison utilisent le @app.connector_trigger décorateur. Pour des exemples, voir exemples de déclencheurs de connecteur.
Installer l’extension
Ajoutez les paquets suivants à requirements.txt:
azure-functions>=2.4.0
azurefunctions-extensions-connectors>=1.0.0
Note
Pour les versions Python antérieures à la 3.13, utilisez azure-functions>=1.27.0b1 à la place.
- La bibliothèque Python de base Azure-functions fournit le décorateur et peut lier des événements bruts uniques à
stroubytes, ou des lots de sondage àtyping.List[str]outyping.List[bytes]. - Le package azurefunctions-extensions-connectors intègre le SDK Azure Connectors pour Python et enregistre les convertisseurs pour les annotations SDK spécifiques à l’opération supportées. Par exemple,
emails: list[office365.GraphClientReceiveMessage], oùoffice365est importé depuisazurefunctions.extensions.connectors, reçoit des objets de modèle de messagerie pour l’opération Office 365 OutlookOnNewEmailV3.
Configurez le bundle d’extensions dans le fichier host.json . Le bundle fournit l’extension hôte Connector pour les deux modes de livraison :
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.*, 5.0.0)"
}
}
Azure Connectors SDK
Si votre fonction n'a besoin d'effectuer que des actions sur des services externes et n'a pas besoin d'être déclenchée par des événements, installez uniquement le SDK Azure Connectors pour Python. Vous n’avez pas besoin des paquets déclencheurs Connector.
python -m pip install "azure-connectors>=1.0.0"
Le SDK fournit des clients fortement typés pour invoquer les actions de connecteur depuis vos fonctions.
Pour les versions actuelles des paquets et les projets complets, voir les exemples de connecteurs Azure Functions pour Python.
Paramètres host.json
L’extension Connector ne nécessite pas de paramètres spécifiques au connecteur dans le fichier host.json lorsque vous utilisez les paramètres par défaut.
Les sections suivantes montrent les paramètres optionnels pour chaque mode de livraison.
Mode de sondage
Configurez les paramètres de sondage optionnels sous extensions.connector le fichierhost.json . Par exemple, la configuration suivante limite le délai entre les sondages lorsqu’aucun événement n’est disponible à une seconde :
{
"version": "2.0",
"extensions": {
"connector": {
"maxPollingInterval": "00:00:01"
}
}
}
| Propriété | Par défaut | Description |
|---|---|---|
defaultMaxBatchSize |
1 |
Nombre maximal d’événements par invocation lorsque la fonction ne spécifie pas de contournement positif de la taille du lot. Les valeurs valides sont de 1 à 32. Les valeurs supérieures à 1 nécessitent que le batching soit activé. |
defaultMaxConcurrentCalls |
16 |
Tâches maximales de traitement simultanées à événement unique par auditeur sur une instance, y compris préparation, invocation et accusé de réception. Doit être positif. Cela ne s’applique pas aux invocations groupées. |
defaultTargetPendingEventThreshold |
16 |
Cibler les événements en attente par instance pour une mise à l’échelle basée sur la cible lorsque l’exécution ne fournit pas de cible de concurrent. Doit être positif. Indépendant de la taille du lot et de la concurrence d’invocation. |
maxPollingInterval |
"00:00:30" |
Délai maximal entre les sondages lorsqu’aucun événement n’est disponible. Ça doit être au moins une seconde. Ne contrôle pas la fréquence à laquelle le connecteur vérifie le service source. |
maxLinkedOutputSizeInBytes |
104857600 (100 MiB) |
Octets téléchargés maximums par événement lié sorti. Doit être positif. Cela ne s’applique pas aux réponses de sondages en ligne. Il s’agit d’une protection de téléchargement, pas d’une garantie supportée de taille de charge utile. |
Les overrides positives par fonction ont priorité sur les valeurs par défaut correspondantes de l’hôte. L’exécution peut annuler la cible de mise à l’échelle sans modifier la taille du lot ni la concurrence de l’écouteur. Les lots sont traités un par un par auditeur. Pour les options spécifiques à la langue, voir Mode de sondage.
Les événements à sortie liée sont téléchargés par l’hôte et normalisés à la forme ordinaire de la charge utile. Ils sont invoqués un événement à la fois derrière un limiteur à l’échelle de l’hôte, même lorsque la liaison permet le batching.
L’augmentation maxLinkedOutputSizeInBytes peut épuiser la mémoire de l’hôte ou du travailleur. Validez la charge de travail sur la taille de votre hébergement avant de l’augmenter ; la valeur par défaut n’établit pas de limite de taille de charge utile prise en charge.
Mode webhook
L’authentification par clé système par défaut ne nécessite pas de réglages spécifiques au connecteur dans host.json. Si l’authentification intégrée du service d’application valide les rappels, vous pouvez la définir extensions.connector.system.webhookAuthorizationLevelAnonymous pour désactiver la vérification redondante de la clé système.
À utiliser Anonymous uniquement lorsqu’une autre couche d’authentification valide les requêtes avant qu’elles n’atteignent l’hôte des fonctions. Pour les détails de configuration et un exemple complet, voir Authentification intégrée.
Utilisation des SDK de connecteurs dans votre code
Le SDK du connecteur permet à votre fonction d’appeler les opérations de connecteur comme actions sortantes. La surface client utilise le même connecteur géré sous-jacent dans l’espace de noms du connecteur qui déclenche l’utilisation, de sorte qu’un seul connecteur géré peut alimenter à la fois les déclencheurs entrants et les appels sortants pour le même compte de service.
Authentifier les rappels de webhook entrants ne donne pas à l’application de fonction la permission d’effectuer des appels sortants du SDK. Pour une fonction déclenchée par webhook qui effectue également des appels SDK, accordez à l’identité gérée (déployée) ou à l’identité développeur (locale) de l’application une politique d’accès à chaque connexion de connecteur gérée utilisée par ces appels.
Pour le sondage, l’identité gérée de l’application de fonction ou l’identité du développeur nécessite déjà une politique d’accès à la connexion. Si le client SDK utilise la même identité et connexion, la politique existante autorise également les appels SDK ; aucune assignation supplémentaire de politique d’accès n’est nécessaire.
Les fonctions de polling et de webhook doivent toutes deux transmettre une identifiante au client SDK, comme indiqué ci-dessous.
Dans .NET, chaque connecteur fournit un client typé (par exemple, Office365Client, Office365UsersClient, TeamsClient) dans Azure.Connectors.Sdk.{Service}. Le constructeur client prend l’URL d’exécution de la connexion ainsi qu’une identifiante.
Le schéma suivant provient de l’exemple Teams de recherche d’utilisateurs par e-mail de bout en bout :
using Azure.Core;
using Azure.Identity;
using Azure.Connectors.Sdk.Office365;
using Azure.Connectors.Sdk.Office365Users;
using Azure.Connectors.Sdk.Teams;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
var credential = new DefaultAzureCredential(new DefaultAzureCredentialOptions
{
ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_CLIENT_ID")
});
var host = new HostBuilder()
.ConfigureFunctionsWebApplication()
.ConfigureServices(services =>
{
services.AddSingleton<TokenCredential>(credential);
services.AddSingleton(sp => new Office365Client(
new Uri(Environment.GetEnvironmentVariable("OFFICE365_CONNECTION_RUNTIME_URL")!),
sp.GetRequiredService<TokenCredential>()));
services.AddSingleton(sp => new Office365UsersClient(
new Uri(Environment.GetEnvironmentVariable("OFFICE365USERS_CONNECTION_RUNTIME_URL")!),
sp.GetRequiredService<TokenCredential>()));
services.AddSingleton(sp => new TeamsClient(
new Uri(Environment.GetEnvironmentVariable("TEAMS_CONNECTION_RUNTIME_URL")!),
sp.GetRequiredService<TokenCredential>()));
})
.Build();
host.Run();
Cet exemple crée un DefaultAzureCredential, l’enregistre comme un TokenCredential, et le transmet au constructeur de chaque client SDK via sp.GetRequiredService<TokenCredential>(). Localement, l'identifiant peut utiliser votre identifiant de développeur ; dans Azure, il peut utiliser l'identité gérée de l'application de fonction. Réglez AZURE_CLIENT_ID sur l’ID client d’une identité gérée attribuée par l’utilisateur attachée à l’application de fonction. Laissez-le non réglé pour une identité assignée par le système ou une connexion d’un développeur local.
Les paramètres *_CONNECTION_RUNTIME_URL pointent vers le point de terminaison du runtime propre à chaque connexion dans l’espace de noms du connecteur. Injectez les clients dans votre fonction et appelez des méthodes typées telles que UserProfileAsync, GetEmailsAsyncou FlagAsync. Vous pouvez également appeler des clients du Kit de développement logiciel (SDK) à partir de déclencheurs non connecteurs (par exemple, un déclencheur HTTP qui publie sur Teams).
L’extrait simplifié suivant de l’exemple email-à-équipes utilise l’injection Office365Client pour signaler un e-mail pour un suivi. Appelez cet assistant à partir du code de traitement de votre fonction avec l’ID du message de l’email :
using Azure.Connectors.Sdk.Office365;
using Azure.Connectors.Sdk.Office365.Models;
public class ProcessEmail(Office365Client office365Client)
{
public async Task FlagEmailAsync(string messageId)
{
await office365Client.FlagAsync(
messageId: messageId,
input: new UpdateEmailFlag { Flag = new { flagStatus = "flagged" } },
originalMailboxAddress: null,
cancellationToken: default);
}
}
En Python, azure-connectors fournit des clients typés tels que Office365Client et TeamsClient. Passez l’URL d’exécution par connexion et une identifiante au constructeur client. Pour l’authentification Microsoft Entra ID, utilisez une identifiante asynchrone telle que azure.identity.aio.DefaultAzureCredential. Attendez les opérations du SDK.
En Node.js, @azure/connectors fournit des clients typés tels que Office365Client et TeamsClient. Passez l’URL d’exécution par connexion et une identification, comme DefaultAzureCredential from @azure/identity, au constructeur client. Attendez les opérations du SDK.