Ausführen einer Azure-Funktion mit einer HTTP-Anforderung
Eine HTTP-Anforderung ist ein gängiger Vorgang auf den meisten Plattformen und Geräten. Ob mit der Anforderung ein Wort in einem Wörterbuch nachgeschlagen oder der lokale Wetterbericht aufgerufen werden soll, wir senden ständig HTTP-Anforderungen. Azure Functions ermöglicht es uns, schnell ein Stück Logik zu erstellen, das beim Empfangen einer HTTP-Anforderung ausgeführt wird.
In dieser Lerneinheit erfahren Sie, wie eine Funktion mit einem HTTP-Trigger erstellt und ausgelöst wird. Darüber hinaus untersuchen Sie einige der für HTTP-Trigger verfügbaren Anpassungsoptionen.
Was ist ein HTTP-Trigger?
Ein HTTP-Trigger ist ein Trigger, der Code ausführt, wenn er eine HTTP-Anforderung empfängt. HTTP-Trigger weisen viele Funktionen und Anpassungen auf, Beispiele:
- Stellen von autorisiertem Zugriff durch die Angabe von Schlüsseln.
- Beschränken, welche HTTP-Verben unterstützt werden.
- Zurückgeben der Daten zurüclk an den Aufrufer.
- Sie empfangen Daten über Abfragezeichenfolgen-Parameter oder den Anforderungstext.
- Sie unterstützen URL-Routenvorlagen zum Ändern der Funktions-URL.
Wenn Sie einen HTTP-Trigger erstellen, müssen Sie einen Namen für den Trigger angeben und eine Autorisierungsstufe auswählen.
Was ist eine HTTP-Triggerautorisierungsstufe?
Eine HTTP-Triggerautorisierungsstufe ist ein Flag, das angibt, ob eine eingehende HTTP-Anforderung zur Autorisierung einen API-Schlüssel benötigt.
Es gibt drei Autorisierungsstufen:
- Funktion
- Anonym
- Administrator
Die Stufen Funktion und Administrator sind schlüsselbasiert. Sie müssen einen Schlüssel für die Autorisierung angeben, um eine HTTP-Anforderung senden zu können. Es gibt zwei Arten von Schlüsseln: Funktions- und Hostschlüssel. Der Unterschied zwischen den beiden Typen ist ihr Geltungsbereich. Schlüssel mit dem Typ „Funktion“ gelten für eine Funktion. Schlüssel mit dem Typ „Host“ gelten für alle Funktionen innerhalb der Funktions-App. Wenn Ihre Autorisierungsstufe auf Funktion festgelegt ist, können Sie einen Schlüssel mit dem Typ Funktion oder Host verwenden. Wenn Ihre Autorisierungsstufe auf Administrator festgelegt ist, geben Sie einen Schlüssel mit dem Typ Host an.
Wichtig
Da Hostschlüssel einen erhöhten Zugriff auf Ihre Funktions-App bieten, müssen Sie sie sicher übertragen und speichern.
Die Stufe Anonym bedeutet, dass keine Autorisierung erforderlich ist. Für diese Übung wird die Autorisierungsstufe „Anonym“ verwendet.
Erstellen eines HTTP-Triggers
Sie können einen HTTP-Trigger wie einen Zeitgebertrigger über das Azure-Portal erstellen. Wählen Sie in Ihrer Azure-Funktion aus der Liste vordefinierter Triggertypen die Option HTTP-Trigger aus, geben Sie dann die Logik ein, die Sie ausführen möchten, und nehmen Sie Anpassungen vor, schränken Sie beispielsweise die Verwendung bestimmter HTTP-Verben ein.
Eine Einstellung, die Sie kennen sollten, ist Anforderungsparametername. Diese Einstellung ist eine Zeichenfolge, die den Namen des Parameters darstellt, der die Informationen über eine eingehende HTTP-Anforderung enthält. Standardmäßig ist der Name des Parameters req.
Aufrufen eines HTTP-Triggers
Um einen HTTP-Trigger aufzurufen, senden Sie eine HTTP-Anforderung an die URL für Ihre Funktion. Wechseln Sie zum Abrufen dieser URL zur Codepage Ihrer Funktion, und wählen Sie den Link Funktions-URL abrufen aus.
Sobald Sie über die URL für Ihre Funktion verfügen, können Sie HTTP-Anforderungen senden. Wenn Ihre Funktion Daten empfängt, denken Sie daran, dass Sie entweder Abfragezeichenfolgenparameter verwenden oder die Daten über den Anforderungstext bereitstellen können.
Ein HTTP-Trigger wird ausgeführt, wenn er eine HTTP-Anforderung an seine Funktions-URL empfängt. MIT HTTP-Triggern können Sie Daten empfangen, Logik ausführen und optional Daten an den Aufrufer zurückgeben.