In API Management können Sie eine GraphQL-API in einem von zwei Modellen hinzufügen: Passthrough an einen vorhandenen GraphQL-Endpunkt oder Import eines GraphQL-Schema und Erstellung einer synthetischen GraphQL-API mit benutzerdefinierten Feld-Resolvern. Weitere Informationen finden Sie in der GraphQL-Übersicht.
In diesem Artikel führen Sie Folgendes durch:
Hinzufügen einer Passthrough-GraphQL-API zu Ihrer API Management-Instanz.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.
Navigieren Sie im Azure-Portal zu Ihrer API Management-Instanz.
Wählen Sie im linken Menü APIs>+ API hinzufügen aus.
Wählen Sie unter Define a new API (Neue API definieren) das GraphQL-Symbol aus.
Wählen Sie im Dialogfeld Vollständig aus, und füllen Sie die erforderlichen Formularfelder aus.
Feld
Beschreibung
Anzeigename
Das ist der Name, mit dem Ihre GraphQL-API angezeigt wird.
Name
Das ist der unformatierte Name der GraphQL-API. Er wird automatisch ausgefüllt, wenn Sie den Anzeigenamen eingeben.
GraphQL-Typ
Wählen Sie Passthrough-GraphQL, um aus einem vorhandenen GraphQL-API-Endpunkt zu importieren.
GraphQL-API-Endpunkt
Das ist die Basis-URL mit dem Namen Ihres GraphQL-API-Endpunkts. Beispiel: https://example.com/your-GraphQL-name. Sie können auch einen beliebten „swapi“-GraphQL-Endpunkt wie https://swapi-graphql.azure-api.net/graphql als Demo verwenden.
Schema hochladen
Wählen Sie optional aus, Ihre Schemadatei zu durchsuchen und hochzuladen, um das vom GraphQL-Endpunkt abgerufene Schema zu ersetzen (sofern verfügbar).
Beschreibung
Fügen Sie eine Beschreibung Ihrer API hinzu.
URL-Schema
Treffen Sie eine Auswahl basierend auf Ihrem GraphQL-Endpunkt. Wählen Sie eine der Optionen aus, die ein WebSocket-Schema (WS oder WSS) enthält, wenn Ihre GraphQL-API den Abonnementtyp einschließt. Standardauswahl: HTTP(S).
API-URL-Suffix
Fügen Sie ein URL-Suffix hinzu, um diese spezifische API in dieser API Management-Instanz zu identifizieren. Es muss in dieser API Management-Instanz eindeutig sein.
Basis-URL
In diesem nicht bearbeitbaren Feld wird die Basis-URL für Ihre API angezeigt.
Tags
Ordnen Sie Ihre GraphQL-API neuen oder vorhandenen Tags zu.
Produkte
Ordnen Sie Ihre GraphQL-API einem Produkt zu, um sie zu veröffentlichen.
Versionsverwaltung für diese API?
Wählen Sie aus, ein Versionsverwaltungsschema auf Ihre GraphQL-API anzuwenden.
Klicken Sie auf Erstellen.
Nachdem die API erstellt wurde, können Sie das Schema auf der Registerkarte Entwurf durchsuchen oder ändern.
Im folgenden Beispiel wird der Befehl az apim api import verwendet, um eine Passthrough-API von GraphQL aus der angegebenen URL in eine API Management-Instanz namens apim-hello-world zu importieren.
# API Management service-specific details
APIMServiceName="apim-hello-world"
ResourceGroupName="myResourceGroup"
# API-specific details
APIId="my-graphql-api"
APIPath="myapi"
DisplayName="MyGraphQLAPI"
SpecificationFormat="GraphQL"
SpecificationURL="<GraphQL backend endpoint>"
# Import API
az apim api import --path $APIPath --resource-group $ResourceGroupName \
--service-name $APIMServiceName --api-id $APIId \
--display-name $DisplayName --specification-format $SpecificationFormat --specification-url $SpecificationURL
Nach dem Importieren der API können Sie die Einstellungen bei Bedarf mit dem Befehl az apim api update aktualisieren.
Im folgenden Beispiel wird das Azure PowerShell-Cmdlet Import-AzApiManagementApi verwendet, um eine Passthrough-API von GraphQL aus der angegebenen URL in eine API Management-Instanz namens apim-hello-world zu importieren.
# API Management service-specific details
$apimServiceName = "apim-hello-world"
$resourceGroupName = "myResourceGroup"
# API-specific details
$apiId = "my-graphql-api"
$apiPath = "myapi"
$specificationFormat = "GraphQL"
$specificationUrl = "<GraphQL backend endpoint>"
# Get context of the API Management instance.
$context = New-AzApiManagementContext -ResourceGroupName $resourceGroupName -ServiceName $apimServiceName
# Import API
Import-AzApiManagementApi -Context $context -ApiId $apiId -SpecificationFormat $specificationFormat -SpecificationUrl $specificationUrl -Path $apiPath
Nach dem Importieren der API können Sie die Einstellungen bei Bedarf mit dem Cmdlet Set-AzApiManagementApi aktualisieren.
Testen Ihrer GraphQL-API
Navigieren Sie zu Ihrer API Management-Instanz.
Wählen Sie im Seitennavigationsmenü im Abschnitt APIs die Option APIsaus.
Wählen Sie unter Alle APIs Ihre GraphQL-API aus.
Wählen Sie die Registerkarte Test aus, um auf die Testkonsole zuzugreifen.
Unter Header:
Wählen Sie im Dropdownmenü Name den Header aus.
Geben Sie den Wert in das Feld Wert ein.
Fügen Sie weitere Header hinzu, indem Sie + Header hinzufügen auswählen.
Löschen Sie Header mithilfe des Papierkorbsymbols.
Wenn Sie Ihrer GraphQL-API ein Produkt hinzugefügt haben, wenden Sie den Produktbereich mithilfe von Apply product scope (Produktbereich anwenden) an.
Führen Sie im Abfrage-Editor eine der folgenden Aktionen aus:
Wählen Sie mindestens ein Feld oder Unterfeld aus der Liste im Seitenmenü aus. Die von Ihnen ausgewählten Felder und Unterfelder werden im Abfrage-Editor angezeigt.
Beginnen Sie mit der Eingabe im Abfrage-Editor, um eine Abfrage zu erstellen.
Fügen Sie unter Abfragevariablen Variablen hinzu, um eine Abfrage oder Mutation wiederzuverwenden und unterschiedliche Werte zu übergeben.
Wählen Sie Send (Senden) aus.
Zeigen Sie die Antwort an.
Wiederholen Sie die vorherigen Schritte, um verschiedene Nutzdaten zu testen.
Beenden Sie die Testkonsole, wenn die Tests abgeschlossen sind.
Testen eines Abonnements
Wenn Ihre GraphQL-API ein Abonnement unterstützt, können Sie es in der Testkonsole testen.
Stellen Sie sicher, dass Ihre API ein WebSocket-URL-Schema (WS oder WSS) zulässt, das für Ihre API geeignet ist. Sie können diese Einstellung auf der Registerkarte Einstellungen aktivieren.
Richten Sie eine Abonnementabfrage im Abfrage-Editor ein. Wählen Sie dann Verbinden aus, um eine WebSocket-Verbindung mit dem Back-End-Dienst herzustellen.
Überprüfen Sie die Verbindungsdetails im Bereich Abonnement.
Abonnierte Ereignisse werden im Bereich Abonnement angezeigt. Die WebSocket-Verbindung wird beibehalten, bis Sie sie trennen oder eine Verbindung mit einem neuen WebSocket-Abonnement herstellen.
Erfahren Sie, wie GraphQL in Microsoft Fabric funktioniert, die wichtigsten Konzepte und praktischen Beispiele, um Benutzern die effektive Integration ihrer Anwendungen in GraphQL als Teil ihrer Lösungen zu erleichtern.
Schreiben Sie effiziente Abfragen, erstellen Sie Indizierungsrichtlinien, verwalten Sie und Sie Ressourcen in der SQL-API und im SDK mit Microsoft Azure Cosmos DB bereit.
Fügen Sie eine synthetische GraphQL-API hinzu, indem Sie ein GraphQL-Schema importieren, um API Management und Feld-Resolver zu konfigurieren, die HTTP-basierte Datenquellen verwenden.
Referenz für die validate-graphql-request-Richtlinie, die zur Verwendung in Azure API Management verfügbar ist. Behandelt die Verwendung von Richtlinien sowie Einstellungen und Beispiele dafür.
Referenz für die Resolver-Richtlinie „sql-data-source“, die zur Verwendung in Azure API Management verfügbar ist. Behandelt die Verwendung von Richtlinien sowie Einstellungen und Beispiele dafür.
Elizabeth Barnitt tritt Scott Hanselman bei, um die GraphQL-Unterstützung in Azure API Management zu diskutieren und zu demo, mit dem Sie GraphQL-APIs in Azure importieren, überprüfen, sichern und erweitern können. Azure API Management ermöglicht es Ihnen, Ihre vorhandenen GraphQL-Server zu steuern und einen von Grund auf neu mit synthetischem GraphQL zu erstellen, mit dem Sie Ihre vorhandenen REST- und SOAP-Endpunkte in einem einzigen, einfach abzufragenden Endpunkt kombinieren können. Kapitel 00:00: Einf
Entdecken Sie die Dienste und Tools, die Sie zum Erstellen und Bereitstellen Ihrer GraphQL-Anwendungen in Azure benötigen, unabhängig davon, ob Sie vorhandene Anwendungen hosten oder neue GraphQL-Endpunkte erstellen.
Referenz für die Auflöserrichtlinie „http-data-source“, die zur Verwendung in Azure API Management verfügbar ist. Behandelt die Verwendung von Richtlinien sowie Einstellungen und Beispiele dafür.
