Rövid útmutató: Az első Resource Graph lekérdezés futtatása az Azure CLI használatával

Az Azure Resource Graph használatához először is meg kell győződnie arról, hogy az Azure CLI-hez szükséges bővítmény telepítve van. E rövid útmutató segítségével hozzáadhatja a bővítményt a telepített Azure CLI-hez. A bővítményt helyileg telepített Azure CLI-vel vagy az Azure Cloud Shellen keresztül is használhatja.

A folyamat végére a bővítmény hozzá lesz adva a kiválasztott Azure CLI-telepítéshez, és máris futtathatja az első Resource Graph-lekérdezését.

Előfeltételek

Ha nem rendelkezik Azure-előfizetéssel, első lépésként mindössze néhány perc alatt létrehozhat egy ingyenes fiókot.

A Resource Graph bővítmény hozzáadása

Ahhoz, hogy az Azure CLI lekérdezhesse az Azure Resource Graph-ot, el kell végezni a bővítmény hozzáadását. Ez a bővítmény mindenhol működik, ahol az Azure CLI használható, beleértve a Basht Windows 10-en, a Cloud Shellt (különállón és portálon belülin egyaránt), az Azure CLI Docker-rendszerképet, vagy akár helyileg telepítve is.

  1. Ellenőrizze, hogy telepítve van-e a legújabb Azure CLI (legalább 2.0.76). Ha még nincs telepítve, kövesse ezeket az utasításokat.

  2. A választott Azure CLI környezetben importálja a bővítményt a következő paranccsal:

    # Add the Resource Graph extension to the Azure CLI environment
    az extension add --name resource-graph
    
  3. Győződjön meg arról, hogy a bővítmény telepítve van, és a várt verzió (legalább 1.0.0):

    # Check the extension list (note that you may have other extensions installed)
    az extension list
    
    # Run help for graph query options
    az graph query -h
    

Az első Resource Graph-lekérdezés futtatása

Ha hozzáadja az Azure CLI-bővítményt a választott környezethez, ideje kipróbálni egy egyszerű bérlőalapú Resource Graph lekérdezést. A lekérdezés az első öt Azure-erőforrást adja vissza az egyes erőforrások nevével és erőforrástípusával . A felügyeleti csoport vagy előfizetés szerinti lekérdezéshez használja a vagy --subscriptions az --managementgroups argumentumokat.

  1. Futtassa az első Azure Resource Graph-lekérdezését a graph bővítmény és a query parancs használatával:

    # Login first with az login if not using Cloud Shell
    
    # Run Azure Resource Graph query
    az graph query -q 'Resources | project name, type | limit 5'
    

    Megjegyzés

    Ez a lekérdezési példa nem biztosít olyan rendezési módosítót, mint az order by, tehát ha többször is futtatja, valószínűleg minden kéréssel eltérő erőforráslistát fog kapni.

  2. Frissítse a lekérdezést úgy, hogy a rendezési szempont (order by) a Name tulajdonság legyen:

    # Run Azure Resource Graph query with 'order by'
    az graph query -q 'Resources | project name, type | limit 5 | order by name asc'
    

    Megjegyzés

    Csakúgy, mint az első lekérdezésnél, e lekérdezés többszöri futtatása esetén is valószínűleg minden kéréssel eltérő erőforráslistát fog kapni. Fontos a lekérdezési parancsok sorrendje. Ebben a példában az order by a limit után következik. Ez a parancsrend először korlátozza a lekérdezés eredményeit, majd megrendeli őket.

  3. Először frissítse a lekérdezést, hogy a Name tulajdonság szerint legyen rendezve (order by), majd korlátozza (limit) az első öt találatra:

    # Run Azure Resource Graph query with `order by` first, then with `limit`
    az graph query -q 'Resources | project name, type | order by name asc | limit 5'
    

Ha a végső lekérdezés többször is lefut, feltételezve, hogy a környezetben semmi sem változik, a visszaadott eredmények konzisztensek és a Name tulajdonság szerint vannak rendezve, de továbbra is az első öt találatra korlátozódnak.

Az erőforrások eltávolítása

Ha el szeretné távolítani a Resource Graph bővítményt az Azure CLI környezetből, ezt a következő paranccsal teheti meg:

# Remove the Resource Graph extension from the Azure CLI environment
az extension remove -n resource-graph

Következő lépések

Ebben a rövid útmutatóban hozzáadta a Resource Graph bővítményt az Azure CLI-környezethez, és futtatta az első lekérdezést. Ha többet szeretne megtudni a Resource Graph nyelvről, lépjen tovább a lekérdezés nyelvének részletei oldalra.