Importieren einer GraphQL-API

GILT FÜR: Alle API Management-Ebenen

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:

Wenn Sie ein GraphQL-Schema importieren und Feldresolver mithilfe von REST- oder SOAP-API-Endpunkten einrichten möchten, lesen Sie Importieren eines GraphQL-Schemas und Einrichten von Feldresolvern.

Voraussetzungen

• Eine bestehende API Management-Instanz. Erstellen Sie eine, falls nicht schon geschehen.

• Eine GraphQL-API

• Azure CLI

  • Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.

    

  • 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.

• Azure PowerShell

  • Bei lokaler Verwendung von Azure PowerShell:
    • Installieren der aktuellen Version des Az PowerShell-Moduls.
    • Stellen Sie eine Verbindung mit Ihrem Azure-Konto mit dem Cmdlet Connect-AzAccount her.
  • Bei Verwendung von Azure Cloud Shell:
    • Weitere Informationen finden Sie in der Übersicht über Azure Cloud Shell.

Hinzufügen einer GraphQL-API

# 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

# 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

Testen Ihrer GraphQL-API

1. Navigieren Sie zu Ihrer API Management-Instanz.

2. Wählen Sie im Seitennavigationsmenü im Abschnitt APIs die Option APIsaus.

3. Wählen Sie unter Alle APIs Ihre GraphQL-API aus.

4. Wählen Sie die Registerkarte Test aus, um auf die Testkonsole zuzugreifen.

5. Unter Header:

   1. Wählen Sie im Dropdownmenü Name den Header aus.
   2. Geben Sie den Wert in das Feld Wert ein.
   3. Fügen Sie weitere Header hinzu, indem Sie + Header hinzufügen auswählen.
   4. Löschen Sie Header mithilfe des Papierkorbsymbols.

6. Wenn Sie Ihrer GraphQL-API ein Produkt hinzugefügt haben, wenden Sie den Produktbereich mithilfe von Apply product scope (Produktbereich anwenden) an.

7. Führen Sie im Abfrage-Editor eine der folgenden Aktionen aus:

   1. 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.

   2. Beginnen Sie mit der Eingabe im Abfrage-Editor, um eine Abfrage zu erstellen.

      

8. Fügen Sie unter Abfragevariablen Variablen hinzu, um eine Abfrage oder Mutation wiederzuverwenden und unterschiedliche Werte zu übergeben.

9. Wählen Sie Send (Senden) aus.

10. Zeigen Sie die Antwort an.

    

11. Wiederholen Sie die vorherigen Schritte, um verschiedene Nutzdaten zu testen.

12. 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.

1. 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.

2. Richten Sie eine Abonnementabfrage im Abfrage-Editor ein. Wählen Sie dann Verbinden aus, um eine WebSocket-Verbindung mit dem Back-End-Dienst herzustellen.

   

3. Überprüfen Sie die Verbindungsdetails im Bereich Abonnement.

   

4. 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.

   

Schützen Ihrer GraphQL-API

Schützen Sie Ihre GraphQL-API vor GraphQL-spezifischen Angriffen durch das Anwenden vorhandener Authentifizierungs- und Autorisierungsrichtlinien und einer GraphQL-Validierungsrichtlinie.

Zugehörige Themen

• Einschränkungen beim API-Import
• Importieren einer OpenAPI-Spezifikation
• Importieren einer SOAP-API
• Importieren einer SOAP-API und Konvertieren dieser in REST
• Importieren einer App Service-API
• Importieren einer Container-App-API
• Importieren einer WebSocket-API
• Importieren einer GraphQL-API
• Importieren eines GraphQL-Schemas und Einrichten von Feldauflösern
• Importieren einer Azure Functions-App als API
• Importieren einer Logik-App als API
• Tutorial: Integrieren von API Management in Service Fabric in Azure
• Importieren einer Azure OpenAI-API
• Importieren einer OData-API
• Importieren von SAP OData-Metadaten
• Importieren einer gRPC-API
• Bearbeiten von APIs

Nächste Schritte