Importera ett GraphQL-API

1. I Azure-portalen går du till din API Management-instans.

2. I den vänstra menyn väljer du API:er>+ Lägg till API.

3. Under Definiera ett nytt API väljer du GraphQL-ikonen .

   

4. I dialogrutan väljer du Fullständig och slutför de obligatoriska formulärfälten.

   

   Fält	Description
   Visningsnamn	Namnet som GraphQL-API:et ska visas med.
   Namn	Raw-namnet på GraphQL-API:et. Fylls i automatiskt när du skriver visningsnamnet.
   GraphQL-typ	Välj DirektgrafQL för att importera från en befintlig GraphQL API-slutpunkt.
   GraphQL API-slutpunkt	Bas-URL:en med ditt GraphQL API-slutpunktsnamn. Exempel: https://example.com/your-GraphQL-name. Du kan också använda en vanlig "swapi" GraphQL-slutpunkt, till exempel https://swapi-graphql.azure-api.net/graphql en demo.
   Ladda upp schema	Du kan också välja att bläddra och ladda upp schemafilen för att ersätta schemat som hämtats från GraphQL-slutpunkten (om det är tillgängligt).
   Beskrivning	Lägg till en beskrivning av ditt API.
   URL-schema	Gör ett val baserat på GraphQL-slutpunkten. Välj ett av alternativen som innehåller ett WebSocket-schema (WS eller WSS) om GraphQL-API:et innehåller prenumerationstypen. Standardval: HTTP(S).
   API URL-suffix	Lägg till ett URL-suffix för att identifiera det här specifika API:et i den här API Management-instansen. Den måste vara unik i den här API Management-instansen.
   Grundläggande URL	Namnlös fält som visar din API-bas-URL
   Taggar	Associera GraphQL-API:et med nya eller befintliga taggar.
   Produkter	Associera GraphQL-API:et med en produkt för att publicera det.
   Version av det här API:et?	Välj om du vill tillämpa ett versionsschema på GraphQL-API:et.

5. Välj Skapa.

6. När API:et har skapats bläddrar eller ändrar du schemat på fliken Design .

I följande exempel används kommandot az apim api import för att importera ett GraphQL-API för genomströmning från den angivna URL:en till en API Management-instans med namnet apim-hello-world.

# 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

När du har importerat API:et kan du vid behov uppdatera inställningarna med hjälp av kommandot az apim api update .

I följande exempel används Cmdleten Import-AzApiManagementApi Azure PowerShell för att importera ett GraphQL-api för genomströmning från den angivna URL:en till en API Management-instans med namnet apim-hello-world.

# 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

När du har importerat API:et kan du vid behov uppdatera inställningarna med hjälp av cmdleten Set-AzApiManagementApi .