Importare un'API GraphQL

SI APPLICA A: Tutti i livelli di Gestione API

In Gestione API, è possibile aggiungere un'API GraphQL in uno dei due modelli: effettuare il pass-through a un endpoint GraphQL esistente o importare uno schema GraphQL e creare un'API GraphQL sintetica con sistemi di risoluzione di campi personalizzati. Per ulteriori informazioni, consultare la panoramica di GraphQL.

Contenuto dell'articolo:

Se si vuole importare uno schema GraphQL e configurare i sistemi di risoluzione dei campi usando endpoint REST o SOAP API, consultare Importare uno schema GraphQL e configurare i sistemi di risoluzione dei campi.

Prerequisiti

• Un'istanza di API Management esistente. Crearne una se non è già stato fatto.

• Un’API GraphQL.

• Interfaccia della riga di comando di Azure

  • Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido su Bash in Azure Cloud Shell.

    

  • Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.

    • Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.

    • Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.

    • Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

• Azure PowerShell

  • Se si sceglie di usare Azure PowerShell in locale:
    • Installare la versione più recente del modulo Az di PowerShell.
    • Connettersi all'account Azure con il cmdlet Connect-AzAccount.
  • Se si sceglie di usare Azure Cloud Shell:
    • Vedere Panoramica di Azure Cloud Shell per altre informazioni.

Aggiungere un'API GraphQL

# 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

Testare l'API GraphQL

1. Passare all'istanza di Gestione API.

2. Nel menu di spostamento laterale, nella sezione API selezionare API.

3. In Tutte le API, selezionare l'API GraphQL.

4. Selezionare la scheda Test per accedere alla console di test.

5. In Intestazioni:

   1. Selezionare l'intestazione dal menu a discesa Nome.
   2. Immettere il valore nel campo Valore.
   3. Aggiungere altre intestazioni selezionando + Aggiungi intestazione.
   4. Eliminare le intestazioni usando l'icona cestino.

6. Se è stato aggiunto un prodotto all'API GraphQL, applicare l'ambito del prodotto in Applica ambito prodotto.

7. Nell'editor query, eseguire una delle seguenti operazioni:

   1. Selezionare almeno un campo o un sottocampo dall'elenco nel menu laterale. I campi e i sottocampi selezionati vengono visualizzati nell'editor query.

   2. Iniziare a digitare nell'editor query per comporre una query.

      

8. In Variabili di query, aggiungere variabili per riutilizzare la stessa query o la stessa mutazione e passare valori diversi.

9. Selezionare Invia.

10. Visualizzare la risposta.

    

11. Ripetere i passaggi precedenti per testare altri payload.

12. Al termine del test, uscire dalla console di test.

Testare una sottoscrizione

Se l'API GraphQL supporta una sottoscrizione, è possibile testarla nella console di test.

1. Assicurarsi che l'API consenta uno schema URL WebSocket (WS o WSS) adatto per l'API. È possibile abilitare questa impostazione nella scheda Impostazioni.

2. Configurare una query di sottoscrizione nell'editor di query, quindi selezionare Connetti per stabilire una connessione WebSocket con il servizio back-end.

   

3. Revisionare i dettagli della connessione nel riquadro Sottoscrizione.

   

4. Gli eventi sottoscritti appaiono nel riquadro Sottoscrizione. La connessione WebSocket viene mantenuta fino alla disconnessione o alla connessione a una nuova sottoscrizione WebSocket.

   

Proteggere l'API GraphQL

Proteggere l’API GraphQL applicando sia i criteri di autenticazione e autorizzazione sia un criterio di convalida di GraphQL per la protezione da attacchi specifici per GraphQL.

Argomenti correlati

• Limitazioni relative all'importazione di API
• Importare una specifica OpenAPI
• Importare un'API SOAP
• Importare un'API SOAP e convertirla in REST
• Importare un'API del servizio app
• Importare un'API dell'app contenitore
• Importare un'API WebSocket
• Importare un'API GraphQL
• Importare uno schema di GraphQL e configurare resolver di campo
• Importare un'app per le funzioni di Azure
• Importare un'app per la logica di Azure
• Importare un servizio Service Fabric
• Importare un'API di OpenAI di Azure
• Importare un'API OData
• Importare metadati OData SAP
• Importare un'API gRPC
• Modificare un'API

Passaggi successivi