Import rozhraní GraphQL API

PLATÍ PRO: Všechny úrovně služby API Management

Ve službě API Management můžete přidat rozhraní GraphQL API v jednom ze dvou modelů: předávat do existujícího koncového bodu GraphQL nebo importovat schéma GraphQL a vytvořit syntetické rozhraní GraphQL API s vlastními překladači polí. Další informace najdete v přehledu GraphQL.

V tomto článku:

Pokud chcete importovat schéma GraphQL a nastavit překladače polí pomocí koncových bodů rozhraní REST nebo SOAP API, přečtěte si téma Import schématu GraphQL a nastavení překladačů polí.

Požadavky

• Existující instance služby API Management. Vytvořte ho, pokud jste to ještě neudělali.

• Rozhraní GraphQL API.

• Azure CLI

  • Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.

    

  • Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.

    • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.

    • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.

    • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

• Azure PowerShell

  • Pokud se rozhodnete používat Azure PowerShell místně:
    • Nainstalujte nejnovější verzi modulu Az PowerShell.
    • Připojte se ke svému účtu Azure pomocí rutiny Connect-AzAccount .
  • Pokud se rozhodnete použít Azure Cloud Shell:
    • Další informace najdete v přehledu služby Azure Cloud Shell .

Přidání rozhraní 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

Testování rozhraní GraphQL API

1. Přejděte do vaší instance služby API Management.

2. V boční navigační nabídce v části Rozhraní API vyberte rozhraní API.

3. V části Všechna rozhraní API vyberte rozhraní GraphQL API.

4. Vyberte kartu Test pro přístup k testovací konzole.

5. V části Hlavičky:

   1. V rozevírací nabídce Název vyberte záhlaví.
   2. Zadejte hodnotu do pole Hodnota .
   3. Další záhlaví přidáte tak , že vyberete + Přidat záhlaví.
   4. Odstraňte záhlaví pomocí ikony koše.

6. Pokud jste do rozhraní GraphQL API přidali produkt, použijte obor produktu v části Použít rozsah produktu.

7. V editoru dotazů:

   1. V boční nabídce vyberte alespoň jedno pole nebo dílčí pole ze seznamu. Pole a dílčí pole, která vyberete, se zobrazí v editoru dotazů.

   2. Začněte psát v editoru dotazů a vytvořte dotaz.

      

8. V části Proměnné dotazu přidejte proměnné pro opakované použití stejného dotazu nebo mutaci a předání různých hodnot.

9. Vyberte Odeslat.

10. Zobrazte odpověď.

    

11. Opakováním předchozích kroků otestujte různé datové části.

12. Po dokončení testování ukončete testovací konzolu.

Testování předplatného

Pokud vaše rozhraní GraphQL API podporuje předplatné, můžete ho otestovat v testovací konzole.

1. Ujistěte se, že vaše rozhraní API umožňuje schéma adres URL protokolu WebSocket (WS nebo WSS), které je vhodné pro vaše rozhraní API. Toto nastavení můžete povolit na kartě Nastavení .

2. Nastavte dotaz předplatného v editoru dotazů a pak výběrem možnosti Připojit vytvořte připojení WebSocket k back-endové službě.

   

3. Zkontrolujte podrobnosti o připojení v podokně Předplatné .

   

4. Odebírané události se zobrazí v podokně Odběr . Připojení WebSocket se udržuje, dokud se neodpojíte nebo se připojíte k novému předplatnému WebSocket.

   

Zabezpečení rozhraní GraphQL API

Zabezpečení rozhraní GraphQL API pomocí stávajících zásad ověřování a autorizace a zásad ověřování GraphQL pro ochranu před útoky specifickými pro GraphQL.

Příbuzná témata

• Omezení importu rozhraní API
• Import specifikace OpenAPI
• Import rozhraní API protokolu SOAP
• Import rozhraní API protokolu SOAP a převod na REST
• Import rozhraní API služby App Service
• Import rozhraní API kontejnerové aplikace
• Import rozhraní WEBSocket API
• Import rozhraní GraphQL API
• Import schématu GraphQL a nastavení překladačů polí
• Import aplikace Azure Function App
• Import aplikace logiky Azure
• Import služby Service Fabric
• Import rozhraní API Azure OpenAI
• Import rozhraní OData API
• Import metadat SAP OData
• Import rozhraní API gRPC
• Úprava rozhraní API

Další kroky