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

Ez a rövid útmutató bemutatja, hogyan futtathat Azure Resource Graph-lekérdezést az Azure CLI bővítményével. A cikk azt is bemutatja, hogyan rendezheti (rendezheti) és korlátozhatja a lekérdezés eredményeit. A bérlői, felügyeleti csoportokban vagy előfizetésekben lévő erőforrásokra vonatkozó lekérdezést futtathat. Ha végzett, eltávolíthatja a bővítményt.

Előfeltételek

• Ha még nem rendelkezik Azure-fiókkal, első lépésként hozzon létre egy ingyenes fiókot.
• Az Azure CLI-nek a Resource Graph-bővítmény 2.22.0-s vagy újabb verziójának kell lennie.
• Visual Studio Code.

Csatlakozás az Azure szolgáltatáshoz

Egy Visual Studio Code-terminál munkamenetből csatlakozzon az Azure-hoz. Ha több előfizetéssel rendelkezik, futtassa a parancsokat az előfizetés környezetének beállításához. Cserélje le a <subscriptionID> értékét a saját Azure-előfizetése azonosítójára.

az login

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

A bővítmény telepítése

Ahhoz, hogy az Azure CLI lekérdezhesse az erőforrásokat az Azure Resource Graph használatával, telepíteni kell a Resource Graph-bővítményt. A bővítményt manuálisan is telepítheti az alábbi lépésekkel. Ellenkező esetben a rendszer a lekérdezés az graph első futtatásakor a bővítmény telepítését kéri.

1. Az elérhető bővítmények és verziók listázása:

   az extension list-available --output table
   

2. A bővítmény telepítése:

   az extension add --name resource-graph
   

3. Ellenőrizze, hogy a bővítmény telepítve van-e:

   az extension list --output table
   

4. A bővítmény szintaxisának megjelenítése:

   az graph query --help
   

   Az Azure CLI-bővítményekkel kapcsolatos további információkért tekintse meg a bővítmények használatát és kezelését az Azure CLI-vel.

Lekérdezés futtatása

Miután hozzáadta az Azure CLI-bővítményt a környezethez, futtathat egy bérlőalapú lekérdezést. A példában szereplő lekérdezés öt Azure-erőforrást ad vissza az name egyes erőforrásokkal együtt type . A felügyeleti csoport vagy előfizetés szerinti lekérdezéshez használja az argumentumokat vagy --subscriptions az --management-groups argumentumokat.

1. Azure Resource Graph-lekérdezés futtatása:

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

   Ez a lekérdezési példa nem használ olyan rendezési módosítót, mint a order by. Ha többször futtatja a lekérdezést, az az egyes kérésekhez eltérő erőforráskészletet eredményezhet.

2. Frissítse a lekérdezést a name tulajdonságraorder by:

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

   Az előző lekérdezéshez hasonlóan, ha többször futtatja ezt a lekérdezést, az minden egyes kéréshez eltérő erőforráskészletet eredményezhet. Fontos a lekérdezési parancsok sorrendje. Ebben a példában az order by a limit után következik. A lekérdezés öt erőforrásra korlátozza az eredményeket, majd név szerint rendeli el az eredményeket.

3. Frissítse a lekérdezést a name tulajdonságraorder by, majd limit a kimenetet öt találatra:

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

   Ha ezt a lekérdezést többször futtatja a környezet módosítása nélkül, az eredmények konzisztensek és a tulajdonság szerint name vannak rendezve, de továbbra is öt találatra korlátozódnak. A lekérdezés név alapján rendeli meg az eredményeket, majd öt erőforrásra korlátozza a kimenetet.

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

A Resource Graph-bővítmény eltávolításához futtassa a következő parancsot:

az extension remove --name resource-graph

Kijelentkezés az Azure CLI-munkamenetből:

az logout

Következő lépések

Ebben a rövid útmutatóban Azure Resource Graph-lekérdezéseket futtatott az Azure CLI bővítményével. További információkért tekintse meg a lekérdezés nyelvének részleteit ismertető cikket.

Az Azure Resource Graph lekérdezési nyelvének ismertetése