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éseket az Azure CLI és a Resource Graph bővítmény használatával. 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.
- Egy Bash-rendszerhéj-környezet, ahol Azure CLI-parancsokat futtathat. Például a Git Bash egy Visual Studio Code-terminál munkamenetben.
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. Amikor első alkalommal futtat egy lekérdezést egy kéréssel az graph
, megjelenik a bővítmény telepítéséhez. Ellenkező esetben a következő lépésekkel végezhet manuális telepítést.
Az elérhető bővítmények és verziók listázása:
az extension list-available --output table
A bővítmény telepítése:
az extension add --name resource-graph
Ellenőrizze, hogy a bővítmény telepítve van-e:
az extension list --output table
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.
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>
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.
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.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
alimit
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.Frissítse a lekérdezést a
name
tulajdonságraorder by
, majdlimit
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. A Resource Graph nyelvével kapcsolatos további információkért lépjen a lekérdezés nyelvének részleteit tartalmazó oldalra.