Dela via


Snabbstart: Köra Resource Graph-fråga med Hjälp av Azure CLI

Den här snabbstarten beskriver hur du kör en Azure Resource Graph-fråga med hjälp av Azure CLI och Resource Graph-tillägget. Artikeln visar också hur du beställer (sorterar) och begränsar frågans resultat. Du kan köra en fråga för resurser i din klientorganisation, hanteringsgrupper eller prenumerationer. När du är klar kan du ta bort tillägget.

Förutsättningar

Installera tillägget

För att Azure CLI ska kunna köra frågor mot resurser med Hjälp av Azure Resource Graph måste Resource Graph-tillägget installeras. Första gången du kör en fråga med az graph en fråga visas för att installera tillägget. Annars använder du följande steg för att göra en manuell installation.

  1. Visa en lista över tillgängliga tillägg och versioner:

    az extension list-available --output table
    
  2. Installera tillägget:

    az extension add --name resource-graph
    
  3. Kontrollera att tillägget har installerats:

    az extension list --output table
    
  4. Visa tilläggets syntax:

    az graph query --help
    

    Mer information om Azure CLI-tillägg finns i Använda och hantera tillägg med Azure CLI.

Ansluta till Azure

Anslut till Azure från en terminalsession i Visual Studio Code. Om du har fler än en prenumeration kör du kommandona för att ange kontext till din prenumeration. Ersätt <subscriptionID> med ditt Azure-prenumerations-ID.

az login

# Run these commands if you have multiple subscriptions
az account list --output table
az account set --subscription <subscriptionID>

Köra en fråga

När Azure CLI-tillägget har lagts till i din miljö kan du köra en klientbaserad fråga. Frågan i det här exemplet returnerar fem Azure-resurser med name och type för varje resurs. Om du vill fråga efter hanteringsgrupp eller prenumeration använder du argumenten --management-groups eller --subscriptions .

  1. Kör en Azure Resource Graph-fråga:

    az graph query --graph-query 'Resources | project name, type | limit 5'
    

    Det här frågeexemplet använder inte en sorteringsmodifierare som order by. Om du kör frågan flera gånger kan det ge en annan uppsättning resurser för varje begäran.

  2. Uppdatera frågan till order by egenskapen name :

    az graph query --graph-query 'Resources | project name, type | limit 5 | order by name asc'
    

    Om du kör den här frågan flera gånger kan den, precis som i föregående fråga, ge en annan uppsättning resurser för varje begäran. Ordningen på frågekommandona är viktig. I det här exemplet kommer order by efter limit. Frågan begränsar resultatet till fem resurser och beställer sedan resultaten efter namn.

  3. Uppdatera frågan till order by name egenskapen och sedan limit utdata till fem resultat:

    az graph query --graph-query 'Resources | project name, type | order by name asc | limit 5'
    

    Om den här frågan körs flera gånger utan ändringar i din miljö är resultaten konsekventa och ordnade efter name egenskapen, men är fortfarande begränsade till fem resultat. Frågan beställer resultatet efter namn och begränsar sedan utdata till fem resurser.

Rensa resurser

Om du vill ta bort Resource Graph-tillägget kör du följande kommando:

az extension remove --name resource-graph

Logga ut från Azure CLI-sessionen:

az logout

Nästa steg

I den här snabbstarten körde du Azure Resource Graph-frågor med hjälp av tillägget för Azure CLI. Om du vill veta mer om resource graph-språket fortsätter du till informationssidan för frågespråket.