Verfügbar machen von serverlose APIs von HTTP-Endpunkten mithilfe von Azure API Management

Azure Functions integriert Azure API Management im Portal, damit Sie Ihre HTTP-Triggerfunktionsendpunkte als REST-APIs verfügbar machen können. Diese APIs werden mithilfe einer OpenAPI-Definition beschrieben. Diese JSON-Datei (oder YAML)-Datei enthält Informationen darüber, welche Vorgänge in einer API verfügbar sind. Sie enthält Details dazu, wie die Anforderungs- und Antwortdaten für die API strukturiert werden sollen. Durch die Integration Ihrer Funktions-App können Sie API Management OpenAPI-Definitionen generieren.

In diesem Artikel erfahren Sie, wie Sie Ihre Funktions-App in API Management integrieren. Diese Integration funktioniert für Funktions-Apps, die in einer beliebigen unterstützten Sprache entwickelt wurden. Sie können auch Ihre Funktions-App aus Azure API Management importieren.

Für C#-Klassenbibliotheksfunktionen können Sie auch Visual Studio verwenden, um eine serverlose API zu erstellen und zu veröffentlichen, die in API Management intergriert ist.

Erstellen der API Management-Instanz

So erstellen Sie eine API Management-Instanz, die mit Ihrer Funktions-App verknüpft ist:

  1. Wählen Sie die Funktions-App aus. Wählen Sie dann im linken Menü die Option API Management und anschließend unter API Management die Option Neu erstellen aus.

    Choose API Management

  2. Verwenden Sie die API Management-Einstellungen aus der folgenden Tabelle:

    Einstellung Vorgeschlagener Wert Beschreibung
    Name Global eindeutiger Name Es wird ein Name auf der Grundlage des Namens Ihrer Funktions-App generiert.
    Abonnement Ihr Abonnement Das Abonnement, unter dem diese neue Ressource erstellt wird.
    Ressourcengruppe myResourceGroup Dieselbe Ressource wie Ihre Funktions-App, die für Sie festgelegt werden sollte.
    Location Standort des Diensts Ziehen Sie in Betracht, den gleichen Speicherort wie für Ihre Funktions-App zu wählen.
    Name der Organisation Contoso Der Name der Organisation, der im Entwicklerportal und für E-Mail-Benachrichtigungen verwendet wird.
    Administrator-E-Mail Ihre E-Mail-Adresse Die E-Mail-Adresse, die Benachrichtigungen des Systems von API Management erhält.
    Preisstufe Nutzung Der Tarif „Consumption“ ist nicht in allen Regionen verfügbar. Vollständige Preisinformationen finden Sie auf der API Management-Seite mit der Preisübersicht

    Create new API Management service

  3. Wählen Sie Erstellen aus, um die API Management-Instanz zu erstellen. Dies kann einige Minuten dauern.

  4. Nach Erstellung der Instanz durch Azure wird die Option Application Insights aktivieren auf der Seite verfügbar. Wählen Sie sie aus, um Protokolle an den gleichen Ort zu senden wie die Funktionsanwendung aus.

Funktionen importieren

Nachdem die API Management-Instanz erstellt wurde, können Sie Ihre über HTTP ausgelösten Funktionsendpunkte importieren. In diesem Beispiel wird ein Endpunkt namens „TurbineRepair“ importiert.

  1. Wählen Sie im API Management-Seite die Option API verbinden aus.

  2. Azure-Funktionen importieren wird mit hervorgehobener Funktion Turbinenreparatur geöffnet. Wählen Sie Auswählen aus, um fortzufahren.

    Import Azure Functions into API Management

  3. Übernehmen Sie auf der Seite Aus Funktions-App erstellen die Standardeinstellungen, und wählen Sie Erstellen aus.

    Create from Function App

    Von Azure wird die API für die Funktion erstellt.

Herunterladen der OpenAPI-Definition

Nachdem Ihre Funktionen importiert wurden, können Sie die OpenAPI-Definition aus API Management herunterladen.

  1. Wählen Sie oben auf der Seite OpenAPI-Definition herunterladen aus.

    Download OpenAPI definition

  2. Speichern Sie die heruntergeladene JSON-Datei, und öffnen Sie sie. Überprüfen Sie die Definition.

Nächste Schritte

Als Nächstes können Sie die Definition in API Management über das Portal anpassen. Außerdem können Sie sich ausführlicher über API Management informieren.