Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure Functions bietet Trigger- und Bindungserweiterungen, die sich mit verschiedenen Diensten, vor allem Azure-Diensten, integrieren. Die Connector-Erweiterung erweitert diese Integrationen durch verwaltete Connector-Connector-Namespace in Azure Connector Namespace, sodass Ihre Funktionen Ereignisse von Geschäftssystemen und Datenplattformen wie Office 365 Outlook, SharePoint Online, Microsoft Teams und Dataverse empfangen können.
Für verfügbare verwaltete Connectors von Microsoft und Drittanbietern siehe die Steckerreferenz.
Note
Verwaltete Connectors unterstützen die Flex Consumer-, Dedicated und Elastic Premium-Hosting-Pläne für Linux Function-Apps in allen Regionen. Die Verfügbarkeit von Windows-Apps ist heute begrenzt.
Flex Consumption ist der empfohlene Hosting-Plan für connector-ausgelöste Funktionen.
Note
Der Connector Trigger wird derzeit für diese Sprache nicht unterstützt.
| To | Verwenden |
|---|---|
| Führen Sie eine Funktion als Reaktion auf ein Ereignis in einem verbundenen Dienst aus | Connector Trigger, bereitgestellt durch die Connector-Erweiterung |
| Führen Sie eine Aktion in einem verbundenen Dienst aus Funktionscode aus | Azure Connectors SDK, verfügbar für .NET, Node.jsund Python |
Sie können beide gleichzeitig verwenden: Der Connector Trigger startet Ihre Funktion, und das SDK führt Aktionen in verbundenen Diensten aus. Wenn Sie nur Aktionen ausführen müssen, verwenden Sie das SDK ohne die Connector-Erweiterung.
Weitere Informationen zu verwalteten Connectors, wann Sie sie verwenden sollten und zur Verfügbarkeit von Funktionen finden Sie unter Use managed connectors in Azure Functions.
Connector Trigger in Azure Functions
Eine vom Stecker ausgelöste Funktion verwendet folgende Komponenten:
| Component | Verantwortung |
|---|---|
| Connector-Namespace | Hosts verwalten Connector-Verbindungen und triggern Konfigurationen. |
| Managed Connector-Verbindung | Authentifiziert sich beim externen Dienst und verwaltet dienstspezifische Konnektivität. |
| Triggerkonfiguration | Wählt das Connector-Ereignis, die Betriebsparameter und den Auslieferungsmodus aus. |
| Azure Functions Connector-Erweiterung | Empfängt Ereignisse aus dem Connector-Namespace, ruft die Funktion auf und bindet den Ereigniskörper an den Funktionsparameter. |
| Azure Connectors SDK (optional) | Bietet optionale stark typisierte Nutzlastmodelle und Clients zum Aufrufen von verwalteten Connector-Operationen, wie dem Versenden einer E-Mail oder dem Erstellen einer SharePoint-Datei. |
Ein verwalteter Connector kann mehrere Ereignisse unterstützen, und jedes Ereignis, das Sie überwachen möchten, benötigt seine eigene Trigger-Konfiguration. Beispielsweise unterstützt der Office 365 Outlook Connector Ereignisse wie das Eintreffen einer neuen E-Mail, die markiert wird, eine E-Mail die Erstellung eines Kalenderereignisses oder das Ändern eines Kalenderereignisses. Erstellen Sie für jedes Ereignis, mit dem Sie eine Funktion ausführen möchten, eine separate Trigger-Konfiguration.
Für Codebeispiele siehe Connector-Trigger-Beispiele und Using Connector SDKs in Ihrem Code.
Wählen Sie einen Liefermodus aus
Verwaltete Connectors unterstützen Webhook- und Polling-Bereitstellung. Wählen Sie einen Modus basierend auf Latenz, Prozessorkapazität, Netzwerk- und Authentifizierungsanforderungen Ihres Szenarios:
| Feature | Abfrage | Webhook |
|---|---|---|
| Ereignisübertragung und Latenz | Der Functions-Host ruft Ereignisse über ausgehende Abholanfragen ab. Veranstaltungen warten, bis der Gastgeber für sie abstimmt. | Der Connector-Namespace verschiebt Ereignisse an den Callback-Endpunkt der Funktionsapp, sobald sie sie vom Quelldienst empfangen, ohne darauf zu warten, dass die App sie abfragt. Dies reduziert die Zustelllatenz bei zeitkritischer Verarbeitung. |
| Verarbeitungskapazität und Downstream-Schutz | Der Host ruft weitere Ereignisse ab, sobald die Rechenkapazität verfügbar wird. Kombinieren Sie App-Scale-Out-Grenzen mit Polling-Parallelitätseinstellungen , um gleichzeitige Verarbeitung zu begrenzen und nachgelagerte Datenbanken oder APIs zu schützen. Ausstehende Ereignisse bleiben im Connector-Namensraum in der Warteschlange, vorbehaltlich dessen Ereignisaufbewahrungsbeschränkungen. | Ereignisse treffen unabhängig von der verfügbaren Verarbeitungskapazität der App ein. Scale-out-Grenzen können zu gedrosselten oder fehlgeschlagenen Callbacks führen, wenn die Nachfrage die Kapazität übersteigt; Ereignisse können verloren gehen, wenn die Auslieferung innerhalb der Wiederholungsbegrenzungen des Dienstes nicht erfolgreich ist. |
| Eingehendes Netzwerken | Kein eingehender Callback-Endpunkt ist erforderlich. Sie können den eingehenden Zugriff auf die Funktions-App einschränken und gleichzeitig ausgehende Anfragen an den Polling-Endpunkt des Connector-Namespaces zulassen. | Der Connector-Namespace muss in der Lage sein, den Callback-Endpunkt der App zu erreichen. Eingehende Beschränkungen müssen diese Anfragen zulassen. |
| Verwaltete Identitätsauthentifizierung | Der Functions-Host kann die systemzugewiesene oder benutzerzugewiesene verwaltete Identität der Funktions-App verwenden, um Ereignisse zu empfangen und zu bestätigen. Gewähren Sie dieser Identität eine Zugriffsrichtlinie für die verwaltete Connector-Verbindung. | Für Callbacks, die mit der Microsoft Entra ID authentifiziert wurden, verwendet der Connector-Namespace seine verwaltete Identität. Konfigurieren Sie die integrierte App Service-Authentifizierung in der empfangenden Funktionsapp, um die Token zu validieren. Die Standard-Webhook-Authentifizierung verwendet stattdessen den Systemschlüssel der Connector-Erweiterung. |
Je nach Ihrem Hosting-Tarif können Sie den eingehenden Zugriff auf die Funktions-App über private Endpunkte oder eingehende Zugriffsbeschränkungen einschränken, einschließlich IP- oder Service-Endpunkt-Einschränkungen, ohne das Abfragen zu verhindern. Die App muss weiterhin in der Lage sein, ausgehende HTTPS-Anfragen an den Polling-Endpunkt des Connector-Namespaces zu stellen. Unabhängig davon muss die konfigurierte verwaltete Identität der Funktions-App eine Zugriffsrichtlinie auf der verwalteten Connector-Verbindung haben.
Der Event-Delivery-Modus steuert, wie Ereignisse vom Connector-Namespace zum Functions-Host gelangen, nicht wie der verwaltete Connector Änderungen im Quelldienst erkennt.
Die Webhook-Auslieferung skaliert wie HTTP-Auslöser, während die Auslieferung von Abfragen zielbasierte Skalierung verwendet. Das Skalierungsziel für die Umfrage ist unabhängig von der Listen-Parallelität und der Batchgröße. Details zu beiden Modi finden Sie unter Connector Trigger Skalierung und Parallelität. Für die Polling-Skalierungsgleichung und Tuning-Einstellungen siehe Zielbasierte Skalierung verwalteter Connectors.
Beide Modi nutzen [ConnectorTrigger] den Funktionsparameter, der den Ereignisbody erhält, und können dieselben Payload-Modelle verwenden. Beispiele beider Bereitstellungsmodi finden Sie unter den Connector-Trigger-Beispielen.
Pakete installieren
Steckverbinderverlängerung
Der Connector Trigger unterstützt das isolierte Worker-Modell .NET. Informationen zu unterstützten .NET-Versionen in Azure Functions-Laufzeitversionen finden Sie unter Sprachen nach Laufzeitversion.
Fügen Sie Ihrem Projekt Version 1.0.0 oder höher des Connector-Erweiterungspakets hinzu.
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Connector
Azure Connectors SDKs
Wenn Ihre Funktion nur Aktionen auf externen Diensten ausführen muss und nicht durch Ereignisse ausgelöst werden muss, verwenden Sie nur das Azure Connectors SDK. Sie benötigen das Connector-Erweiterungspaket nicht.
Fügen Sie das Azure Connectors SDK hinzu:
dotnet add package Azure.Connectors.Sdk
Für beliebte Connectors bietet das SDK stark typisierte Clients zum Aufrufen von Connector-Aktionen aus Ihren Funktionen; siehe die Azure Connectors SDK for .NET API-Referenz.
Installieren der Erweiterung
Verwende Node.js 24 oder höher. Beide Zustellmodi verwenden gleichnamige oder generische Trigger-Registrierungshilfen.
Installieren Sie die vom Connector-Trigger verwendeten Pakete:
npm install "@azure/functions@latest" "@azure/functions-extensions-connectors@latest" "@azure/connectors@latest"
Diese Pakete bieten folgende Funktionalität:
-
@azure/functions liefert die Basisregistrierung
connectorTrigger, die die Trigger-Eingabe als generischen Typ erhält, der standardmäßig aufunknowngilt. - @azure/functions-extensions-connectors umwickelt die Eingabe in einen normalisierten Connector-Triggerkontext und stellt typisierte Kontexte für unterstützte Connector-Operationen bereit.
- @azure/connectors, das Azure Connectors SDK für Node.js, stellt die Payload-Modelle bereit, die von diesen Kontexten und Clients zum Aufruf von Connector-Operationen verwendet werden.
Konfigurieren Sie das Erweiterungsbündel in der host.json-Datei . Das Bundle stellt die Connector-Host-Erweiterung für beide Bereitstellungsmodi bereit:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.41.2, 5.0.0)"
}
}
Azure Connectors SDK
Wenn Ihre Funktion nur Aktionen auf externen Diensten ausführen muss und nicht durch Ereignisse ausgelöst werden muss, installieren Sie nur das Azure Connectors SDK für Node.js. Du brauchst die Connector-Triggerpakete nicht.
npm install "@azure/connectors@latest"
Für beliebte Connectors bietet das SDK stark typisierte Clients zum Aufrufen von Connector-Aktionen aus Ihren Funktionen; siehe das Azure Connectors SDK für Node.js API-Referenz.
Für aktuelle Paketversionen und komplette Projekte siehe die Azure Functions-Connector-Beispiele für TypeScript.
Beide Auslieferungsmodi nutzen den Dekorateur @app.connector_trigger . Siehe Beispiele für Connector-Trigger.
Installieren der Erweiterung
Fügen Sie die folgenden Pakete zu requirements.txthinzu:
azure-functions>=2.4.0
azurefunctions-extensions-connectors>=1.0.0
Note
Für Python-Versionen älter als 3.13 verwenden azure-functions>=1.27.0b1 Sie stattdessen.
- Die zentrale azure-funktions-Python-Bibliothek stellt den Dekorator bereit und kann rohe einzelne Ereignisse an
stroderbytesbinden oder abfragende Batches antyping.List[str]odertyping.List[bytes]. - Das azurefunctions-extensions-connectors-Paket integriert das Azure Connectors SDK für Python und registriert Konverter für unterstützte, operationsspezifische SDK-Anmerkungen. Zum Beispiel
emails: list[office365.GraphClientReceiveMessage]erhält , wooffice365ausazurefunctions.extensions.connectorsimportiert wird, E-Mail-Modellobjekte für die Office 365 Outlook-OperationOnNewEmailV3.
Konfigurieren Sie das Erweiterungsbündel in der host.json-Datei . Das Bundle stellt die Connector-Host-Erweiterung für beide Bereitstellungsmodi bereit:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.41.2, 5.0.0)"
}
}
Azure Connectors SDK
Wenn Ihre Funktion nur Aktionen auf externen Diensten ausführen muss und nicht durch Ereignisse ausgelöst werden muss, installieren Sie nur das Azure Connectors SDK für Python. Du brauchst die Connector-Triggerpakete nicht.
python -m pip install "azure-connectors>=1.0.0"
Für beliebte Connectors bietet das SDK stark typisierte Clients zum Aufrufen von Connector-Aktionen aus Ihren Funktionen; siehe die Azure Connectors SDK for Python API-Referenz.
Für aktuelle Paketversionen und komplette Projekte siehe die Azure Functions-Connector-Beispiele für Python.
Einstellungen für „host.json“
Die Connector-Erweiterung erfordert keine connector-spezifischen Einstellungen in der host.json-Datei , wenn Sie die Standardeinstellungen verwenden.
Die folgenden Abschnitte zeigen die optionalen Einstellungen für jeden Auslieferungsmodus.
Wahlmodus
Konfigurieren Sie optionale Abholungseinstellungen unten extensions.connector in der host.json-Datei . Zum Beispiel begrenzt die folgende Konfiguration die Verzögerung zwischen Abfragen, wenn keine Ereignisse verfügbar sind, auf eine Sekunde:
{
"version": "2.0",
"extensions": {
"connector": {
"maxPollingInterval": "00:00:01"
}
}
}
| Property | Vorgabe | Description |
|---|---|---|
defaultMaxBatchSize |
1 |
Maximale Ereignisse pro Aufruf, wenn die Funktion keine positive Batch-Größenüberschreitung angibt. Gültige Werte sind 1 bis 32. Werte größer als 1 erfordern die Aktivierung des Batchings. |
defaultMaxConcurrentCalls |
16 |
Maximale gleichzeitige Einzelereignisverarbeitungsaufgaben pro Listener auf einer Instanz, einschließlich Vorbereitung, Aufruf und Bestätigung. Muss positiv sein. Gilt nicht für gebündelte Aufrufe. |
defaultTargetPendingEventThreshold |
16 |
Ziel ausstehende Ereignisse pro Instanz für zielbasierte Skalierung, wenn die Laufzeit kein Parallelitätsziel liefert. Muss positiv sein. Unabhängig von Batchgröße und Aufruf-Parallelität. |
maxPollingInterval |
"00:00:30" |
Maximale Verzögerung zwischen Umfragen, wenn keine Events verfügbar sind. Muss mindestens eine Sekunde sein. Steuert nicht, wie oft der Connector den Quelldienst überprüft. |
maxLinkedOutputSizeInBytes |
104857600 (100 MiB) |
Maximal heruntergeladene Bytes pro verknüpften Ereignisausgabe. Muss positiv sein. Gilt nicht für Inline-Umfrageantworten. Dies ist eine Download-Schutzleiste, keine unterstützte Garantie für die Payload-Größe. |
Positive Überschreitungen pro Funktion haben Vorrang vor den entsprechenden Host-Standardwerten. Die Laufzeit kann das Skalierungsziel überschreiben, ohne die Batchgröße oder die Listener-Parallelität zu verändern. Batches werden einzeln pro Listener verarbeitet. Für die sprachspezifischen Optionen siehe Polling-Modus.
Linked-Output-Ereignisse werden vom Host heruntergeladen und auf die gewöhnliche Nutzlastform normalisiert. Sie werden jeweils ein Ereignis hinter einem hostweiten Limiter aufgerufen, selbst wenn die Bindung Batching ermöglicht.
Eine Erhöhung maxLinkedOutputSizeInBytes kann das Speicher des Hosts oder des Arbeiters erschöpfen. Validieren Sie die Workload Ihrer Hosting-Größe, bevor Sie sie erhöhen; der Standard legt keine unterstützte Payload-Größengrenze fest.
Webhook-Modus
Die Standard-Systemschlüsselauthentifizierung erfordert keine connector-spezifischen Einstellungen in host.json. Wenn die integrierte App Service-Authentifizierung Rückrufe validiert, können Sie auf Anonymous festlegenextensions.connector.system.webhookAuthorizationLevel, um die redundante Systemschlüsselprüfung zu deaktivieren.
Verwenden Sie Anonymous nur, wenn eine andere Authentifizierungsschicht Anfragen validiert, bevor sie den Functions-Host erreichen. Für Konfigurationsdetails und ein vollständiges Beispiel siehe Integrierte Authentifizierung.
Verwendung von Connector-SDKs in Ihrem Code
Das Connector SDK ermöglicht es Ihrer Funktion, Connector-Operationen als ausgehende Aktionen aufzurufen. Die Clientoberfläche verwendet denselben zugrunde liegenden verwalteten Connector im Connector-Namespace, der use auslöst, sodass ein einzelner verwalteter Connector sowohl eingehende als auch ausgehende Aufrufe für dasselbe Servicekonto mit Strom versorgen kann.
Die Authentifizierung eingehender Webhook-Callbacks erteilt der Funktion keine Berechtigung, ausgehende SDK-Anrufe durchzuführen. Für eine webhook-ausgelöste Funktion, die auch SDK-Anrufe tätigt, erteilen Sie der verwalteten Identität (bereitgestellt) oder der Entwickleridentität (lokal) der Funktionsapp eine Zugriffsrichtlinie für jede verwaltete Connector-Verbindung, die von diesen Aufrufen verwendet wird.
Für das Abfragen benötigt die verwaltete Identität oder Entwickleridentität der Funktionsapp bereits eine Verbindungszugriffsrichtlinie. Wenn der SDK-Client dieselbe Identität und Verbindung verwendet, erlaubt die bestehende Richtlinie auch SDK-Anrufe; es ist keine zusätzliche Zuweisung von Zugriffsrichtlinien erforderlich.
Sowohl die Polling- als auch die Webhook-Funktionen müssen wie unten gezeigt einen Anmeldevergabeformular an den SDK-Client weitergeben.
In .NET wird jeder Konnektor mit einem typisierten Client (z. B. Office365Client, Office365UsersClient, TeamsClient) in Azure.Connectors.Sdk.{Service} ausgeliefert. Der Clientkonstruktor verwendet die Laufzeit-URL der Verbindung und Anmeldeinformationen.
Das folgende Muster stammt aus dem End-to-End-E-Mail-Benutzersuche-Beispiel für Teams:
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();
Dieses Beispiel erstellt ein DefaultAzureCredential, registriert es als ein TokenCredential, und leitet es an den Konstruktor jedes SDK-Clients über sp.GetRequiredService<TokenCredential>(). Lokal kann die Anmeldedaten Ihre Entwickler-Anmeldung verwenden; in Azure kann sie die verwaltete Identität der Funktions-App verwenden. Setzen Sie AZURE_CLIENT_ID die Client-ID einer benutzerzugewiesenen verwalteten Identität, die der Funktions-App angehängt ist. Lassen Sie es für eine systemzugewiesene Identität oder eine lokale Entwickler-Anmeldung ungesetzt.
Die Einstellungen *_CONNECTION_RUNTIME_URL verweisen auf den verbindungsspezifischen Laufzeitendpunkt im Connector-Namespace. Fügen Sie die Clients in Ihre Funktion ein, und rufen Sie eingegebene Methoden wie UserProfileAsync, , GetEmailsAsyncoder FlagAsync. Sie können SDK-Clients auch aus Nicht-Connector-Triggern aufrufen (z. B. aus einem HTTP-Trigger, der an Teams sendet).
Der folgende vereinfachte Auszug aus dem E-Mail-an-Teams-Beispiel verwendet das injizierte Office365Client Element, um eine E-Mail zur Folge zu markieren. Rufen Sie diesen Helfer über den Verarbeitungscode Ihrer Funktion mit der Nachrichten-ID der E-Mail auf:
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);
}
}
In Python azure-connectors stellt typisierte Clients wie Office365Client und TeamsClientbereit. Geben Sie dem Client-Konstruktor die pro Verbindungs-Laufzeit-URL und eine Zugangsdaten weiter. Für die Microsoft Entra ID-Authentifizierung verwenden Sie eine asynchrone Zugangsdaten wie azure.identity.aio.DefaultAzureCredential. Warten Sie auf SDK-Operationen.
In Node.jsliefert , @azure/connectors typisierte Clients wie Office365Client und TeamsClient. Geben Sie die pro Verbindung verfügbare Laufzeit-URL und eine Anmeldeinformation, z. B. DefaultAzureCredential from @azure/identity, an den Client-Konstruktor weiter. Warten Sie auf SDK-Operationen.